バッチ宛先マッピング参照

この記事では、バッチプロファイルの書き出し先🔗に対してオーディエンスを アクティブ化する際の​ マッピング ​手順の必須の属性、重複排除キー、計算フィールド、および既知の制限について説明します。

必須の属性 mandatory-attributes

必須属性は、選択した属性がすべてのプロファイルレコードに含まれるようにする、ユーザーが有効にしたチェックボックスです。 例:書き出されたすべてのプロファイルに電子メールアドレスが含まれています。

Experience Platform が特定の属性を含むプロファイルのみを書き出すよう、属性を必須としてマークすることができます。 その結果、追加のフィルタリング形式として使用できます。 属性を必須としてマークする必要は​ありません

必須属性を選択しない場合、属性に関係なく、すべての対象プロファイルを書き出します。

属性の 1 つをスキーマの一意の ID にすることをお勧めします。 必須属性について詳しくは、メールマーケティングの宛先ドキュメントの ID の節を参照してください。

重複排除キー deduplication-keys

IMPORTANT
スケジュールされた書き出しに対して、常に重複排除キーを設定します。 重複排除を使用しない場合、スケジュールされた書き出しはスナップショットと増分データの両方を処理するため、同じプロファイルに対して行が重複したり、セグメントメンバーシップが競合したりすることがあります。

重複排除キーは、プロファイルの重複排除の方法を決定するユーザー定義のプライマリキーです。 同じ個人に複数のレコードが存在する場合、重複排除によって最新のレコードのみが書き出されます。

重複排除キーを使用すると、同一プロファイルの複数のレコードが 1 つの書き出しファイルに含まれる可能性がなくなります。

Experience Platform で重複排除キーを使用する方法は 3 つあります。

  • 単一のID名前空間を重複排除キーとして使用する
  • XDM プロファイルの単一のプロファイル属性を重複排除キーとして使用しています
  • 複合キーとして、XDM プロファイルから 2 つのプロファイル属性の組み合わせを使用する
IMPORTANT
単一の ID 名前空間を宛先に書き出すことができ、名前空間は自動的に重複排除キーとして設定されます。 複数の名前空間を宛先に送信することはサポートされていません。
ID 名前空間とプロファイル属性の組み合わせを重複排除キーとして使用することはできません。

重複排除の例 deduplication-example

次の例は、選択した重複排除キーに応じた重複排除の仕組みを示しています。

次の 2 つのプロファイルについて考えてみましょう。

