-
Notifications
You must be signed in to change notification settings - Fork 352
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Google Campaign Manager 360 destination docs. #7121
base: develop
Are you sure you want to change the base?
Changes from all commits
a1e384f
c079860
af34a0a
e45e248
bf871c2
4087184
1f50ee1
b254cdf
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,106 @@ | ||
--- | ||
title: Google Campaign Manager 360 | ||
strat: google | ||
hide-boilerplate: true | ||
hide-dossier: false | ||
id: 66e97a37a8f396642c0bd33c | ||
hidden: true | ||
private: true | ||
versions: | ||
- name: "Google Campaign Manager 360" | ||
link: '/docs/connections/destinations/catalog/actions-google-campaign-manager-360/' | ||
--- | ||
|
||
The Google Campaign Manager 360 destination allows users to upload [conversions](https://developers.google.com/doubleclick-advertisers/guides/conversions_upload){:target="_blank"} and [conversion enhancements](https://developers.google.com/doubleclick-advertisers/guides/conversions_ec){:target="_blank"} to Google Campaign Manager 360. Marketers can use this integration to attribute conversions to specific campaigns, ad groups, and ads. | ||
|
||
## Getting Started | ||
|
||
> info "" | ||
> You can connect the Google Campaign Manager 360 Destination to an event source, Reverse ETL source, or Engage space. | ||
|
||
### Prerequisites | ||
|
||
Before you begin, you need to have a Google Campaign Manager 360 account, with a Profile ID and a Floodlight Configuration ID. These are necessary to configure the Floodlight activities you want to track. | ||
|
||
### Connect to Google Campaign Manager 360 | ||
|
||
1. From the Segment web app, navigate to **Catalog > Destinations**. | ||
2. Search for “Google Campaign Manager 360” in the Destinations Catalog, and select it. | ||
3. Click **Add destination**. | ||
4. Select the source that will send data to Google Campaign Manager 360. | ||
* If you select an Engage space, you'll be redirected to Engage to complete the following steps. | ||
* If you select a Reverse ETL source, you must enter a name for your destination and click **Create destination**. | ||
5. On the **Settings** tab for your Google Campaign Manager destination: | ||
* Enter your **Profile ID**. Optionally, you can also provide your default **Floodlight Configuration ID** and/or your default **Floodlight Activity ID**. These fields are optional, but if you provide them, they will be used as defaults for all events sent to Google Campaign Manager 360. Otherwise, you can override these values in your mappings. | ||
6. Click **Save**. | ||
7. Follow the steps in the Destinations Actions documentation to [customize your mappings](/docs/connections/destinations/actions/#customize-mappings). | ||
|
||
## Available actions | ||
|
||
The Google Campaign Manager 360 Action Destination supports the following actions: | ||
|
||
* [Conversion Upload](#conversion-upload) | ||
* [Conversion Adjustment Upload](#conversion-adjustment-upload) | ||
|
||
### Conversion Upload | ||
|
||
The Conversion Upload action allows you to send conversion data to Google Campaign Manager 360. This action is useful for tracking conversions that occur on your website or app. | ||
|
||
#### Fields | ||
|
||
The Google Campaign Manager 360 destination requires the following fields for the Conversion Upload action: | ||
|
||
* **Required ID**: The identifier that identifies a user for the conversion. Only one value at a time can be provided from the following fields: | ||
* Google Click ID (gclid); | ||
* Display Click ID (dclid); | ||
* Encrypted User ID; | ||
* Mobile Device ID; | ||
* Match ID; | ||
* Impression ID; | ||
* Encrypted User ID Candidates; | ||
* **Timestamp**: The time the conversion occurred. | ||
* **Value**: The value of the conversion. | ||
* **Ordinal**: The ordinal of the conversion. This field is used to control how conversions of the same user and day are de-duplicated. | ||
|
||
### Conversion Adjustment Upload | ||
|
||
The Conversion Adjustment Upload action allows you to send conversion adjustment data to Google Campaign Manager 360. This action is useful for adjustments to conversions that have already been uploaded, as well as enhancing conversions. | ||
|
||
#### Fields | ||
|
||
The Google Campaign Manager 360 destination requires the following fields for the Conversion Adjustment Upload action: | ||
|
||
* **Required ID**: The identifier that identifies a user for the conversion. Only one value at a time can be provided, from the following fields: | ||
* Google Click ID (gclid); | ||
* Display Click ID (dclid); | ||
* Encrypted User ID; | ||
* Mobile Device ID; | ||
* Match ID; | ||
* Impression ID; | ||
Comment on lines
+74
to
+79
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @seg-leonelsanches is it necessary to include all of these? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Hi @stayseesong 👋 They are part of one field called "Required ID". Only one of them can be provided for each mapping. |
||
* **Timestamp**: The time the conversion occurred. | ||
* **Value**: The value of the conversion. | ||
* **Ordinal**: The ordinal of the conversion. This field is used to control how conversions of the same user and day are de-duplicated. | ||
|
||
## Hashing | ||
|
||
Google requires you to hash all PII before sending it to the Google API. | ||
|
||
The Google Campaign Manager 360 destination supports hashing for the following fields: | ||
|
||
* Phone | ||
* First Name | ||
* Last Name | ||
* Street Address | ||
|
||
The hashing algorithm used is SHA-256. If incoming data arrives already hashed, the destination will not hash it again. The values will be sent as-is to Google. | ||
|
||
{% include components/actions-fields.html settings="true"%} | ||
|
||
## FAQ and troubleshooting | ||
|
||
### Refreshing access tokens | ||
|
||
When you use OAuth to authenticate into the Google Campaign Manager 360 destination, Segment stores an access token and refresh token. Access tokens for Google Campaign Manager 360 expire after one hour. Once expired, Segment receives an error and then uses the refresh token to fetch a new access token. This results in two API requests to Google Campaign Manager 360, one failure and one success. | ||
|
||
Because of the duplicate API requests, you may see a warning in Google for unprocessed conversions due to incorrect or missing OAuth credentials. This warning is expected and does not indicate data loss. Google has confirmed that conversions are being processed, and OAuth retry behavior will not cause any issues for your web conversions. Whenever possible, Segment caches access tokens to reduce the total number of requests made to Google Campaign Manager 360. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@seg-leonelsanches is it necessary to include all of these fields?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi @stayseesong 👋
They are part of one field called "Required ID". Only one of them can be provided for each mapping.