Consents & Preferences データ型

プライバシー、パーソナライゼーション、マーケティングの環境設定に対する同意データ型（以下「Consents & Preferencesデータ型」と呼びます）は、Experience Data Model (XDM)データ型で、データ操作からConsent Management Platforms(CMP)や他のソースによって生成される顧客の権限や環境設定をサポートします。

このドキュメントでは、Consents & Preferencesデータ型が提供するフィールドの構造と使用目的について説明します。

前提条件

このドキュメントでは、XDMとExperience Platformでのスキーマの使用に関する十分な理解が必要です。 先に進む前に、次のドキュメントを確認してください。

• XDM システムの概要
• スキーマ構成の基本

データタイプ構造

Consents & Preferencesデータ型は、同意​と​環境設定​の情報を取り込むために使用するいくつかのフィールドを提供します。

同意とは、顧客が自分のデータの使用方法を指定できるオプションです。 ほとんどの同意は法的側面を持ちます。管轄区域によっては、特定の方法でデータを使用する前に許可を取得する必要がある場合や、肯定的な同意が必要でない場合は、その使用を停止するオプション(オプトアウト)を持つ必要がある場合があります。

プリファレンスとは、ブランドに関するエクスペリエンスの様々な側面を顧客がどのように扱うべきかを指定できるオプションです。 これらは2つのカテゴリ内にあります。

• 個人設定の環境設定:ブランドが顧客に提供するエクスペリエンスをパーソナライズする方法に関する環境設定。
• マーケティングの環境設定:様々なチャネルを通じてブランドが顧客との接触を許可されるかどうかに関するプレファレンス。

次のスクリーンショットは、データタイプの構造がプラットフォームUIでどのように表されるかを示しています。

次のJSONは、Consents & Preferencesデータ型で処理できるデータのタイプの例を示しています。 各フィールドの具体的な使用方法については、以降の節で説明します。

{
  "consents": {
    "collect": {
      "val": "y",
    },
    "adID": {
      "val": "VI"
    },
    "share": {
      "val": "y",
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "u"
      },
      "push": {
        "val": "n",
        "reason": "Too Frequent",
        "time": "2019-01-01T15:52:25+00:00"
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    },
    "idSpecific": {
      "email": {
        "jdoe@example.com": {
          "marketing": {
            "email": {
              "val": "n"
            }
          }
        }
      }
    }
  }
}

consents

consents には、顧客の同意と環境設定を説明する複数のフィールドが含まれています。これらのフィールドについて詳しくは、以下のサブセクションを参照してください。

