​ 同意および環境設定 ​ フィールドグループ

​ 同意および環境設定 ​ は、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 は、特定の同意または環境設定が顧客に普遍的に適用されるのではなく、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"
        }
      }
    }
  }
}

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

次の手順

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