Content Attestation of Online Ad Type

用語

本文書に説明のない用語については、用語を参照してください。

• Content Attestation (CA)

Online Ad のデータモデル

プロパティ

Online Ad のプロパティ一覧

Name	Type	Description
@context	string[]	REQUIRED. OP VC Data Model に従ってください (MUST)。さらに、3つ目の値を "https://originator-profile.org/ns/cip/v1" にしなければなりません (MUST)。
type	string[]	REQUIRED. 必ず ["VerifiableCredential", "ContentAttestation"] にしてください (MUST)。
issuer	string	REQUIRED. CA 発行者の OP ID でなければなりません (MUST)。
credentialSubject	object	REQUIRED. 次の credentialSubject のプロパティを含む JSON-LD Node Object です。
allowedUrl	string | string[]	REQUIRED. Content Attestation に定義済みのプロパティです。空配列にしてはなりません (MUST NOT)。
target	object[]	REQUIRED. Content Attestation に定義済みのプロパティです。空配列にしてはなりません (MUST NOT)。

credentialSubject のプロパティ一覧

注意

name 、 description 、 image プロパティはそれぞれ OPTIONAL ですが、3つのうち少なくとも1つを含まなければなりません (MUST)。

Name	Type	Description
id	string	REQUIRED. CA ID でなければなりません (MUST)。 CA ID は UUIDv4 の URN 形式の文字列です。コンテンツと CA ID は一対一対応します。
type	string	REQUIRED. OnlineAd でなければなりません (MUST)。
name	string	OPTIONAL. 広告のタイトルです。
description	string	OPTIONAL. 広告の説明です。
image	object	OPTIONAL. 広告のサムネイル画像です。サムネイル画像があるならば指定するべきです (RECOMMENDED)。 image データ型 の JSON-LD Node Object でなければなりません (MUST)。このプロパティで CA を検証することができます。
genre	string	OPTIONAL. ジャンルです。
landingPageUrl	string	OPTIONAL. 広告をクリックした際、最終的に表示されるページ（ランディングページ）の URL です。
adReportContact	object	OPTIONAL. 広告に対する報告窓口です。 page データ型 の JSON-LD Node Object でなければなりません (MUST)。
adReviewGuidelines	object	OPTIONAL. 広告審査ガイドラインの情報です。 page データ型 の JSON-LD Node Object でなければなりません (MUST)。
targetingPolicy	object	OPTIONAL. ターゲティング広告に関するポリシーです。 page データ型 の JSON-LD Node Object でなければなりません (MUST)。
adDataHandlingPolicy	object	OPTIONAL. 広告配信に関する情報の取り扱いに関しての情報です。 page データ型 の JSON-LD Node Object でなければなりません (MUST)。
adDisplayRationale	object	OPTIONAL. 次の adDisplayRationale のプロパティを含む JSON-LD Node Object です。

adDisplayRationale のプロパティ一覧

Name	Type	Description
page	object	OPTIONAL. この広告が表示されている理由 (Web ページ)です。page データ型 の JSON-LD Node Object でなければなりません (MUST)。
description	string	OPTIONAL. この広告が表示されている理由です。

注記

credentialSubject 内のプロパティは https://schema.org/CreativeWork を参考に決定しました。個々のプロパティの解釈、要不要について schema.org にどこまで準拠するかは OP を利用する企業との意見交換を踏まえて決めていく予定です。

注記

画像・バナー広告以外の広告に関するプロパティの定義については、今後の課題として検討中です。

Appendix

例

このセクションは非規範的です。

Advertisement の具体例を次に示します。

{
  "@context": [
    "https://www.w3.org/ns/credentials/v2",
    "https://originator-profile.org/ns/credentials/v1",
    "https://originator-profile.org/ns/cip/v1",
    { "@language": "ja" }
  ],
  "type": ["VerifiableCredential", "ContentAttestation"],
  "issuer": "dns:example.com",
  "credentialSubject": {
    "id": "urn:uuid:78550fa7-f846-4e0f-ad5c-8d34461cb95b",
    "type": "OnlineAd",
    "name": "<広告のタイトル>",
    "description": "<広告の説明>",
    "image": {
      "id": "https://ad.example.com/image.png",
      "digestSRI": "sha256-5uQVtkoRdTFbimAz3Wz5GQcuBRLt7tDMD5JRtGFo9/M="
    },
    "landingPageUrl": "https://advertiser.example.com",
    "adReportContact": {
      "id": "https://ad.example.com/contact",
      "name": "広告に対する報告窓口"
    },
    "adReviewGuidelines": {
      "id": "https://ad.example.com/guidelines",
      "name": "広告審査ガイドライン"
    },
    "targetingPolicy": {
      "id": "https://ad.example.com/targeting",
      "name": "ターゲティング広告に関するポリシー"
    },
    "adDataHandlingPolicy": {
      "id": "https://ad.example.com/datahandling",
      "name": "広告配信に関する情報の取り扱いについての説明"
    },
    "adDisplayRationale": {
      "page": {
        "id": "https://ad.example.com/rationale",
        "name": "この広告が表示されている理由"
      },
      "description": "現在閲覧中のコンテンツと関連性が高いため。"
    }
  },
  "allowedUrl": ["https://ad.example.com/*"],
  "target": [
    {
      "type": "ExternalResourceTargetIntegrity",
      "integrity": "sha256-rLDPDYArkNcCvnq0h4IgR7MVfJIOCCrx4z+w+uywc64="
    }
  ]
}