同意および環境設定 データタイプ

この プライバシー、パーソナライゼーションおよびマーケティング環境設定に関する同意 データタイプ（以下「」）同意および環境設定 データタイプ"）は Experience Data Model （XDM）データ型：データ操作から同意管理プラットフォーム（CMP）やその他のソースによって生成された顧客の権限や環境設定の収集をサポートすることを目的としたデータ型。

このドキュメントでは、が提供するフィールドの構造と使用目的について説明します 同意および環境設定 データタイプ。

前提条件 prerequisites

このドキュメントでは、XDM と内のスキーマの使用について実際に理解している必要があります Experience Platform. 続行する前に、次のドキュメントを確認してください。

データタイプ構造 structure

この 同意および環境設定 データタイプには、キャプチャに使用する複数のフィールドが用意されています 同意 および 環境設定 情報。

同意とは、顧客がデータの使用方法を指定できるオプションです。 同意の多くには法的側面があり、一部の管轄区域では、特定の方法でデータを使用する前に許可を得る必要があります。または、肯定的な同意が必要ない場合は、顧客がその使用（オプトアウト）を停止するオプションを用意する必要があります。

環境設定とは、ブランドでのエクスペリエンスの様々な側面をどのように処理するべきかを顧客が指定できるオプションです。 これらは次の 2 つのカテゴリに分類されます。

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

次の JSON は、 同意および環境設定 データタイプはを処理できます。 これらの各フィールドの具体的な使用方法については、以降の節で説明します。

{
  "consents": {
    "collect": {
      "val": "VI",
    },
    "adID": {
      "idType": "IDFA",
      "val": "y"
    },
    "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"
    }
  }
}

consents choices

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

"consents": {
  "collect": {
    "val": "VI",
  },
  "adID": {
    "idType": "IDFA",
    "val": "y"
  },
  "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"
}

adID

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

"adID": {
  "idType": "IDFA",
  "val": "y"
}

share

share 顧客のデータをセカンドパーティまたはサードパーティと共有（またはセカンドパーティに販売）できるかどうかに対する顧客の同意を表します。

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

personalize personalize

personalize データをパーソナライゼーションに使用する方法に関するお客様の環境設定をキャプチャします。 顧客は、特定のパーソナライゼーションのユースケースをオプトアウトすることも、パーソナライゼーションを完全にオプトアウトすることもできます。

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

marketing marketing

marketing データを使用できるマーケティング目的に関するお客様の環境設定をキャプチャします。 顧客は、特定のマーケティングのユースケースをオプトアウトすることも、ダイレクトマーケティングを完全にオプトアウトすることもできます。

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

metadata

metadata 顧客の同意および環境設定に関する一般的なメタデータを、最終更新時に常にキャプチャします。

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

データタイプを使用したデータの取り込み ingest

を使用するには 同意および環境設定 データタイプ顧客から同意データを取り込むには、そのデータタイプを含むスキーマに基づいてデータセットを作成する必要があります。

チュートリアルを参照してください。 ui でのスキーマの作成 フィールドにデータタイプを割り当てる手順については、を参照してください。 を使用したフィールドを含むスキーマを作成したら、 同意および環境設定 データタイプについては、の節を参照してください データセットの作成 データセットユーザーガイドでは、既存のスキーマを使用してデータセットを作成する手順に従います。

同意および環境設定の変更の処理

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

付録 appendix

以下のセクションでは、に関する追加情報を提供します 同意および環境設定 データタイプ。

val の許容値 choice-values

次の表に、の許容値を示します val:

preferred の許容値 preferred-values

次の表に、の許容値を示します preferred. この preferred 値は、データ収集、プライバシーポリシー、パーソナライゼーションオプションに関する情報を顧客に提供する、顧客の通信の優先チャネルを示します。

フル 同意および環境設定 スキーマ full-schema

の完全なスキーマを表示するには 同意および環境設定 データタイプ。を参照してください。 公式 XDM リポジトリ.