Gerenciar origens de conversão

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

Com as fontes de conversão do Merchant Center, é possível conferir dados de conversão das listagens sem custo financeiro e do seu site na conta do Merchant Center.

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

Use 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á 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 objeto ConversionSource 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 fontes de conversão do Google Analytics têm o campo googleAnalyticsLink definido e o nome 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 tem uma propriedade do Google Analytics, pode enviar dados de conversão diretamente para sua conta do Merchant Center criando uma fonte de conversão do site com uma tag do Google. Use a API do Gerenciador de tags do Google para configurar uma tag do Google existente ou a nova tag criada automaticamente quando você adiciona uma nova origem de conversão do site.

Confira um exemplo que cria um novo objeto accounts.conversionSources para rastreamento 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 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 criada, 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.