同意と環境設定 フィールドグループ

同意と環境設定は、XDM Individual Profile クラス ​の標準フィールドグループで、個々の顧客の同意と環境設定の情報を取得します。

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

同意と環境設定 フィールドグループは、同意と環境設定の情報を取得するための単一のオブジェクトタイプフィールド consentsを提供します。 このフィールドは、プライバシー、Personalizationおよびマーケティング環境向け同意 データ型を拡張し、adID フィールドを削除してidSpecific マップフィールドを追加します。

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

{
  "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は、特定の同意または環境設定が顧客に適用されないが、単一のデバイスまたはIDに制限されている場合に使用できます。 例えば、顧客があるアドレスへのメール送信をオプトアウトし、別のアドレスへのメール送信を許可することができます。

idSpecific オブジェクトの各キーは、Adobe Experience Platform Identity Serviceによって認識される特定のID名前空間を表します。 様々な識別子を分類するために独自のカスタム名前空間を定義できますが、リアルタイム顧客プロファイルのストレージサイズを削減するには、Identity Serviceが提供する標準的な名前空間のいずれかを使用することをお勧めします。 ID名前空間について詳しくは、Identity Service ドキュメントの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"
        }
      }
    }
  }
}

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

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

adID

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

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

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

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

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

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

顧客がweb サイト上の同意や嗜好を変更した場合、その変更を収集し、使用するデータ収集ライブラリで同意を設定することですぐに適用する必要があります。 お客様がデータ収集をオプトアウトした場合、すべてのデータ収集は直ちに停止する必要があります。 顧客がパーソナライゼーションをオプトアウトした場合、次のページにパーソナライゼーションが表示されないようにする必要があります。 JavaScript ライブラリを使用したsetConsentまたはWeb SDK タグ拡張機能を使用した同意を設定 アクションを参照してください。

次の手順

このドキュメントでは、同意と環境設定 フィールドグループの構造と使用について説明しました。 フィールドグループが提供するその他のフィールドについて詳しくは、「​ プライバシー、Personalizationおよびマーケティング環境設定に関する同意 データタイプ ​」のドキュメントを参照してください。