@@ -28,10 +28,15 @@ UID2 のオプトアウト手順とユーザーがオプトアウトする方法
2828以下が必要な情報です:
2929
3030- 最大リクエストサイズは 1MB です。
31- - 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマッピングする場合は、1 バッチあたり最大 5,000 アイテムの * 順次* バッチで送信します。
32- - <Link href =" ../ref-info/glossary-uid#gl-private-operator " >Private Operator</Link > を使用していない限り、バッチを並行して送信しないでください。つまり、単一の HTTP 接続を使用し、ハッシュ化またはハッシュされていない <Link href =" ../ref-info/glossary-uid#gl-dii " >Directly Identifying Information (DII)</Link > 値のバッチを連続して送信し、複数の並行接続を作成しないでください。
31+ - 大量のメールアドレス、電話番号、またはそれぞれのハッシュをマップするには、1 バッチあたり最大 5,000 アイテムで送信してください。同時に送信するバッチは 20 件以内にすることを勧めます。
3332- メールアドレス、電話番号、またはそれぞれのハッシュのマッピングを必ず保存してください。<br />マッピングを保存しないと、数百万のメールアドレスや電話番号をマッピングする際に処理時間が大幅に増加する可能性があります。ただし、実際に更新が必要なマッピングのみを再計算すると、UID2 の約 1/365 が毎日更新されるため、総処理時間が短縮されます。詳細は、[ Advertiser/data provider integration overview] ( ../guides/integration-advertiser-dataprovider-overview.md ) と [ FAQs for advertisers and data providers] ( ../getting-started/gs-faqs.md#faqs-for-advertisers-and-data-providers ) を参照してください。
3433
34+ ## Rate limiting
35+
36+ 公正な使用とプラットフォームの安定性を確保するために、` POST /v3/identity/map ` エンドポイントは、急激なトラフィックの増加から保護するためにレート制限を適用しています。短時間に多数のリクエストを送信すると、` 429 ` エラー応答が返される可能性があります。
37+
38+ レート制限エラーを適切に処理するには、リクエストを再試行する際に [ exponential backoff] ( https://en.wikipedia.org/wiki/Exponential_backoff ) とランダムジッターを実装することを勧めます。制限内でスループットを最大化するには、多数の小さなリクエストを送信するのではなく、リクエストごとに最大バッチサイズの 5,000 アイテムを使用してください。
39+
3540## Request format
3641
3742` POST '{environment}/v3/identity/map' `
@@ -140,12 +145,12 @@ Response:
140145 {
141146 "u" : " AdvIvSiaum0P5s3X/7X8h8sz+OhF2IG8DNbEnkWSbYM="
142147 "p" : " EObwtHBUqDNZR33LNSMdtt5cafsYFuGmuY4ZLenlue4="
143- "r" : 1735689600000
148+ "r" : 1735689600
144149 },
145150 {
146151 "u" : " IbW4n6LIvtDj/8fCESlU0QG9K/fH63UdcTkJpAG8fIQ="
147152 "p" : null ,
148- "r" : 1735862400000
153+ "r" : 1735862400
149154 },
150155 { "e" : " invalid identifier"
151156 { "e" : " optout"
@@ -176,7 +181,7 @@ DII が正常にマッピングされた場合、マッピングされたオブ
176181| :------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
177182| ` u ` | string | リクエストで提供されたメールアドレスまたは電話番号に対応する raw UID2。 |
178183| ` p ` | string | 以下のいずれか:<ul ><li >現在の raw UID2 が過去 90 日以内にローテーションされた場合: 以前の raw UID2。</li ><li >それ以外の場合: ` null ` 。</li ></ul > |
179- | ` r ` | number | raw UID2 を更新する可能性がある時刻を示す Unix タイムスタンプ（ミリ秒 ）。raw UID2 はこのタイムスタンプまで有効です。 |
184+ | ` r ` | number | raw UID2 を更新する可能性がある時刻を示す Unix タイムスタンプ（秒 ）。raw UID2 はこのタイムスタンプまで有効です。 |
180185
181186::: note
182187raw UID2 はリフレッシュタイムスタンプの前では変化しません。リフレッシュタイムスタンプの後、DII を再マッピングすると新しいリフレッシュタイムスタンプが返されますが、raw UID2 は変化する場合もあれば変化しない場合もあります。raw UID2 が複数のリフレッシュ間隔にわたって変化しない可能性もあります。
@@ -197,8 +202,13 @@ raw UID2 はリフレッシュタイムスタンプの前では変化しませ
197202| ` success ` | 200 | リクエストは成功しました。レスポンスは暗号化されます。 |
198203| ` client_error ` | 400 | リクエストに欠落または無効なパラメーターが含まれていました。 |
199204| ` unauthorized ` | 401 | リクエストにベアラートークンが含まれていない、無効なベアラートークンが含まれている、またはリクエストされた操作を実行する権限のないベアラートークンが含まれていました。 |
205+ | N/A | 429 | このエンドポイントへのリクエストが多すぎます。待ってからexponential backoffを使用して再試行してください。 |
200206
201- ` status ` プロパティの値が ` success ` 以外の場合、` message ` フィールドには問題に関する追加情報が提供されます。
207+ ` status ` の値が ` success ` 以外であれば、` message ` フィールドにその問題に関する追加情報が表示されます。Note: 429 のレスポンスには、JSON 形式のレスポンス本文が含まれていません。
208+
209+ ::: note
210+ 429 のレスポンスには、JSON 形式のレスポンスボディが含まれていません。
211+ :::
202212
203213## Migration from POST /v2/identity/map
204214
@@ -285,7 +295,7 @@ for index, item in enumerate(response['body']['email']):
285295import time
286296
287297def is_refresh_needed (mapping ):
288- now = int (time.time() * 1000 ) # Convert to milliseconds
298+ now = int (time.time()) # Current time in seconds
289299 return now >= mapping[' refresh_from'
290300
291301# Check individual mappings for refresh needs
0 commit comments