AdWords Destination

Segment makes it easy to send your data to AdWords (and lots of other destinations). Once you've tracked your data through our open source libraries we'll translate and route your data to AdWords in the format they understand. Learn more about how to use AdWords with Segment.

Our Google AdWords destination code is open-source on GitHub if you want to check it out. Our clientside javascript destination..

Getting Started

With Segment your events can be used to fire an AdWords conversion pixel from your website in client-side javascript. It can also be used to trigger AdWords conversion from your mobile app via Server to Server destination so you don’t have to include the SDK in your app. Make sure when you’re setting up your Adwords conversions that you choose the appropriate tracking method.

From your Segment Destinations Catalog click on AdWords. You’ll need to enter your Conversion Id from your AdWords account first. Next, enter the name of the event exactly as it appears in your track call on the left and map it to your Adwords conversion’s google_conversion_label on the right.

Conversion ID

To find a conversion ID look inside of your AdWords account and navigate to Tools -> Conversions, then click the red +Conversion button. You’ll be prompted to choose what types of conversions you’d like to track. For the purposes of integrating with Segment, you’ll choose either “Website” or “App”.

If you select “Website,” click through to the “Review and Install” step in the AdWords dashboard. Scroll down to the “Install your tag” section and look for w.google_conversion_id. Copy the string directly to the right of it, and paste it into the AdWords section of your Segment destination tab.

If you select “App,” you can choose to track conversions from Firebase, Google Play, or first opens and in-app actions. For more on setting up moble tracking, see Server to Server Destination for Mobile Apps further down on this page.

Track

Conversion Value

If you want to pass a value along with the conversion event include an event property labeled revenue, like this:

analytics.track('Order Completed', { revenue: 33 });

Dynamic Remarketing Tags

If you enable Send Additional Remarketing Tags in your settings, we will send dynamic remarketing tags (in addition to any conversion tags) with whatever properties you have sent with your .page() or .track() calls. We will only send remarketing tags for events you have mapped with conversion labels. You can use these properties in your Adwords account to create audiences to remarket to!

If you’d like to only send a Dynamic Remarketing Tags, you can whitelist the names of your Segment .track() events under the Send Standalone Remarketing Tags setting and we will send a remarketing tag for this event with its properties without sending a conversion tag.


Server to Server Destination for Mobile Apps

You can specify your key mobile events as conversion events inside of Google AdWords conversion dashboard. When these events fire from your mobile apps, we’ll trigger these AdWords conversions. Our SDKs should include the following properties, which are required to send the conversions. If you notice these properties aren’t being logged, you will want to check your debugger to ensure the properties are in fact included in your events.

labelYour Advertising Label from the destination settings panel
rdidcontext.device.advertisingId
bundleidcontext.app.namespace
appversioncontext.app.version
osversioncontext.os.version
sdkversioncontext.app.build

The following properties are optional, if you’d like to see more, please get in touch with us.

referrercontext.referrer.id
valueproperties.revenue
currency_codeproperties.currency

Here’s Google documentation for the endpoint we hit for iOS apps and for Android Apps. It can take 24-48 hours for conversions to show up in the conversions dashboard.

Troubleshooting

Testing Conversion Pixels

To test Google AdWords conversion tracking you’ll have to click through one of your existing ads.

Keep in mind that the conversion data must be processed by Google before it shows up in your AdWords reporting, which can take up to 24 hours.

Inconsistent Conversions

The most common reason for AdWords conversion pixels to fire inconsistently is that the page redirects or reloads before the pixel has time to be loaded on the page. Make sure your page does not redirect or reload for at least 300ms after the conversion event happens.

We recommend using our trackLink or trackForm helpers to delay the page redirect. Documentation here.


Supported Sources and Connection Modes

WebMobileServer
📱 Device-based
☁️ Cloud-based

To learn more about about Connection Modes and what dictates which we support, see here.

Settings

Segment lets you change these destination settings via your Segment dashboard without having to touch any code.

Conversion ID

Your AdWords conversion identifier. It looks like 983265867.

Labels

AdWords recognizes labels, not custom events. When you analytics.track(event, properties) an event that represents an AdWords conversion, you’ll need to map the event name on the left to it’s corresponding AdWords label on the right.

Send Additional Remarketing Tags

If you enable this, we will send an additional remarketing tag for each of your conversion labels above and every .page() call!

Send Standalone Remarketing Tags

If you’d like to send standalone remarketing tags, you can whitelist your Segment Events here and we will send a remarketing tag for these events. If you already mapped an event as a conversion label above and have checked the option to send additional remarkeeting tags, you do not need to whitelist the event again.


If you have any questions or see anywhere we can improve our documentation, please let us know or kick off a conversation in the Segment Community!