Skip to content

Commit 11fd6d6

Browse files
author
markzegarelli
authored
Update verbiage, address vale concerns (#4337)
1 parent 16cbfed commit 11fd6d6

File tree

2 files changed

+23
-22
lines changed
  • .github/styles/Vocab/Docs
  • src/connections/destinations/catalog/google-ads-classic

2 files changed

+23
-22
lines changed

.github/styles/Vocab/Docs/accept.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -151,4 +151,5 @@ Wisepops
151151
Woopra
152152
Wootric
153153
Xcode
154-
Zendesk
154+
Zendesk
155+
remarket

src/connections/destinations/catalog/google-ads-classic/index.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ With the release of Segment's latest Analytics-iOS SDK, which includes support f
3333

3434
Google Adwords maps the IDFA to `rdid`, and returns a 4xx error on the outbound request if no `device.advertisingId` key appears in the payload.
3535

36-
To work around this, enable the **Fallback to Zeroed IDFA when advertisingId key not present** destination setting for Google Adwords in the Segment web app. When enabled, Segment checks if a `device.advertisingId` exists in the payload, and if none exists, sets the `rdid` to `'00000000-0000-0000-0000-000000000000'`.
36+
To work around this, enable the **Fallback to Zeroed IDFA when `advertisingId` key not present** destination setting for Google Adwords in the Segment web app. When enabled, Segment checks if a `device.advertisingId` exists in the payload, and if none exists, sets the `rdid` to `'00000000-0000-0000-0000-000000000000'`.
3737

3838
To maintain backwards compatibility, if you do not enable this setting and no `device.advertisingId` key appears in the payload, Segment rejects the message.
3939

@@ -95,7 +95,7 @@ Google has replaced the concept of associating conversion events with **conversi
9595
The API has a new concept of **event types**. Each of these types are meant to be associated with common in-app actions that a user could take (app installs, product views, etc.). This is the same concept as the [Semantic Event Spec](/docs/connections/spec/semantic/). The event type mappings Segment supports are outlined in the sections below.
9696

9797
> warning ""
98-
> If you have migrated from a legacy AdWords account to a new one, Google Ads (Classic) will automatically migrate your existing conversion events to your new account. Segment will continue to respect these event mappings even if they share the same event names as the new "spec'd" event mappings outlined below and ignore the new **event type** mapping. This is to ensure there is no disruption in your data. If you wish to bypass this, you simply need to delete the event mapping in your [settings](/docs/connections/destinations/catalog/google-ads-classic/#event-mappings).
98+
> If you have migrated from a legacy AdWords account to a new one, Google Ads (Classic) will automatically migrate your existing conversion events to your new account. Segment will continue to respect these event mappings even if they share the same event names as the new spec-matching event mappings outlined below and ignore the new **event type** mapping. This is to ensure there is no disruption in your data. If you wish to bypass this, you simply need to delete the event mapping in your [settings](/docs/connections/destinations/catalog/google-ads-classic/#event-mappings).
9999
100100
1) Authorization/Authentication
101101

@@ -122,15 +122,15 @@ Once you have a Link ID, you need to add them to your Google Ads (Classic) [dest
122122
### Track
123123
All `track` events are by default sent to your Google Ads (Classic) account and from there, you can choose which ones you want to designate as **Conversion Events**. All events sent to Google Ads (Classic) require an **event type** specification. This is an enumerated list of nine potential values:
124124

125-
1. first_open
126-
2. session_start
127-
3. in_app_purchase
128-
4. view_item_list
129-
5. view_item
130-
6. view_search_results
131-
7. add_to_cart
132-
8. ecommerce_purchase
133-
9. custom
125+
1. `first_open`
126+
2. `session_start`
127+
3. `in_app_purchase`
128+
4. `view_item_list`
129+
5. `view_item`
130+
6. `view_search_results`
131+
7. `add_to_cart`
132+
8. `ecommerce_purchase`
133+
9. `custom`
134134

135135
Segment integrates with these event types using the use of the [Semantic Event Spec](/docs/connections/spec/semantic/). Each individual mapping Segment supports is documented in the sections below. Any event Segment receives that is not a mapped semantic event will be sent to Google Ads (Classic) as a `custom` event type.
136136

@@ -193,27 +193,27 @@ To track the monetary value of a conversion, make sure your event contains a `.r
193193
## Mobile & Server (Legacy)
194194

195195
> warning ""
196-
> Google Ads (Classic) has plans to deprecate the API that the functionality outlined here relies on. Reference the documentation that supports their new API version above.
196+
> Google Ads (Classic) has plans to deprecate the API on which the functionality outlined below relies. Reference the documentation that supports their new API version above.
197197
198198
You can specify key mobile events as conversion events inside of Google Ads conversion dashboard. When these events fire from your mobile apps, Segment triggers these Google Ads (Classic) conversions. Segment SDKs should include the following properties, which are required to send the conversions. If you notice these properties aren't being logged, check the debugger to ensure the properties are included in your events.
199199

200200

201201
| Property | Mapping |
202202
| ---------- | --------------------------------------------------------- |
203-
| label | The Advertising Label from the destination settings panel |
204-
| rdid | `context.device.advertisingId` |
205-
| bundleid | `context.app.namespace` |
206-
| appversion | `context.app.version` |
207-
| osversion | `context.os.version` |
208-
| sdkversion | `contet.app.build` |
203+
| `label` | The Advertising Label from the destination settings panel |
204+
| `rdid` | `context.device.advertisingId` |
205+
| `bundleid` | `context.app.namespace` |
206+
| `appversion` | `context.app.version` |
207+
| `osversion` | `context.os.version` |
208+
| `sdkversion` | `contet.app.build` |
209209

210210
The following properties are optional, if you'd like to see more, [contact Segment Support](https://segment.com/help/contact/).
211211

212212
| Property | Mapping |
213213
| ------------- | --------------------- |
214-
| referrer | `context.referrer.id` |
215-
| value | `properties.revenue` |
216-
| currency_code | `properties.currency` |
214+
| `referrer` | `context.referrer.id` |
215+
| `value` | `properties.revenue` |
216+
| `currency_code` | `properties.currency` |
217217

218218

219219
Here's Google documentation for the endpoint Segment connects to [for iOS apps](https://developers.google.com/app-conversion-tracking/ios/conversion-tracking-server#reporting_in-app_conversions_from_an_analytics_server) and [for Android Apps](https://developers.google.com/app-conversion-tracking/android/conversion-tracking-server#in-app_conversions). It can take 24-48 hours for conversions to show up in the conversions dashboard.

0 commit comments

Comments
 (0)