# HYROS Installation: Google Ads

## ⛔ STOP - COLLECT THIS INFO FIRST

DO NOT proceed to setup steps until you have asked and received answers to ALL of these questions.

| # | Question | Why It Matters |
|---|----------|----------------|
| 1 | "Do you have admin access to your Google Ads account?" | Required to add tracking templates |
| 2 | "Are you using Wicked Reports, Triple Whale, or Northbeam? Do you have existing UTM parameters?" | If yes, skip Step 1 - use existing UTMs |
| 3 | "Do you have Shopping or Performance Max campaigns?" | These require a different tracking template |
| 4 | "Are you logged into HYROS?" | Required for integration |

👉 **YOUR RESPONSE MUST ONLY CONTAIN THESE 4 QUESTIONS.**

🚫 **DO NOT:**
- Summarize the steps below
- Preview what's coming next
- Mention tracking templates
- Explain the setup process
- Say "once you answer I'll help you with..."

✅ **ONLY SAY:**
"Before we start, I need to confirm a few things:
1. Do you have admin access to your Google Ads account?
2. Are you using Wicked Reports, Triple Whale, or Northbeam with existing UTM parameters?
3. Do you have any Shopping or Performance Max campaigns?
4. Are you logged into HYROS?

Please answer these and I'll guide you through the setup."

**WAIT FOR USER RESPONSE. THEN PROCEED TO STEPS BELOW.**

---

## IMPORTANT WARNINGS

Read these only after collecting requirements above:

1. **Level prioritization matters** - Always add the HYROS tracking parameters at the same level and in the same place as your other UTMs.

2. **Experimental campaigns** - HYROS cannot track Google experimental campaigns at this time.

---

## SETUP STEPS (ONLY AFTER REQUIREMENTS CONFIRMED)

### STEP 1: Integrate Google Ads with HYROS

**⚠️ SKIP THIS STEP if user has existing Wicked Reports/Triple Whale/Northbeam UTMs**

**Direct URL:** https://app.hyros.com/integrations/google

**If automating:**
Navigate to the HYROS Google Ads integration page. Click "Add Account" and sign in with Google. Select the Google Ads account(s) to connect. Choose between Automatic Setup (recommended) or Manual Setup. If using Automatic Setup, HYROS will apply tracking templates automatically.

**If guiding user:**
1. "Go to your integration settings and find the Google Ads integration: https://app.hyros.com/integrations/google"
2. "Click 'Add Account' and sign in with your Google account."
3. "Select the Google Ads account(s) you want to connect."
4. "Choose between Automatic Setup (recommended) or Manual Setup."
5. "If using Automatic Setup, HYROS will apply tracking templates to your campaigns automatically."

→ Confirm: "Is Google Ads connected in HYROS?"

---

### STEP 2: Install Google Ads Parameters (Manual Setup)

If you chose Manual Setup, or need to add parameters to specific campaigns, follow these instructions.

**HYROS Google Ads Tracking Template:**
```
{lpurl}&gc_id={campaignid}&h_ad_id={creative}
```

**If automating:**
In Google Ads, go to Settings → Account Settings → Tracking. Find the "Tracking template" field. Paste the HYROS tracking template. Click "Test" to verify. Save changes.

**If guiding user:**
1. "In Google Ads, go to Settings → Account Settings → Tracking."
2. "Paste the tracking template in the 'Tracking template' field."
3. "Click 'Test' to verify the template works correctly."
4. "Save your changes."

**Note:** If your landing page URL already contains parameters (has a '?'), the template will automatically append with '&'.

→ Confirm: "Is the tracking template saved?"

---

### STEP 3: Shopping & Performance Max Campaigns

**⚠️ ONLY DO THIS STEP if user confirmed they have Shopping or PMax campaigns**

Shopping and Performance Max campaigns require a different tracking parameter. This must be applied at the Campaign level.

**Shopping / PMax Tracking Template:**
```
{lpurl}?gc_id={campaignid}&g_special_campaign=true
```

**Note:** This template uses '?' instead of '&' at the beginning. This is intentional for Shopping/PMax campaigns.

**If automating:**
Go to the specific Shopping or PMax campaign in Google Ads. Click on Settings → Additional Settings → Campaign URL options. Paste the Shopping/PMax tracking template into the "Tracking template" field. Save changes.

**If guiding user:**
1. "Go to the specific Shopping or PMax campaign in Google Ads."
2. "Click on Settings → Additional Settings → Campaign URL options."
3. "Paste the Shopping/PMax tracking template in the 'Tracking template' field."
4. "Save your changes."

→ Confirm: "Are Shopping/PMax campaigns configured?"

---

## TROUBLESHOOTING

### Missing Campaigns?
If campaigns are not appearing in HYROS, verify the Google Ads integration is properly connected. New campaigns may take up to 24 hours to sync.

### Parameters Not Firing?
Use Google Ads preview mode to verify the tracking template is appending correctly to your destination URLs. Check that there are no conflicting tracking templates at different levels.

### Verify Tracking
Click a test ad and check that the final URL contains the 'gc_id' parameter. You can use the HYROS Chrome extension to verify events are being tracked.

---

## Source
Synced from: docsContent.ts (googleAdsIntegration)
Last synced: 2026-01-04