Gerenciar origens de conversão

Confira como usar a API Merchant para gerenciar as origens de conversão da sua conta de comerciante.

Com as fontes de conversão do Merchant Center, você pode conferir dados de conversão de listagens sem custo financeiro e do seu site na sua conta de comerciante.

Antes de gerenciar as origens de conversão com a API Merchant, você precisa configurar a inclusão automática e vincular um site à sua conta do Merchant Center. Uma conta de comerciante pode ter até 200 origens de conversão.

Você pode usar o Google Analytics para acompanhar as conversões nas suas listagens sem custo financeiro e no seu site.

Se você tiver acesso de administrador a uma propriedade do Google Analytics, poderá vincular a propriedade à sua conta de comerciante criando uma fonte de conversão do Google Analytics.

A solicitação de API a seguir cria um novo objeto ConversionSource na sua conta de comerciante para o Google Analytics:

POST  https://merchantapi.googleapis.com/conversions/v1beta/accounts/ACCOUNT_ID/conversionSources

{
 "googleAnalyticsLink": {
   "propertyId": PROPERTY_ID
  }
}

O exemplo de resposta a seguir contém um objeto ConversionSource. As fontes de conversão do Google Analytics têm o campo googleAnalyticsLink definido e o nome delas segue o accounts/{ACCOUNT}/conversionSources/galk:{PROPERTY_ID}.

{
  "name": "accounts/{ACCOUNT_ID}/conversionSources/galk:PROPERTY_ID"
  "googleAnalyticsLink": {
    "propertyId": "PROPERTY_ID",
    "attributionSettings": {
      "attributionLookbackWindowDays": 30,
      "atributionModel": "CROSS_CHANNEL_DATA_DRIVEN",
      "conversionType": [
        {
          "name": "purchase",
          "report": true
        }
      ]
    },
    "propertyName": "My Property Name"
  },
 "state": "ACTIVE",
 "controller": "MERCHANT"
}

Usar uma tag do Google

Se você não tiver uma propriedade do Google Analytics, poderá enviar dados de conversão diretamente para sua conta de comerciante criando uma origem de conversão do site com uma tag do Google. Você pode usar a API Google Tag Manager para configurar uma tag do Google existente ou usar a nova tag que é criada automaticamente quando você adiciona uma nova origem de conversão do site.

Confira um exemplo que cria um novo objeto accounts.conversionSources para o acompanhamento de sites na sua conta de comerciante:

POST https://merchantapi.googleapis.com/conversions/v1beta/accounts/ACCOUNT_ID/conversionSources

{
  "merchantCenterDestination": {
    "attributionSettings": {
      "attributionLookbackWindowDays": 30,
      "attributionModel": "CROSS_CHANNEL_LAST_CLICK"
    },
    "displayName": "My tag destination",
    "currencyCode": "CHF"
  }
}

Confira um exemplo de resposta que contém um objeto ConversionSource. As fontes de conversão do site têm o campo merchantCenterDestination definido e o nome delas segue o accounts/{ACCOUNT_ID}/conversionSources/mcdn:{PROPERTY_ID}.

{
  "name": "accounts/{ACCOUNT_ID}/conversionSources/mcdn:{PROPERTY_ID}",
  "merchantCenterDestination": {
    "destination": "MC-ABCD1234",
    "attributionSettings": {
      "attributionLookbackWindowDays": 30,
      "attributionModel": "CROSS_CHANNEL_LAST_CLICK"
    },
    "displayName": "My tag destination",
    "currencyCode": "CHF"
  },
  "state": "ACTIVE",
  "controller": "MERCHANT"
}

Depois de criar, você pode usar a destination da origem de conversão com uma tag do Google para receber dados de conversão diretamente do seu site.

Saiba mais

Para saber como migrar da API Content for Shopping, consulte Migrar o gerenciamento de origens de conversão.