HoloStep Developer Docs

Appearance

Google Ads Conversion Tracking ​

Track HoloStep 3D viewer interactions as Google Ads conversions to measure the impact of your ad campaigns on product engagement.

Overview ​

HoloStep can send conversion events to Google Ads when users interact with your 3D product viewers. This helps you:

  • Measure ad effectiveness - See which campaigns drive 3D viewer engagement
  • Optimize bidding - Use conversion data for Smart Bidding strategies
  • Track the full funnel - From ad click to 3D interaction to purchase

Supported Conversion Events ​

EventDescription
3D Viewer OpenUser opens the 3D product viewer
AR Mode OpenUser launches augmented reality mode
Add to CartUser adds product to cart from 3D viewer
PurchaseUser completes a purchase

Prerequisites ​

Before you begin, make sure you have:

  • A Google Ads account with admin access
  • A HoloStep account with an active subscription
  • Access to your website's Google Tag Manager (recommended) or ability to add scripts

Step 1: Create Conversion Actions in Google Ads ​

First, you need to create conversion actions for each event you want to track.

1.1 Open Google Ads Conversions ​

  1. Sign in to your Google Ads account
  2. Click the Goals icon (🎯) in the left menu
  3. Click Conversions in the dropdown
  4. Click Summary

1.2 Create a New Conversion Action ​

  1. Click the + New conversion action button
  2. Select Website as the conversion source
  3. Enter your website URL and click Scan

1.3 Configure the Conversion ​

  1. Click + Add a conversion action manually
  2. Fill in the conversion details:
FieldRecommended Value
Goal and action optimizationSelect based on event type (e.g., "Add to cart" for cart events)
Conversion nameUse a clear name like "HoloStep 3D Viewer Open"
ValueChoose "Use different values for each conversion" or set a fixed value
CountSelect "One" for engagement events, "Every" for purchases
  1. Click Done, then Save and continue

1.4 Get Your Conversion ID and Label ​

After creating the conversion action:

  1. Click See event snippet or Use Google Tag Manager
  2. Note down your:
    • Conversion ID (format: AW-123456789)
    • Conversion Label (format: AbCdEfGhIjK)

TIP

Create separate conversion actions for each HoloStep event you want to track (3D Open, AR Open, Add to Cart, Purchase). Each will have its own unique Conversion Label.

Step 2: Configure HoloStep Integration ​

2.1 Open Integration Settings ​

  1. Log in to your HoloStep Dashboard
  2. Go to Settings → Integrations
  3. Click Add Integration

2.2 Select Google Ads ​

  1. Choose Google Ads from the integration type list
  2. Enter a name for this integration (e.g., "Production Google Ads")

2.3 Enter Your Credentials ​

FieldValue
Conversion IDYour Google Ads Conversion ID (e.g., AW-123456789)
3D Viewer Open LabelConversion label for 3D viewer opens
AR Mode Open LabelConversion label for AR mode opens
Add to Cart LabelConversion label for add to cart events
Purchase LabelConversion label for purchase events
CurrencyYour default currency code (e.g., USD, EUR, HUF)

WARNING

You must configure at least one conversion label. Leave fields empty for events you don't want to track.

2.4 Save and Validate ​

  1. Click Create Integration
  2. Click Validate Connection to verify your setup
  3. Toggle the integration ON to start tracking

Step 3: Verify Your Setup ​

Using Google Tag Assistant ​

  1. Install the Google Tag Assistant Chrome extension
  2. Visit your website with HoloStep embedded
  3. Open the 3D viewer
  4. Check Tag Assistant for fired conversion tags

Using Google Ads Reports ​

  1. Go to Google Ads → Goals → Conversions → Summary
  2. Look for your HoloStep conversion actions
  3. Conversions should appear within 24-48 hours

TIP

Use Google Ads' Conversion tracking status to check if conversions are being recorded. It may take a few hours for the first conversions to appear.

Optional: Google Tag Manager Setup ​

If you're using Google Tag Manager and want more control over when conversions fire, you can set up custom triggers.

GTM Conversion Linker ​

Make sure you have a Conversion Linker tag firing on all pages:

  1. In GTM, go to Tags → New
  2. Choose Conversion Linker
  3. Set trigger to All Pages
  4. Save and publish

Custom Triggers for HoloStep Events ​

HoloStep pushes events to the dataLayer. You can create triggers based on these:

javascript
// Events pushed by HoloStep
dataLayer.push({
  event: 'holostep_event',
  holostep_event_name: 'holostep_3d_open',
  holostep_action: 'viewer_open',
  holostep_scene_id: '12345',
  holostep_scene_name: 'Product Name'
});

Create a custom trigger:

  1. Go to Triggers → New
  2. Choose Custom Event
  3. Event name: holostep_event
  4. Add conditions to filter by holostep_action

Troubleshooting ​

Conversions Not Appearing ​

IssueSolution
No conversions in Google AdsWait 24-48 hours; check that the integration is enabled
Conversion ID errorVerify format is AW- followed by 9-11 digits
Label format errorLabels should be 5-30 alphanumeric characters

Testing Tips ​

  1. Use Preview Mode: Test in HoloStep preview mode first
  2. Check Browser Console: Look for [HoloStep] Google Ads initialized message
  3. Network Tab: Filter for google to see gtag requests

Common Issues ​

Conversion shows "No recent conversions"

This is normal for new conversion actions. Google Ads needs time to process data. If it persists after 48 hours, verify your Conversion ID and Labels are correct.

Integration validation fails

Double-check your Conversion ID format. It should start with AW- followed by numbers (e.g., AW-123456789).

Duplicate conversions

Ensure you haven't added the same conversion tracking via another method (e.g., directly in GTM). HoloStep handles tracking automatically.