Skip to content

Commit 2d9a8cb

Browse files
committed
fix broken link in FAQs file
1 parent 5eb498e commit 2d9a8cb

File tree

2 files changed

+9
-13
lines changed
  • docs/getting-started
  • i18n/ja/docusaurus-plugin-content-docs/current/getting-started

2 files changed

+9
-13
lines changed

docs/getting-started/gs-faqs.md

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,6 @@ Here are some frequently asked questions for advertisers and data providers usin
175175
- [If two operators process the same DII, are the results the same?](#if-two-operators-process-the-same-dii-are-the-results-the-same)
176176
- [How do I know when to refresh the UID2 due to salt bucket rotation?](#how-do-i-know-when-to-refresh-the-uid2-due-to-salt-bucket-rotation)
177177
- [Do refreshed emails get assigned to the same bucket with which they were previously associated?](#do-refreshed-emails-get-assigned-to-the-same-bucket-with-which-they-were-previously-associated)
178-
- [How often should Raw UID2s be refreshed for incremental updates older buckets-based flow?](#how-often-should-raw-uid2s-be-refreshed-for-incremental-updates-older-buckets-based-flow)
179178

180179
#### How do I know when to refresh a raw UID2?
181180

@@ -194,7 +193,11 @@ We recommend checking for refresh opportunities daily. It is guaranteed that the
194193

195194
The recommended cadence for updating audiences is daily.
196195

197-
A raw UID2 for a specific user changes at least once per year. The V3 Identity Map API provides refresh timestamps that indicate a point after which each raw UID2 might refresh. We recommend checking these timestamps daily to ensure your raw UID2s remain current and valid for audience targeting.
196+
A raw UID2 for a specific user changes at least once per year. The latest version of the [POST /identity/map](../endpoints/post-identity-map.md) endpoint provides refresh timestamps that indicate a point after which each raw UID2 might refresh. We recommend checking these timestamps daily to ensure your raw UID2s remain current and valid for audience targeting.
197+
198+
For implementations that reference earlier versions of this endpoint (see [POST /identity/map v2](../endpoints/post-identity-map-v2.md)):
199+
200+
Even though each <Link href="../ref-info/glossary-uid#gl-salt-bucket">salt bucket</Link> is updated roughly once a year, individual bucket updates are spread over the year. This means that about 1/365th of all buckets are rotated daily. If fidelity is critical, consider calling the [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md) endpoint more frequently; for example, hourly.
198201

199202
#### How should I generate the SHA-256 of DII for mapping?
200203

@@ -220,7 +223,7 @@ If a user opts out through your website, you should follow your internal procedu
220223

221224
In general yes, the process of generating a raw UID2 from DII is the same, and results in the same value, no matter who sent the request. If two UID2 participants were to send the same email address to the [POST&nbsp;/identity/map](../endpoints/post-identity-map.md) endpoint at the same time, they would both get the same raw UID2 in response.
222225

223-
However, there is a variable factor that's used in generating the raw UID2. The underlying values are refreshed roughly once per year (for details, see [How often should UID2s be refreshed for incremental updates?](#how-often-should-uid2s-be-refreshed-for-incremental-updates)). If these values change between one request and another, those two requests result in two different raw UID2, even when the DII is the same.
226+
However, there is a variable factor that's used in generating the raw UID2. The underlying values are refreshed roughly once per year (for details, see [How often should raw UID2s be refreshed for incremental updates?](#how-often-should-raw-uid2s-be-refreshed-for-incremental-updates)). If these values change between one request and another, those two requests result in two different raw UID2, even when the DII is the same.
224227

225228
For more information, see [Monitor for Raw UID2 Refresh](../guides/integration-advertiser-dataprovider-overview.md#5-monitor-for-raw-uid2-refresh) in the *Advertiser/Data Provider Integration Guide*.
226229

@@ -250,13 +253,6 @@ Not necessarily. After you remap emails associated with a particular bucket ID,
250253
When mapping and remapping emails, do not make any assumptions about the number of buckets, their rotation dates, or the specific bucket that an email gets assigned to.
251254
:::
252255

253-
#### How often should Raw UID2s be refreshed for incremental updates older buckets-based flow?
254-
255-
The recommended cadence for updating audiences is daily.
256-
257-
Even though each salt bucket is updated roughly once a year, individual bucket updates are spread over the year. This means that about 1/365th of all buckets are rotated daily. If fidelity is critical, consider calling the [POST&nbsp;/identity/buckets](../endpoints/post-identity-buckets.md) endpoint more frequently; for example, hourly.
258-
259-
260256
## FAQs for DSPs
261257

262258
Here are some frequently asked questions for demand-side platforms (DSPs).

i18n/ja/docusaurus-plugin-content-docs/current/getting-started/gs-faqs.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ UID2 フレームワークを使用する広告主やデータプロバイダー
173173

174174
- [ソルトバケットのローテーションによって UID2 をリフレッシュするタイミングを知るには?](#how-do-i-know-when-to-refresh-the-uid2-due-to-salt-bucket-rotation)
175175
- [更新されたメールアドレスは、以前関連付けられていたバケットと同じバケットに割り当てられますか?](#do-refreshed-emails-get-assigned-to-the-same-bucket-with-which-they-were-previously-associated)
176-
- [インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか?](#how-often-should-uid2s-be-refreshed-for-incremental-updates)
176+
- [インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか?](#how-often-should-raw-uid2s-be-refreshed-for-incremental-updates)
177177
- [マッピング用の DII の SHA-256 はどのように生成すればよいですか?](#how-should-i-generate-the-sha-256-of-dii-for-mapping)
178178
- [メールアドレス、電話番号、または対応するハッシュと raw UID2 のマッピングを、自身のデータセットに保存すべきでしょうか?](#should-i-store-mapping-of-email-addresses-phone-numbers-or-corresponding-hashes-to-raw-uid2s-in-my-own-datasets)
179179
- [ユーザーのオプトアウトはどのように処理すればよいですか?](#how-should-i-handle-user-opt-outs)
@@ -198,7 +198,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生
198198
メールアドレスのマッピングや再マッピングを行う際には、バケットの数やローテーションする日、メールアドレスが割り当てられる特定のバケットについて、いかなる仮定も行わないようにしてください。
199199
:::
200200

201-
#### How often should UID2s be refreshed for incremental updates?
201+
#### How often should raw UID2s be refreshed for incremental updates?
202202
インクリメンタルアップデートの場合、UID2 はどのくらいの頻度で更新するべきですか?
203203

204204
オーディエンスの更新は、毎日行うことが推奨されています。
@@ -233,7 +233,7 @@ UID2 生成リクエストで提供されるメタデータには、UID2 の生
233233

234234
一般的にその通りです。DII から raw UID2 を生成するプロセスは同じであり、誰がリクエストを送信したかに関係なく、結果は同じ値になります。 2 人の UID2 参加者が同じメールアドレスを [POST&nbsp;/identity/map (v2)](../endpoints/post-identity-map-v2.md) エンドポイントに同時に送信した場合、応答として両方とも同じ raw UID2 を取得します。
235235

236-
ただし、raw UID2 の生成に使用される秘密の [ソルト](../ref-info/glossary-uid.md#gl-salt) 値という可変要素があります。ソルト値は定期的にローテーションされます(詳細は [How often should UID2s be refreshed for incremental updates?](#how-often-should-uid2s-be-refreshed-for-incremental-updates)) を参照)。あるリクエストと別のリクエストの間でソルト値が変化する場合、DII が同じであっても、これら 2 つのリクエストは 2 つの異なる raw UID2 になります。
236+
ただし、raw UID2 の生成に使用される秘密の [ソルト](../ref-info/glossary-uid.md#gl-salt) 値という可変要素があります。ソルト値は定期的にローテーションされます(詳細は [How often should raw UID2s be refreshed for incremental updates?](#how-often-should-raw-uid2s-be-refreshed-for-incremental-updates)) を参照)。あるリクエストと別のリクエストの間でソルト値が変化する場合、DII が同じであっても、これら 2 つのリクエストは 2 つの異なる raw UID2 になります。
237237

238238
詳細は、*Advertiser/Data Provider Integration Guide*[Monitor for Salt Bucket Rotations for Your Stored Raw UID2s](../guides/integration-advertiser-dataprovider-overview.md#5-monitor-for-salt-bucket-rotations-for-your-stored-raw-uid2s) を参照してください。
239239

0 commit comments

Comments
 (0)