プロファイル A

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe@example.com"
      },
      {
        "id": "doejohn_1@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-03-10 10:03:08"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "Doe",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

プロファイル B

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe@example.com"
      },
      {
        "id": "doejohn_2@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-04-10 11:33:28"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "D",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

重複排除の使用例 1:重複排除なし deduplication-use-case-1

重複排除を使用しない場合、書き出しファイルには次のエントリが含まれます。

personalEmail
firstName
lastName
johndoe@example.com
John
Doe
johndoe@example.com
John
D

重複排除の使用例 2:ID 名前空間に基づく重複排除 deduplication-use-case-2

Email 名前空間の重複排除を指定した場合、書き出しファイルには次のエントリが含まれます。 プロファイル Bは、オーディエンスに適格な最新のプロファイルなので、書き出されるのはプロファイル Bのみです。

メール*
personalEmail
firstName
lastName
johndoe@example.com
johndoe@example.com
John
D
doejohn_2@example.com
johndoe@example.com
John
D

重複排除のユースケース 3:単一のプロファイル属性に基づく重複排除 deduplication-use-case-3

personal Email 属性による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。 プロファイル Bは、オーディエンスに適格な最新のプロファイルなので、書き出されるのはプロファイル Bのみです。

personalEmail*
firstName
lastName
johndoe@example.com
John
D

重複排除のユースケース 4:2 つのプロファイル属性に基づく重複排除 deduplication-use-case-4

複合キー personalEmail + lastName による重複排除を仮定した場合、エクスポートファイルには次のエントリが含まれます。

personalEmail*
lastName*
firstName
johndoe@example.com
D
John
johndoe@example.com
Doe
John

CRM ID やメールアドレスなどの ID 名前空間を重複排除キーとして選択して、すべてのプロファイルレコードが必ず一意に識別されるようにすることをお勧めします。

同じタイムスタンプを持つプロファイルの重複排除の動作 deduplication-same-timestamp

プロファイルをファイルベースの宛先に書き出す場合、重複排除によって、複数のプロファイルが同じ重複排除キーと同じ参照タイムスタンプを共有する場合に、1つのプロファイルのみが書き出されます。 このタイムスタンプは、プロファイルのオーディエンスメンバーシップまたはID グラフが最後に更新された時点を表します。 プロファイルの更新およびエクスポート方法について詳しくは、​ プロファイルのエクスポート動作 ドキュメントを参照してください。

重要な考慮事項 key-considerations

  • 決定的選択:複数のプロファイルに同じ重複排除キーと同じ参照タイムスタンプがある場合、重複排除ロジックは、選択した他の列(配列、マップ、オブジェクトなどの複雑な型を除く)の値を並べ替えることで、書き出すプロファイルを決定します。 ソートされた値は辞書順に評価され、最初のプロファイルが選択されます。

  • シナリオ例

重複排除キーがEmail列である次のデータを考えてみましょう。

メール*
first_name
last_name
タイムスタンプ
test1@test.com
John
モリス
2024-10-12T09:50
test1@test.com
John
Doe
2024-10-12T09:50
test2@test.com
フランク
スミス
2024-10-12T09:50

重複排除の後、エクスポートファイルには次のものが含まれます。

メール*
first_name
last_name
タイムスタンプ
test1@test.com
John
Doe
2024-10-12T09:50
test2@test.com
フランク
スミス
2024-10-12T09:50

説明: test1@test.comでは、両方のプロファイルが同じ重複排除キーとタイムスタンプを共有しています。 アルゴリズムは、first_namelast_name列の値を辞書的に並べ替えます。 名前は同じなので、タイはlast_name列を使用して解決されます。この列の前には「Doe」が表示されます。

信頼性の向上:この更新された重複排除プロセスにより、同じ座標を持つ連続した実行が常に同じ結果を生成し、一貫性が向上します。

計算フィールドを使用してデータ変換を実行する calculated-fields

計算フィールド ​ コントロールを使用して、ファイルベースの宛先に書き出されたデータに対して様々なデータ変換を実行できます。

既知の制限事項 known-limitations

新しい​マッピング ページには、次の既知の制限があります。

マッピングワークフローでオーディエンスメンバーシップ属性を選択できません audience-membership-attribute-mapping

既知の制限により、現在、フィールドを選択 ウィンドウを使用してsegmentMembership.seg_namespace.seg_id.statusをファイル書き出しに追加することはできません。 代わりに、手動で値 xdm: segmentMembership.seg_namespace.seg_id.status をスキーマフィールドに貼り付ける必要があります(下図を参照)。

​ アクティベーションワークフローのマッピングステップにおけるオーディエンスメンバーシップの回避策を示す画面録画。 {modal="regular"}

NOTE
クラウドストレージの宛先の場合、デフォルトで次の属性がマッピングに追加されます。
  • segmentMembership.seg_namespace.seg_id.status
  • segmentMembership.seg_namespace.seg_id.lastQualificationTime

ファイルのエクスポートは、segmentMembership.seg_namespace.seg_id.status が選択されているかどうかによって、次のように異なります。

  • segmentMembership.seg_namespace.seg_id.status フィールドが選択されている場合、書き出されたファイルには、最初の完全スナップショットに​アクティブ メンバーが含まれ、その後の増分書き出しには新たに​アクティブ メンバーと​期限切れ メンバーが含まれます。
  • segmentMembership.seg_namespace.seg_id.status フィールドが選択されていない場合、書き出されたファイルには、最初の完全スナップショットとその後の増分書き出しに含まれるメンバーは​ アクティブ ​のみです。

ファイルベースの宛先に対する​ プロファイル書き出し動作の詳細をご確認ください。

ID 名前空間は現在、書き出し用に選択できません identity-namespaces-export-limitation

以下の画像に示すように、ID 名前空間を書き出し用に選択する機能は、現在サポートされていません。 書き出し用にID名前空間を選択すると、レビュー​手順でエラーが発生します。

IDの書き出しを示すマッピングはサポートされていません。 {modal="regular"}

ベータ版の間に書き出したファイルに ID 名前空間を追加する必要がある場合の一時的な回避策として、次のいずれかを実行できます。

  • 書き出しに ID 名前空間を含めるデータフローに、従来のクラウドストレージの宛先を使用する
  • ID を属性として Experience Platform にアップロードし、クラウドストレージの宛先に書き出します。
recommendation-more-help
experience-platform-help-destinations