Gerenciar origens de conversão

Saiba como usar a API Merchant para gerenciar as origens de conversão da sua conta do Merchant Center.

As origens de conversão do Merchant Center permitem visualizar dados de conversão de listagens sem custo financeiro e do seu site na conta do Merchant Center.

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

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

Se você tiver acesso de administrador a uma propriedade do Google Analytics, poderá vinculá-la à sua conta do Merchant Center criando uma origem de conversão do Google Analytics.

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

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

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

O exemplo de resposta a seguir contém um objeto ConversionSource. As origens de conversão do Google Analytics têm o campo googleAnalyticsLink definido, e o nome delas segue o formato 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 do Merchant Center criando uma origem de conversão no site com uma tag do Google. Você pode usar a API do Gerenciador de Tags do Google para configurar uma tag do Google ou usar a nova tag criada automaticamente quando você adiciona uma nova origem de conversão no site.

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

POST https://merchantapi.googleapis.com/conversions/v1/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 origens 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 criada, você pode usar o 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.