"consents": {
  "collect": {
    "val": "y",
  },
  "adID": {
    "val": "VI"
  },
  "share": {
    "val": "y",
  },
  "personalize": {
    "content": {
      "val": "y"
    }
  },
  "marketing": {
    "preferred": "email",
    "any": {
      "val": "u"
    },
    "email": {
      "val": "n",
      "reason": "Too Frequent",
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

collect

collect は、顧客がデータを収集することに同意したことを表します。

"collect" : {
  "val": "y"
}

プロパティ	説明
val	この使用事例に対するお客様提供の同意の選択。 使用できる値と定義については、付録を参照してください。

adID

adID は、広告主ID（IDFAまたはGAID）を使用して、このデバイス上のアプリ間で顧客をリンクできるかどうかに関する顧客の同意を表します。

"adID" : {
  "val": "y"
}

プロパティ	説明
val	この使用事例に対するお客様提供の同意の選択。 使用できる値と定義については、付録を参照してください。

share

share は、自社のデータを第2のパーティと共有（または第3のパーティと共有）できるか（または販売できるか）に関する顧客の同意を表します。

"share" : {
  "val": "y"
}

プロパティ	説明
val	この使用事例に対するお客様提供の同意の選択。 使用できる値と定義については、付録を参照してください。

personalize

personalize データをどのようにパーソナライズに使用できるかに関する顧客の環境設定を取得します。お客様は、特定オプトアウトのパーソナライゼーションの使用例を使用することも、パーソナライゼーションを完全オプトアウトに使用することもできます。

"personalize": {
  "content": {
    "val": "y",
  }
}

プロパティ	説明
content	Webサイトやアプリケーション上でパーソナライズされたコンテンツを提供する、ユーザーの環境設定を表します。
val	指定した使用例に対する顧客が提供するパーソナライゼーション設定です。 顧客が同意を求められない場合は、このフィールドの値は、パーソナライゼーションを実行する基準を示す必要があります。 使用できる値と定義については、付録を参照してください。

marketing

marketing データを使用できるマーケティング目的に関する顧客の判断基準を取り込みます。特定オプトアウトのマーケティングの使用例や、完全なダイレクトマーケティングオプトアウトのお客様が考えられます。

"marketing": {
  "preferred": "email",
  "any": {
    "val": "u"
  },
  "email": {
    "val": "n",
    "reason": "Too Frequent"
  },
  "push": {
    "val": "y"
  },
  "sms": {
    "val": "y"
  }
}

プロパティ	説明
preferred	顧客が好む通信チャネルを示します。 使用できる値については、付録を参照してください。
any	ダイレクトマーケティング全体に対する顧客の好みを表します。 marketingで提供される追加のサブフィールドによって上書きされない限り、このフィールドに指定される同意の優先順位は、すべてのマーケティングチャネルに対する「デフォルト」の優先順位と見なされます。 より詳細な同意オプションを使用する場合は、このフィールドを除外することをお勧めします。 この値をに設定した場合 n、それ以上の個別設定は無視する必要があります。値をyに設定した場合、nに明示的に設定しない限り、詳細なパーソナライゼーションオプションもすべてyとして扱う必要があります。 値が設定されていない場合は、個々のパーソナライゼーションオプションの値を指定どおりに扱う必要があります。
email	顧客が電子メールメッセージの受信に同意するかどうかを示します。
push	ユーザーがプッシュ通知の受信を許可しているかどうかを示します。
sms	ユーザーがテキストメッセージの受信に同意するかどうかを示します。
val	指定した使用例に対する顧客が指定した基本設定です。 顧客が同意を促すように促す必要がない場合は、このフィールドの値はマーケティング使用事例の発生基準を示す必要があります。 使用できる値と定義については、付録を参照してください。
time	マーケティング環境設定が変更された時のISO 8601タイムスタンプ（該当する場合）。 個々の優先順位のタイムスタンプがmetadataの下で提供されるタイムスタンプと同じ場合、その優先順位に対してこのフィールドは設定されません。
reason	顧客がマーケティングの使用事例からオプトアウトした場合、この文字列フィールドは、顧客がオプトアウトした理由を表します。

metadata

metadata 顧客の同意と環境設定が最後に更新されたときに、その同意に関する一般的なメタデータを取り込みます。

"metadata": {
  "time": "2019-01-01T15:52:25+00:00",
}

プロパティ	説明
time	顧客の同意および環境設定が最後に更新された時点のISO 8601タイムスタンプ。 読み込みと複雑さを軽減するために、個々の環境設定にタイムスタンプを適用する代わりに、このフィールドを使用できます。 個々の環境設定でtime値を指定すると、その環境設定のmetadataタイムスタンプよりも優先されます。

idSpecific

idSpecific は、特定の同意または優先度が顧客に広く適用されるわけではなく、単一のデバイスまたはIDに限定される場合に使用できます。例えば、顧客はあるアドレス宛てオプトアウトの電子メールを受信できる一方、別のアドレス宛ての電子メールを受信できる可能性があります。

idSpecificオブジェクトの各キーは、Adobe Experience PlatformIDサービスで認識される特定のID名前空間を表します。 様々なIDを分類する独自のカスタム名前空間を定義できますが、リアルタイム顧客プロファイルのストレージサイズを小さくするために、Identity Serviceが提供する標準名前空間の1つを使用することをお勧めします。 ID名前空間の詳細については、Identity ServiceドキュメントのID名前空間の概要を参照してください。

各名前空間オブジェクトのキーは、ユーザーが環境設定を行った一意のID値を表します。 各ID値には、consentsと同じ形式の完全な同意と環境設定を含めることができます。

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  }
}

データ型を使用したデータの取り込み

Consents & Preferencesデータ型を使用して顧客の同意データを取り込むには、そのデータ型を含むスキーマに基づいてデータセットを作成する必要があります。

フィールドにデータ型を割り当てる手順については、UI](http://www.adobe.com/go/xdm-schema-editor-tutorial-en)でのスキーマの作成に関するチュートリアルを参照してください。 [データタイプがConsents & Preferencesのフィールドを含むスキーマーを作成したら、既存のスキーマーでデータセットを作成する手順に従って、『データセットユーザーガイド』の「データセットの作成」の節を参照してください。

同意と優先順位の変更の処理

お客様がWebサイトでの同意や環境設定を変更した場合は、Adobe Experience PlatformWeb SDKを使用して、変更を収集し直ちに適用する必要があります。 顧客がデータ収集をオプトアウトした場合、すべてのデータ収集は直ちに停止する必要があります。 顧客がパーソナライゼーションをオプトアウトした場合、訪問者が次のページにパーソナライゼーションを表示しないでください。

付録

以下の節では、Consents & Preferencesデータ型に関する追加情報を示します。

valに指定できる値

次の表に、valに使用できる値の概要を示します。

値	タイトル	説明
y	○	顧客が同意または優先を選択しました。 つまり、​​は、対象となる同意または好みで示されるデータの使用に同意します。
n	×	顧客が同意または好みをオプトアウトしました。 つまり、は、対象となる同意や嗜好で示されるデータの使用に​同意しません。
p	検証待ち	システムは、最終同意または優先度の値をまだ受け取っていません。 これは、2段階の検証が必要な同意の一部として最もよく使用されます。 例えば、顧客が電子メールの受信を希望する場合、電子メール内のリンクを選択して正しい電子メールアドレスを入力したことを確認するまで、同意はpに設定され、その時点でyに更新されます。 この同意または優先順位で2つのセットによる検証プロセスを使用しない場合は、代わりに p 選択肢を使用して、顧客がまだ同意プロンプトに応答していないことを示すことができます。例えば、顧客が同意プロンプトに応答する前に、Webサイトの最初のページで値を自動的にpに設定できます。 明示的な同意を必要としない管轄区域では、顧客が明示的にオプトアウトしないことを示す（つまり、同意が前提となる）場合にも使用できます。
u	Unknown	顧客の同意または嗜好情報が不明です。
LI	正当な利益	特定の目的でこのデータを収集して処理する正当なビジネス上の関心事は、個人に与える潜在的な損害を上回ります。
CT	契約	特定の目的に応じたデータの収集は、個人との契約上の義務を満たすために必要です。
CP	法的義務の遵守	特定の目的に対するデータの収集は、ビジネスの法的義務を満たすために必要です。
VI	個人の極めて重要な関心	特定の目的に合わせたデータの収集は、個人の重要な利益を保護するために必要です。
PI	公益	特定の目的に係るデータの収集は、公益上のタスク又は職権の行使上の行為に必要とされる。

preferredに指定できる値

次の表に、preferredに使用できる値の概要を示します。

値	説明
email	電子メールメッセージ。
push	プッシュ通知.
inApp	アプリ内メッセージ.
sms	SMSメッセージ。
phone	電話のインタラクション数。
phyMail	物理的なメール。
inVehicle	車内メッセージ。
inHome	ホームメッセージ。
iot	インターネット(IoT)メッセージ。
social	ソーシャルメディアコンテンツ。
other	標準のカテゴリに適合しないチャネルです。
none	優先するチャネルはありません。
unknown	優先チャネルが不明です。

完全なConsents & Preferencesスキーマ

Consents & Preferencesデータ型の完全なスキーマを表示するには、正式なXDMリポジトリを参照してください。