Google Campaign Manager 360 connector reference

This reference explains in detail how to configure the Google Campaign Manager 360 connector.

Prerequisites

Before you complete the procedure in this guide, perform all of the following actions:

• Create a Google Campaign Manager 360 datastream. For more information, see Collecting data from Google Campaign Manager 360.

Limitations

Collecting data from Google Campaign Manager 360 comes with the following limitations:

In some cases, browser settings or application settings may prevent Google Search Ads 360 from directly measuring conversions, and imported goals and transactions. Conversion metrics are scaled when there is enough data to meet accuracy thresholds. When scaling is applied to account for data that cannot be measured due to factors such as browser settings, this may result in fractions, which are then rounded. This rounding may result in discrepancies within data. For more information about discrepancies, see the Google documentation.

Configuring data collection from Google Campaign Manager 360

To configure data collection from Google Campaign Manager 360, follow these steps:

1. Select the workspace you work with in Adverity and then, in the platform navigation menu, click Datastreams.

2. Select the Google Campaign Manager 360 datastream.

3. In the top navigation panel, click Settings.

4. Depending on what you select in Report type, different fields are available. Fill in the following fields:

   Migration Mode

   This field may not be present if you are configuring a recently created datastream. If this field is present, this means the datastream is connected to the older version of the data source called Google Campaign Manager.

   Select Keep field names to retain the legacy field names for an older authorization to Google Campaign Manager. Select Rename fields to update the old field names to the new field names. If you select Rename fields, create a Data Schema for the field name migration. For more information on creating a Data Schema, see Managing Data Schemas.

   Dimension Filters

   Enter a valid JSON expression to collect data for specific dimensions. For more information on the Dimensions Filter, see Configuring the dimension filter with a JSON expression below.

   Reports

   If CUSTOM is selected in the Report Type field, a Reports field is shown, allowing you to select a custom report. A custom report is created in the Google Campaign Manager 360 user interface. For more information, see the Google Documentation.

   Report Specific section

   Depending on the selected Report Type, the Report Specific section displays a set of optional fields to configure.

   For example, select REACH in Report type, and the Report Specific section displays only one field called Reach by Frequency Breakdown.

   Select PATH_TO_CONVERSION in Report type, and the Report Specific section displays many conversion metric fields to configure.

   An alternative option is to create a custom report within Google Campaign Manager 360. Set the Report Type to CUSTOM and select the custom report.

   Advertisers (Activities section)

   Select the GCM Advertisers with floodlight activities from which to collect data. This field is populated with the GCM Advertisers associated with your Google Campaign Manager 360 account that also have at least one floodlight activity. A floodlight activity is a specific conversion you want to track, such as the completion of a purchase or a visit to a page on your site.

5. Click Save.

Configuring the dimension filter with a JSON expression

When configuring a Google Campaign Manager 360 datastream, you can configure a dimension filter for most Datastream Types. Enter a JSON expression into the dimension filter to collect data on certain fields. Use the dimension filter to collect highly-specific data from your data source.

To configure data collection from a datastream, follow these steps:

1. Select the workspace you work with in Adverity and then, in the platform navigation menu, click Datastreams.

2. Select the Google Campaign Manager 360 datastream.

3. In the top navigation panel, click Settings.

4. In Dimension Filter, enter a valid JSON expression.

5. Click Save.

Examples of a JSON expression

Typically, a JSON expression would take the following format.

{
  "kind": "dfareporting#dimensionValue",
  "dimensionName": string,
  "value": string,
  "id": string,
  "matchType": string
}

You can use multiple expressions within a single JSON expression.

For example, use a JSON expression to retrieve data from a Google Campaign Manager 360 datastream.

The values to retrieve are as follows:

• Two specific values (8069163 and 8067471) for the dimension activityId.

• These two vales are associated with another specific value (Adverity), which belongs to the dimension site.

To retrieve this set of data, enter the following JSON expression into Dimension Filter.

[
  {
    "dimensionName": "activityId",
    "kind": "dfareporting#dimensionFilter",
    "value": "8069163"
  },
  {
    "dimensionName": "activityId",
    "kind": "dfareporting#dimensionFilter",
     "value": "8067471"
  },
  {
    "dimensionName": "site",
    "kind": "dfareporting#dimensionFilter",
    "id": "5147781",
    "value": "Adverity"
  }
]