diff --git a/docs/getting-started/gs-normalization-encoding.md b/docs/getting-started/gs-normalization-encoding.md index 1df8f0a78..d27a74c68 100644 --- a/docs/getting-started/gs-normalization-encoding.md +++ b/docs/getting-started/gs-normalization-encoding.md @@ -60,7 +60,7 @@ An email hash is a Base64-encoded SHA-256 hashing methodology, or supply an SHA-256 hashed version of the email directly into the LiveRamp Library. + +You must use the SHA-256 hashing methodology, which is supported by both UID2 and LiveRamp. Using any other hashing methodology, or missing any step, results in either no UID2 token added to the ATS envelope or an invalid token added. + +For details, see [Normalization and Encoding](../getting-started/gs-normalization-encoding.md). + +## Set Envelope Refresh to 1800 Seconds + +When enabling ATS within `Prebid.js`, make sure that `storage.refreshInSeconds` is set to **1800 seconds** (30 minutes). To avoid sending expired envelopes into the bidstream, or passing envelopes where an opt-out has occurred, LiveRamp checks for a new ATS envelope (containing the UID2) every 30 minutes. + +## Troubleshooting Assistance + +For more information, or LiveRamp troubleshooting assistance, check the [LiveRamp support page](https://docs.liveramp.com/connect/en/support.html) for help resources or contact your LiveRamp representative. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md new file mode 100644 index 000000000..c4e7723f4 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/guides/integration-liveramp-tips.md @@ -0,0 +1,40 @@ +--- +title: LiveRamp Integration Tips +sidebar_label: LiveRamp Integration Tips +pagination_label: LiveRamp Integration Tips +description: Tips for integrating with UID2 with LiveRamp. +hide_table_of_contents: false +sidebar_position: 04 +--- + +import Link from '@docusaurus/Link'; + +# LiveRamp Integration Tips + +Publishers already using LiveRamp Authenticated Traffic Solution (ATS) can leverage their integration to generate a UID2 token to be passed in the bid request. + +If you want to generate UID2 tokens using LiveRamp ATS, reach out to your LiveRamp representative and also make sure you've addressed the following integration points: + +- [Enable RideAlong](#enable-ridealong) +- [Implement the Correct Hashing Methodology](#implement-the-correct-hashing-methodology) +- [Set Envelope Refresh to 1800 Seconds](#set-envelope-refresh-to-1800-seconds) + +## Enable RideAlong + +In your LiveRamp configuration, you must make sure that RideAlong is enabled. RideAlong is a LiveRamp feature that enables other identity solutions, such as UID2, to embed their identifiers in ATS envelopes. If RideAlong is not enabled, UID2 tokens will not be appended to the envelope. + +To complete this step, contact your LiveRamp representative. + +## Implement the Correct Hashing Methodology + +The hashing methodology used by the UID2 service is very specific. If you use a different hashing algorithm, or miss any of the steps, your UID2s will not be correctly generated. + +For information about the required hashing methodology, see [Normalization and Encoding](../getting-started/gs-normalization-encoding.md). + +## Set Envelope Refresh to 1800 Seconds + +When enabling `ATS.js` within `Prebid.js`, make sure that `storage.refreshInSeconds` is set to **1800 seconds** (30 minutes). + +## Troubleshooting Assistance + +For more information, or LiveRamp troubleshooting assistance, check the [LiveRamp support page](https://docs.liveramp.com/connect/en/support.html) for help resources or contact your LiveRamp representative. diff --git a/sidebars.js b/sidebars.js index 088bdfea2..aed16af58 100644 --- a/sidebars.js +++ b/sidebars.js @@ -176,7 +176,11 @@ const fullSidebar = [ 'guides/mobile-plugin-ima-ios', ], }, - ], + + + 'guides/integration-liveramp-tips', + + ], }, {