Skip to main content

​
オーディエンスの移行

AdCP 3.0 rc.1 は external_id を uid-type 列挙の値から AudienceMember の必須トップレベルフィールドに昇格させる。すべてのオーディエンスメンバーは、バイヤーが割り当てた安定した識別子と、少なくとも1つのマッチング可能な識別子を持つ必要があります。

​
変更内容

​
AudienceMember スキーマ

スキーマで適用される2つの要件:
  1. external_id は必須 — バイヤーが割り当てた安定した識別子（CRM レコード ID、ロイヤルティ ID）
  2. 少なくとも1つのマッチング可能な識別子 — hashed_email、hashed_phone、または uids 配列

​
変更前後

beta.3 — uid-type エントリとしての external_id:
test=false
rc.1 — 必須トップレベルフィールドとしての external_id:
test=false

​
uid-type 列挙

uid-type 列挙には external_id が含まれなくなりました。現在の値:

​
変更の理由

external_id を uid-type 列挙から分離することで、バイヤーの安定した識別子が明示的になります。これにより以下が可能になる:
  • 重複排除 — external_id でシンク間の重複メンバーを削除します
  • ターゲット削除 — 全リストを再アップロードせずに特定のメンバーを削除します
  • クロスリファレンス — オーディエンスメンバーシップをバイヤーの CRM システムと相関させる
ネイティブに ID を割り当てない CDP は1つを導出できる（例: メンバーの識別子のハッシュ）。

​
オーディエンスの同期

sync_audiences はオーディエンスごとにデルタオペレーション（add/remove）を使用します。メンバーは削除時に external_id で識別されます:
test=false

​
移行ステップ

1

uids から external_id を抽出する

uids 配列の { "type": "external_id", "value": "..." } エントリをトップレベルの external_id フィールドに移動します。
2

すべてのメンバーに external_id を確保する

メンバーにバイヤーが割り当てた ID がない場合、1つを導出する（例: 識別子のハッシュ）。スキーマはすべてのメンバーに external_id を要求します。
3

少なくとも1つのマッチング可能な識別子を保持する

すべてのメンバーには hashed_email、hashed_phone、または uids の少なくとも1つが必要です。これはスキーマの anyOf 制約で適用されます。
4

削除ロジックを更新する

sync_audiences でメンバーを削除するとき、安定したキーとして external_id を使用します。メンバーは remove 配列にもマッチング可能な識別子が必要です。
5

スキーマに対して検証する

メンバーオブジェクトを audience-member.json スキーマに対して実行します。external_id（必須）とマッチング可能な識別子制約の両方が適用されます。

シグナルプロトコル

シグナル探索、アクティベーション、価格モデルの完全リファレンス。
関連: ブランドアイデンティティ | 最適化目標 | AdCP 3.0 概要