Manage conversion sources

Here's how to use the Content API for Shopping to manage the conversion sources for your merchant account.

Merchant Center conversion sources let you view conversion data from free listings, and from your website, in your merchant account.

Before you can manage conversion sources with the Content API for Shopping, you need to set up auto-tagging and claim a website for your merchant account.

You can use Google Analytics to track conversions on your free listings and your website.

If you have admin access to a Google Analytics property, you can link the property to your merchant account by creating a Google Analytics conversion source.

Here's a sample that creates a new ConversionSource object under your merchant account for Google Analytics:

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/conversionsources/
{
 "googleAnalyticsLink": {
   "propertyId": {propertyId}
  }
}

Here's a sample response containing a ConversionSource object. Google Analytics conversion sources have the field googleAnalyticsLink set, and a conversionSourceId starting with galk:.

{
  "conversionSourceId": "galk:{propertyId}",
  "googleAnalyticsLink": {
    "propertyId": "{propertyId}",
    "attributionSettings": {
       "attributionLookbackWindowInDays": 90,
       "atributionModel": "CROSS_CHANNEL_DATA_DRIVEN",
       "conversionType": [
        {
           "name": "purchase",
           "includeInReporting": true
        }
       ]
   },
   "propertyName": "My Property Name"
  },
 "state": "ACTIVE",
 "controller": "MERCHANT"
}

Use a Google tag

If you don't have a Google Analytics property, you can send conversion data directly to your merchant account by creating a website conversion source with a Google tag. You can use the Google Tag Manager API to set up an existing Google tag, or use the new tag that's automatically created when you add a new website conversion source.

Here's a sample that creates a new ConversionSource object under for website tracking under your merchant account:

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/conversionsources/
{
  "merchantCenterDestination": {
    "displayName": "My tag destination",
    "attributionSettings": {
      "attributionLookbackWindowInDays": 60,
      "attributionModel": "CROSS_CHANNEL_LAST_CLICK"
    },
    "currencyCode": "CHF"
  }
}

Here's a sample response containing a ConversionSource object. Website conversion sources have the field merchantCenterDestination set and a conversionSourceId starting with mcdn:.

{
  "conversionSourceId": "mcdn:12341241234",
  "merchantCenterDestination": {
    "destinationId": "MC-ABCD1234",
    "attributionSettings": {
      "attributionLookbackWindowInDays": 60,
      "attributionModel": "CROSS_CHANNEL_LAST_CLICK"
    },
    "displayName": "My tag destination",
    "currencyCode": "CHF"
  },
  "state": "ACTIVE",
  "controller": "MERCHANT"
}

Once created, you can use the conversion source's destinationId with a Google tag to get conversion data directly from your website.