Início rápido

Confira um exemplo de consulta para a product_performance_view, que retorna a performance da sua conta nos últimos 30 dias, segmentada por marketing_method e offer_id. Teste este exemplo rápido para se familiarizar com a API Merchant Reports.

Para acessar esse relatório, você precisa ter a função "Performance e insights". Para mais informações, consulte Requisitos.

Para fazer a solicitação, transmita a seguinte instrução da linguagem de consulta do Merchant Center ao método accounts.reports.search:

SELECT
  marketing_method,
  offer_id,
  impressions,
  clicks,
  click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

URL de solicitação de HTTP

A solicitação consiste em um POST HTTP para o servidor da API Merchant Reports no seguinte URL:

https://merchantapi.googleapis.com/reports/v1beta/accounts/ACCOUNT_ID/reports:search

Exemplo de solicitação HTTP completa

Confira um exemplo completo que mostra a definição do relatório incluída em uma solicitação POST HTTP:

POST https://merchantapi.googleapis.com/reports/v1beta/accounts/ACCOUNT_ID/reports:search HTTP/1.1

Parameters:
{
  "query" : "SELECT
              marketing_method,
              offer_id,
              impressions,
              clicks,
              click_through_rate
            FROM product_performance_view
            WHERE date BETWEEN '2023-11-01' AND '2023-11-30'"
}

Veja um exemplo de resposta:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38",
        "impressions": "1038",
        "clickThroughRate": "0.3661"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "126",
        "impressions": "1126",
        "clickThroughRate": "0.1119"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "26",
        "impressions": "526",
        "clickThroughRate": "0.0494"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "227",
        "impressions": "1227",
        "clickThroughRate": "0.1850"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "12",
        "impressions": "512",
        "clickThroughRate": "0.0234"
      }
    }
  ]
}

Para mais informações sobre os campos disponíveis para consulta, consulte Campos na tabela productPerformanceView.