Consents and Preferences フィールドグループ

Consents and Preferences は、個々の顧客の同意および環境設定情報を取得する XDM Individual Profile クラス ​ の標準フィールドグループです。

フィールドグループ構造 structure

Consents and Preferences フィールドグループは、同意と環境設定の情報を取得するための、単一のオブジェクトタイプのフィールド consents を提供します。 このフィールドは、Consent for Privacy, Personalization and Marketing Preferences データタイプを拡張し ​adID フィールドを削除して、idSpecific マップフィールドを追加します。

次の JSON は、Consents and Preferences フィールドグループが処理できるデータのタイプの例を示しています。 フィールドグループが提供するほとんどのフィールドの使用方法について詳しくは、​ 同意および環境設定データタイプ ​ に関するガイドを参照してください。 以下のサブセクションでは、フィールドグループがデータタイプに追加する一意の属性に焦点を当てています。

{
  "consents": {
    "collect": {
      "val": "VI"
    },
    "share": {
      "val": "y"
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "email": {
        "val": "y"
      }
    },
    "idSpecific": {
      "ECID": {
        "37784337855396895622558625508046772577": {
          "adID": {
            "val": "n",
          },
          "share": {
            "val": "n"
          },
          "marketing": {
            "push": {
              "val": "n",
              "time": "2020-09-30T01:02:33+00:00",
              "reason": "not relevant"
            }
          }
        }
      },
      "email": {
        "john@xyz.com": {
          "marketing": {
            "email": {
              "val": "y"
            }
          }
        }
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

idSpecific

idSpecific は、特定の同意または環境設定が顧客に普遍的に適用されるのではなく、1 つのデバイスまたは ID に制限されている場合に使用できます。 例えば、ある顧客が、あるアドレスへのメールの受信をオプトアウトしながら、別のアドレスへのメールを許可できる可能性があります。

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

各名前空間オブジェクトのキーは、顧客が環境設定を指定した一意の ID 値を表します。 各 ID 値には、consents と同じ方法で書式設定された、同意および環境設定の完全なセットを含めることができます。

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  },
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

marketing セクション idSpecific 提供されるオブジェクト内では、「any」フィールドと「preferred」フィールドはサポートされていません。 これらのフィールドは、ユーザーレベルでのみ設定できます。 また、idSpecific、email および sms の push マーケティング環境設定では、subscriptions のフィールドはサポートされていません。

idSpecific の節でのみ提供できる同意もあります。adID。 このフィールドについては、次のサブセクションで説明します。

adID

adID の同意は、広告主 ID （IDFA または GAID）をこのデバイス上のアプリ間で顧客をリンクするために使用できるかどうかに対する顧客の同意を表します。 この値は、ECID セクションの idSpecific ID 名前空間でのみ設定でき、他の名前空間またはこのフィールドグループのユーザーレベルでは設定できません。

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

フィールドグループを使用したデータの取り込み ingest

Consents and Preferences フィールドグループを使用して顧客から同意データを取り込むには、そのフィールドグループを含むスキーマに基づいてデータセットを作成する必要があります。

フィールドにフィールドグループを割り当てる手順については、UI でのスキーマの作成 ​ に関するチュートリアルを参照してください。 Consents and Preferences フィールドグループを持つフィールドを含むスキーマを作成したら、既存のスキーマを使用してデータセットを作成する手順に従って、データセットユーザーガイドの ​ データセットの作成 ​ の節を参照してください。

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

顧客が web サイトで同意や環境設定を変更した場合は、その変更内容を収集し、使用するデータ収集ライブラリで同意を設定することで、ただちに適用する必要があります。 お客様がデータ収集をオプトアウトした場合、すべてのデータ収集は直ちに停止する必要があります。 顧客がパーソナライゼーションをオプトアウトする場合、読み込む次のページにはパーソナライゼーションが存在しないはずです。 JavaScript ライブラリを使用する setConsent または web SDK タグ拡張機能を使用する Set consent のアクションを参照してください。

次の手順

このドキュメントでは、Consents and Preferences フィールドグループの構造と使用について説明しました。 フィールドグループで提供される他のフィールドについて詳しくは、Consent for Privacy, Personalization and Marketing Preferences データタイプのドキュメントを参照してください ​