---
updatedAt: 2026-04-07T10:11:12.000Z
agentTools:
  siteIndex: https://developers.liveramp.com/llms.txt
  projectIndex: https://developers.liveramp.com/authenticatedtraffic-api/v1.0/llms.txt
---

# The ats.js Quickstart Guide

The fastest way to start with the Authenticated Traffic Solution!

[block:callout]
{
  "type": "danger",
  "body": "We are focusing our future development on version 2.0 of ATS.js. To make sure you continue to be able to use ATS, please transition to version 2 as soon as possible. We know this can be a hassle, and we apologize for the inconvenience. See [Migrate to Version 2 of ATS.js](https://docs.liveramp.com/privacy-manager/en/migrate-to-version-2-of-ats-js.html) to learn more or talk to one of our [representatives](mailto:atsimplementation@liveramp.com).",
  "title": "This Version of ATS.js is Going to be Deprecated"
}
[/block]

The *ats.js Quick Start Guide* provides quick instructions to help you quickly take full advantage of the Authenticated Traffic Solution (ATS).

[block:callout]
{
  "type": "info",
  "title": "Implement ATS via Console",
  "body": "The LiveRamp Publisher Console provides an easy-to-use wizard for ATS implementation. Rather than make requests to support or tinker with ATS Javascript directly, use the Console to easily make your desired selections and updates with confidence.\n\nSee \"[Implement ATS via Console](https://docs.liveramp.com/privacy-manager/en/implement-ats-via-console.html)\" for more information."
}
[/block]

The easiest way to use ats.js is with [Prebid.js](http://prebid.org/).

This guide walks you through the following tasks:

* Update Prebid.js
* Add ats.js
* Test your installations

[block:api-header]
{
  "title": "1. Update Prebid.js"
}
[/block]

1. Visit the [Prebid download page](https://docs.prebid.org/download.html) and select the following:

* The latest version of Prebid
* Adapters that support IdentityLink (such as OpenX, Triplelift or Pubmatic)
* The `User ID: IdentityLink ID` module. If you will be processing traffic from the EU/EEA, include `Consent Management - GDPR`. We recommend, but do not require, that you include `Publisher Common ID` to provide first-party device identifiers to demand.

2. Download the newly-compiled prebid.js and replace the old copy.
3. Update the prebid configuration information.

[block:code]
{
  "codes": [
    {
      "code": "pbjs.setConfig({\n    userSync: {\n        userIds: [{\n            name: \"identityLink\",\n            params: {\n                pid: 'REPLACE_ME'             // Set your real identityLink placement ID here\n            },\n            storage: {\n                type: \"cookie\",\n                name: \"idl_env\",       // create a cookie with this name\n                expires: 7            // cookie can last for seven days\n            }\n        }],\n        syncDelay: 3000              // 3 seconds after the first auction\n    }\n});",
      "language": "javascript",
      "name": "Passing IdentityLink Module Configuration"
    }
  ]
}
[/block]

4. Update the adapter parameters if you're adding new partners.

[block:api-header]
{
  "title": "2. Add ats.js"
}
[/block]

Add the following tags for ATS at the end of the `<body>` tag to include and start the library on your site.

[block:code]
{
  "codes": [
    {
      "code": "<script>\nvar atsScript = document.createElement('script');\natsScript.onload = function() {\n  window.ats.start({\n    \"placementID\": REPLACE_ME,\n    \"storageType\": \"localStorage\",\n    \"detectionType\": \"scrapeAndUrl\",\n    \"urlParameter\": \"env\",\n    \"cssSelectors\": [\n      \"input[type=text]\",\n      \"input[type=email]\"\n    ],\n    \"logging\": \"error\"\n  });\n};\natsScript.src = 'https://ats.rlcdn.com/ats.js';\ndocument.body.appendChild(atsScript);\n</script>",
      "language": "html",
      "name": "Configured ats.js"
    }
  ]
}
[/block]

Many more [configuration options](https://docs.authenticated-traffic-solution.com/docs/atsjs-configuration-options) are available and it's recommended to [directly pass user identifiers](https://docs.authenticated-traffic-solution.com/docs/atsjs-configuration-options#section-direct) when possible.

[block:api-header]
{
  "title": "3. Test Your Install End-to-End"
}
[/block]

### Check that ats.js is working

After entering a supported identifier, see if ATS resolved it to an envelope by opening the developer console and running `window.ats.retrieveEnvelope();`. If an envelope string value is returned, then ats.js is working.

### Check that prebid.js is working

* Reload a prebid-enabled page on your site.
* Open the developer console and enter `pbjs.getUserIds();` to ensure that Prebid returns a LiveRamp identity envelope.
* Switch to the "Network" tab and see if the envelopes are being pushed to SSPs in ad calls. Pubmatic's `POST` to `https://hbopenbid.pubmatic.com/translator?source=prebid-client`, for example, is easy to check, looking for something like the below screenshot:

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/f46b1a7-image_2.png",
        "image (2).png",
        1520,
        402,
        "#515050"
      ]
    }
  ]
}
[/block]

[block:callout]
{
  "type": "success",
  "title": "Congratulations!",
  "body": "You're now taking full advantage of the Authenticated Traffic Solution!"
}
[/block]