POST /identity/map
複数のメールアドレス、電話番号、またはそれぞれのハッシュを、raw UID2 と salt bucket IDs にマッピングします。このエンドポイントを使用して、オプトアウト情報の更新をチェックすることもできます
Used by: このエンドポイントは、主に広告主やデータプロバイダーが使用します。詳細は Advertiser/Data Provider Integration Overview を参照してください。
UID2 の Opt-Out ワークフローとユーザーが Opt-Out する方法の詳細については、User Opt-Out を参照してください。
Batch Size and Request Parallelization Requirements
知っておくべきことは以下のとおりです:
- リクエストの最大サイズは 1MB です。
- 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマップするには、1 バッチあたり最大 5,000 アイテムのバッチサイズで、それらを 連続した バッチで送信してください。
- Private Operator を使用している場合を除き、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用して、directly identifying information (DII) を連続してマッピングしてください。
- メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。
マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする必要がある場合に、処理時間が大幅に増加する可能性があります。しかし、実際に更新が必要なマッピングのみを再計算することで、毎日更新が必要な raw UID2 の数は約 1/365 となり、総処理時間を短縮できます。Advertiser/Data Provider Integration Overview と FAQs for Advertisers and Data Providers も参照してください。
Request Format
POST '{environment}/v2/identity/map'
認証の詳細については、 Authentication and Authorization を参照してください。
important
すべてのリクエストを秘密鍵で暗号化する必要があります。詳細といくつかのプログラミング言語でのコードの例は、リクエストの暗号化とレスポンスの復号化 を参照してください。
Path Parameters
Path Parameter | Data Type | Attribute | Description |
---|---|---|---|
{environment} | string | 必須 | テスト (インテグレーション) 環境: https://operator-integ.uidapi.com 本番環境: https://prod.uidapi.com リージョンごとのオペレーターを含む全リストは Environments を参照してください。 |
注記
インテグレーション環境と本番環境では、異なる API Key が必要です。
Unencrypted JSON Body Parameters
important
リクエストを暗号化するときは、以下の 4 つの条件パラメータのうち、1つ だけをリクエストの JSON ボディにキーと値のペアとして含める必要がります。
Body Parameter | Data Type | Attribute | Description |
---|---|---|---|
email | string array | 条件付きで必要 | マッピングするメールアドレスのリストです。 |
email_hash | string array | 条件付きで必要 | マッピングする SHA-256 ハッシュし、Base64 エンコード した 正規化 済みメールアドレスのリストです。 |
phone | string array | 条件付きで必要 | マッピングする 正規化 済み電話番号のリストです。 |
phone_hash | string array | 条件付きで必要 | マッピングする SHA-256 ハッシュし、Base64 エンコード した 正規化 済み電話番号のリストです。 |