# HYROS Installation: AdRoll

## TRACKING PARAMETER

Use this parameter for all AdRoll destination URLs:

```
?sl=[ADROLL:CAMPAIGN_NAME]&htrafficsource=AdRoll
```

The [ADROLL:CAMPAIGN_NAME] macro will automatically be replaced with your actual campaign name when the ad is clicked.

---

## STEP 1: Access Your AdRoll Dashboard

**If automating:**
Navigate to the AdRoll platform and find the campaigns section. Look for campaign management or ads area.

**If guiding user:**
1. "Log in to your AdRoll account at adroll.com"
2. "Navigate to Campaigns from the main menu"
3. "Select the campaign you want to add tracking to, or create a new campaign"

→ Confirm: "Are you in your AdRoll campaign settings?"

---

## STEP 2: Locate Your Ad Destination URL

**If automating:**
Within the campaign, find the ad settings. Look for a destination URL, click URL, or landing page URL field.

**If guiding user:**
1. "Within your campaign, click on Ads or Ad Groups"
2. "Select the specific ad you want to edit"
3. "Find the Destination URL or Click URL field"

Note: The destination URL is where users land after clicking your ad.

→ Confirm: "Can you see the destination URL field?"

---

## STEP 3: Add the HYROS Parameter

**If automating:**
Append the tracking parameter to the end of the destination URL. If URL already has parameters (contains ?), use & instead.

**If guiding user:**
"Append the HYROS tracking parameter to the end of your destination URL."

Example - If your current destination URL is:
```
https://yourwebsite.com/landing-page
```

Add the parameter to make it:
```
https://yourwebsite.com/landing-page?sl=[ADROLL:CAMPAIGN_NAME]&htrafficsource=AdRoll
```

**WARNING:** If your URL already has parameters (contains a ?), use & instead of ? before sl=. Example: yoursite.com/page?existing=param&sl=[ADROLL:CAMPAIGN_NAME]&htrafficsource=AdRoll

→ Confirm: "Did you add the parameter to your destination URL?"

---

## STEP 4: Apply to All Ads

**If automating:**
Repeat the parameter addition for every ad in the account that needs tracking.

**If guiding user:**
"Repeat this process for each ad in your AdRoll campaigns:"
1. "Go through each active campaign"
2. "Update every ad destination URL with the HYROS parameter"
3. "Save your changes after updating each ad"

→ Confirm: "Have you updated all your active ads?"

---

## STEP 5: Verify Your Setup

**If automating:**
Test by clicking an ad and checking that the landing page URL contains the sl= parameter. Verify in HYROS that the visit appears.

**If guiding user:**
"Test that your tracking is working correctly:"
1. "Click on one of your live AdRoll ads"
2. "Check that the URL contains the sl= parameter when you land on the page"
3. "Verify in HYROS that the visit is being tracked with the AdRoll source"

Note: It may take a few minutes for data to appear in your HYROS dashboard after clicking an ad.

→ Confirm: "Can you see the AdRoll source in your HYROS reports?"

---

## AVAILABLE ADROLL MACROS

You can use these AdRoll macros in your tracking parameters:
- [ADROLL:CAMPAIGN_NAME] - Returns the campaign name
- [ADROLL:CAMPAIGN_ID] - Returns the campaign ID
- [ADROLL:AD_ID] - Returns the specific ad ID
- [ADROLL:ADGROUP_ID] - Returns the ad group ID

**Advanced Parameter Example:**
```
?sl=[ADROLL:CAMPAIGN_NAME]_[ADROLL:AD_ID]&htrafficsource=AdRoll
```

This advanced setup tracks both campaign name and individual ad ID for more detailed reporting.

---

## Source
Synced from: docsContent.ts (adrollGuide)
Last synced: 2026-01-03