Manage conversion sources

  • The Merchant API is the new version of the Content API for Shopping and represents the future of the platform.

  • You can link a Google Analytics property to your Merchant Center account to track conversions for free listings and your website.

  • If you don't use Google Analytics, you can send conversion data directly to Merchant Center by creating a website conversion source with a Google tag.

  • This guide explains how to manage conversion sources using the Content API for Shopping, allowing you to view conversion data from various sources in your Merchant Center account.

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.