Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/getting-started/gs-faqs.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ For details, see [Recommended Token Refresh Frequency](../ref-info/ref-tokens.md
You can use the `[email protected]` email address or the `+00000000002` phone number to test your token refresh workflow. Using either parameter value in a request always generates an identity response with a `refresh_token` that results in a logout response.

:::tip
To arrive at the hashed and Base64-encoded values of any email address or phone number value, use the [UID2 Hashing Tool](gs-normalization-encoding.md#uid2-hashing-tool).
To get the normalized, hashed, and Base64-encoded hashed values for any email address, or the hashed and Base64-encoded hashed values for a phone number, you can use the hashing tool: see [UID2 Hashing Tool](gs-normalization-encoding.md#uid2-hashing-tool).
:::

The procedure is a little different depending on whether or not you are using an SDK.
Expand Down
16 changes: 8 additions & 8 deletions docs/guides/integration-google-ss.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ window.getUid2AdvertisingToken = async () => {

For details, see [Publisher Integration Guide, Server-Side](integration-publisher-server-side.md).

A sample application is also available for server-side integration. See [Sample Applications](#sample-applications).
A sample implementation is also available for server-side integration. See [Sample Implementations](#sample-implementations).

### SDK for JavaScript Client-Side Integration

Expand All @@ -105,20 +105,20 @@ This script is hosted on CDN, and GPT automatically loads it with the secure sig

For details, see [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md).

A sample application is also available for integration using the SDK for JavaScript. See [Sample Applications](#sample-applications).
A sample implementation is also available for integration using the SDK for JavaScript. See [Sample Implementations](#sample-implementations).

## Sample Applications
## Sample Implementations

The following sample applications are available to illustrate how to integrate with the Google Ad Manager secure signals feature:
The following sample implementations are available to illustrate how to integrate with the Google Ad Manager secure signals feature:

- Server-Side UID2 Integration Example:
Copy link
Contributor

@sunnywu sunnywu Dec 6, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these changes are not right - Nothing here is "Client-side". I don't think this section requires any changes

So the original copy is actually correct to me. My understanding is:

Server-Side UID2 Integration Example:

  • Generate token on server side
  • Only present and present the generated token on the webpage inside the browser and store the generated token inside cookie ad-hoc and DOES NOT use UID2 Javascript SDK inside the browser (Server-Side may not be fully descriptive but thats another discussion).

Client-Server UID2 SDK Integration:

  • Generate token on server side
  • store the generated token inside the UID2 Javascript SDK embedded on the webpage (hence Client-Server)

The integration with the google secure signals are identical for both.

@ssundahlTTD could you confirm if my understanding is correct?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @sunnywu I've backed out this section pending input from @ssundahlTTD : merging the rest for now.

- [Sample application](https://secure-signals-srvonly-integ.uidapi.com/)
- Server-Side UID2 SDK Integration Example:
- [Sample implementation](https://secure-signals-srvonly-integ.uidapi.com/)
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_only)
- Client-Server UID2 SDK Integration Example:
- [Sample application](https://secure-signals-jssdk-integ.uidapi.com/)
- [Sample implementation](https://secure-signals-jssdk-integ.uidapi.com/)
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)

Each sample application has its own instructions.
Each sample implementation has its own instructions.

## Troubleshooting

Expand Down
4 changes: 2 additions & 2 deletions docs/guides/integration-javascript-client-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,9 @@ If you prefer to integrate with UID2 via **only** client-side JavaScript changes

For technical details about the SDK, see [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript.md).

## Sample Implementation Website
## Sample Implementation

For an example application, see the UID2 Google Secure Signals with SDK v3 example:
For a sample implementation, see the UID2 Google Secure Signals with SDK v3 example:
- Code and docs: [UID2 SDK Secure Signals Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)
- Running site: [Client-Server UID2 SDK Integration Example](https://secure-signals-jssdk-integ.uidapi.com/)

Expand Down
4 changes: 2 additions & 2 deletions docs/guides/integration-javascript-client-side.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,9 +55,9 @@ If you want to use a debug build of the SDK, use the following URL instead:

- [https://cdn.integ.uidapi.com/uid2-sdk-3.4.5.js](https://cdn.integ.uidapi.com/uid2-sdk-3.4.5.js)

## Sample Implementation Website
## Sample Implementation

For an example website, see this example:
For a sample implementation, see this example:
- Code: [Example Client-Side Integration for JavaScript](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg)
- Running site: [Client-Side Integration Example, UID2 JavaScript SDK](https://cstg-integ.uidapi.com/)

Expand Down
10 changes: 5 additions & 5 deletions docs/guides/integration-publisher-server-side.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The following options are available for publishers to integrate with UID2 on the
- SDK for Python (see [Usage for Publishers](../sdks/sdk-ref-python.md#usage-for-publishers) section).
- Custom server code to generate and refresh the UID2 token by calling the [POST /token/generate](../endpoints/post-token-generate.md) and [POST /token/refresh](../endpoints/post-token-refresh.md) endpoints.

There is also an example application that demonstrates the workflow. See [Sample Application](#sample-application).
There is also a sample implementation that demonstrates the workflow. See [Sample Implementation](#sample-implementation).

For a complete summary of publisher integration options, see [Publisher Integrations](summary-guides.md#publisher-integrations).

Expand Down Expand Up @@ -108,12 +108,12 @@ If the user logs out, do not use the UID2 token.
| 4-a | N/A | The user logs out from a publisher asset. |
| 4-b | N/A | Remove the UID2 token you've stored for that user. No interaction with the UID2 service is required. |

## Sample Application
## Sample Implementation

A sample application is available for server-side integration. See:
A sample implementation is available for server-side integration. See:

- [Server-Side UID2 Integration Example (sample application)](https://secure-signals-srvonly-integ.uidapi.com/)
- [Server-Side UID2 Integration Example (readme)](https://github.com/IABTechLab/uid2-examples/blob/main/publisher/server_only/README.md)
- [Client-Server UID2 Integration Example (sample implementation)](https://secure-signals-srvonly-integ.uidapi.com/)
- [Client-Server UID2 Integration Example (readme)](https://github.com/IABTechLab/uid2-examples/blob/main/publisher/server_only/README.md)

## FAQs

Expand Down
2 changes: 1 addition & 1 deletion docs/sdks/sdk-ref-javascript.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ This SDK simplifies development for publishers who want to build their own custo
| :--- | :--- | :--- | :--- | :--- | :--- |
| — | — | ✅ | ✅ | — | — |

## Sample Implementation Website
## Sample Implementation

For example applications with associated documentation, see:
- The UID2 Google Secure Signals with SDK v3 example:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ window.getUid2AdvertisingToken = async () => {

詳しくは、[Server-Only UID2 Integration Guide](integration-publisher-server-side.md) を参照してください。

Server Only インテグレーションのためのサンプルアプリケーションも用意されています。[Sample Applications](#sample-applications) を参照してください。
Server Only インテグレーションのためのサンプルアプリケーションも用意されています。[Sample Implementations](#sample-implementations) を参照してください。

### SDK for JavaScript Client-Side Integration

Expand All @@ -105,17 +105,17 @@ SDK for JavaScript バージョン 3.0.0 以降を使用している場合、UID

詳しくは [Client-Side Integration Guide for JavaScript](integration-javascript-client-side.md) を参照してください。

SDK for JavaScript を使用したインテグレーションのためのサンプルアプリケーションも用意されています。[Sample Applications](#sample-applications) を参照してください。
SDK for JavaScript を使用したインテグレーションのためのサンプルアプリケーションも用意されています。[Sample Implementations](#sample-implementations) を参照してください。

## Sample Applications
## Sample Implementations

Google Ad Manager のセキュアシグナル機能との連携方法については、以下のサンプルアプリケーションを参照してください:

- Server-Side UID2 Integration Example:
- [Sample application](https://secure-signals-srvonly-integ.uidapi.com/)
- Server-Side UID2 SDK Integration Example:
- [Sample implementation](https://secure-signals-srvonly-integ.uidapi.com/)
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/server_only)
- Client-Server UID2 SDK Integration Example:
- [Sample application](https://secure-signals-jssdk-integ.uidapi.com/)
- [Sample implementation](https://secure-signals-jssdk-integ.uidapi.com/)
- [Code repository](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)

各サンプルアプリケーションには独自のインストラクションがあります。
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Client-Side の JavaScript の変更 **だけ** で UID2 とインテグレー

SDK の技術的な詳細は [SDK for JavaScript Reference Guide](../sdks/sdk-ref-javascript.md) を参照してください。

## Sample Implementation Website
## Sample Implementation

アプリケーションの例については、SDK v3 を使用した UID2 Google Secure Signals の例を参照してください:
- コードとドキュメント: [UID2 SDK Secure Signals Integration Example](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/google-secure-signals-integration/with_sdk_v3)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ SDK のデバッグビルドを使用したい場合は、代わりに以下の

- [https://cdn.integ.uidapi.com/uid2-sdk-3.4.5.js](https://cdn.integ.uidapi.com/uid2-sdk-3.4.5.js)

## Sample Implementation Website
## Sample Implementation

アプリケーションの例については、SDK v3 を使用した UID2 Google Secure Signals の例を参照してください:
- Code: [Example Client-Side Integration for JavaScript](https://github.com/IABTechLab/uid2-web-integrations/tree/main/examples/cstg)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ import Link from '@docusaurus/Link';
- SDK for Python (see [Usage for Publishers](../sdks/sdk-ref-python.md#usage-for-publishers) section).
- Custom server code to generate and refresh the UID2 token by calling the [POST /token/generate](../endpoints/post-token-generate.md) and [POST /token/refresh](../endpoints/post-token-refresh.md) endpoints.

ワークフローを示すサンプルアプリケーションもあります。詳細は [Sample Application](#sample-application) を参照してください。
ワークフローを示すサンプルアプリケーションもあります。詳細は [Sample Implementation](#sample-implementation) を参照してください。

パブリッシャーインテグレーションオプションの完全な概要については、[Publisher Integrations](summary-guides.md#publisher-integrations) を参照してください。

Expand Down Expand Up @@ -106,12 +106,12 @@ UID2 Token が SSP から DSP に送信されるとき、ビッドストリー
| 4-a | N/A | ユーザーがパブリッシャーアセットからログアウトしました。|
| 4-b | N/A | そのユーザー用に保存してある UID2 Token を削除します。UID2 Service とのやりとりは必要ありません。 |

## Sample Application
## Sample Implementation

Server-only のインテグレーションの場合は、サンプルアプリケーションをがあります。参照してください:

- [Server-Side UID2 Integration Example (sample application)](https://secure-signals-srvonly-integ.uidapi.com/)
- [Server-Side UID2 Integration Example (readme)](https://github.com/IABTechLab/uid2-examples/blob/main/publisher/server_only/README.md)
- [Client-Server UID2 Integration Example (sample implementation)](https://secure-signals-srvonly-integ.uidapi.com/)
- [Client-Server UID2 Integration Example (readme)](https://github.com/IABTechLab/uid2-examples/blob/main/publisher/server_only/README.md)

## FAQs

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Prebid.js を UID2 ID モジュールと一緒に使用しているや、UID2
- [Client-Side Integration Guide for JavaScript](../guides/integration-javascript-client-side.md)
- [Client-Server Integration Guide for JavaScript](../guides/integration-javascript-client-server.md)

## Sample Implementation Website
## Sample Implementation

アプリケーションのサンプルと関連文書については、以下を参照してください:
- SDK v3を使用したUID2 Google Secure Signals のサンプル:
Expand Down
Loading