同意と環境設定 データ型

プライバシー、パーソナライゼーション、マーケティングの環境設定に対する同意データ型（以下「同意と環境設定データ型」と呼びます）は、同意管理プラットフォーム(CMP)やその他のソースから顧客の権限や設定を収集するためのExperience Data Model (XDM)データ型ですデータ操作を実行する場合。

このドキュメントでは、同意と環境設定データ型で提供されるフィールドの構造と使用方法について説明します。

前提条件

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

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

データタイプの構造

同意と環境設定データ型は、同意​および​環境設定​の情報を取り込むためのフィールドを提供します。

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

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

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

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

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

{
  "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"
    }
  }
}

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"
}

adID

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

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

share

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

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

personalize

personalize では、顧客のデータをパーソナライゼーションに使用する方法に関する顧客の環境設定を取り込みます。お客様は、特定のパーソナライゼーションの使用例をオプトアウトしたり、完全にパーソナライゼーションをオプトアウトしたりできます。

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

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",
}

データ型を使用したデータの取得

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

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

同意と環境設定の変更の処理

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

付録

以下の節では、同意と環境設定データ型に関する追加の参照情報を示します。

valに指定できる値

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

preferredに指定できる値

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

同意と環境設定スキーマ全体

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