Implementing the Addressability Extension Website Tag
To utilize the site traffic from your website in Addressability Extension, we need you to deploy a tag onto your website. The Addressability Extension Website Tag is a line of JavaScript that transfers pseudonymized data to LiveRamp’s system in the form of a hashed email address/cookie ID linkage. It should be placed on your website and called wherever a user’s email addresses can be populated.
To implement:
Deploy the tag.
Test your hash function.
Test the tag.
Once your LiveRamp representative has provided you with your tag ID, add the tag below to all website pages where a user’s email addresses can be populated. These might include the following types of locations:
Post-registration pages
Post-login pages
Returning-user pages
Tag:
<script src="https://pippio.com/api/sync?pid={TAG_ID}&it=4&iv={MD5}&it=4&iv={SHA1}&it=4&iv={SHA256}" async></script>
Note
It is not important where on the page the javascript is placed. Generally, it is added to the universal footer or into a tag manager, such as Google Tag Manager.
Caution
Remove all brackets ("{" and "}") from the tag before deploying it into your QA or production environments.
A populated pixel might look like this:
<script src="https://pippio.com/api/sync?pid=2228&it=4&iv=3cb7232fcc48743000cb86d0d5022bd9&it=4&iv=790d12777b2a83253a14c748a1b1cb09b3a91cca&it=4&iv=899d3387a5c5a7555d51d2f0a0b7b50e397fe481fd9a58fafb389b7dc94e11f6" async></script>
Here are the macro values you will populate:
{TAG_ID} is your tag ID. Replace this with the tag ID provided by LiveRamp. Email clientmatch@liveramp.com if you are unsure of your tag ID.
{MD5}, {SHA1}, and {SHA256} are the three email hash types we accept. You must replace all three values with the respective hashes of the email address. To maximize addressability and, therefore, match rates and reach, include all three hash types.
Ensure all email addresses meet the requirements below:
The hash input is a valid, non-empty email address.
The email address is lowercased.
Any whitespace or extra text is removed from the beginning and end of the email address.
The email address is hashed via the appropriate function and produces the hexadecimal digest.
Caution
For privacy reasons, LiveRamp does not accept raw (plaintext) email addresses from Addressability Extension partners.
Once you have verified your hashes, test your implementation either on a staging site or “in the wild”. Use the steps below to conduct your audit.
Open an incognito window in Chrome and navigate to a URL where the pixel has been placed.
Open Chrome developer tools. In the ‘network’ tab check off "preserve log”.
Click through until you’ve submitted a test email.
Search for ‘pippio.com’ and/or your tag ID (listed as “PID number”) in the ‘network’ tab filter.
Confirm the items below from your test:
The pippio.com javascript tag is firing successfully with status 200 or 204.
The PID (tag ID) is correct.
The hashes are correct, lowercased, and trimmed.