Performance reports

A API Merchant oferece relatórios de performance, por exemplo, ProductPerformanceView Esta página explica a estrutura dos Relatórios de desempenho.

Métricas

É possível consultar as métricas (por exemplo, clicks e impressions) que você que você quer retornar. É preciso adicionar um filtro no período para consultar os relatórios. para dados de desempenho.

Este é um exemplo de consulta que retorna uma única linha com o número total de cliques dentro do período especificado:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

Especifique os dados que você quer retornar. Caracteres curinga (por exemplo, SELECT *) retornam um erro.

O exemplo de resposta a seguir mostra que o comerciante teve um total de 4.440 cliques, em todos os produtos, em todos os métodos de marketing, entre 1o de dezembro, de 2020 e 21 de dezembro de 2020.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Segmentos

É possível usar a MCQL para consultar campos de segmentos. Os campos de segmentos podem ser atributos do produto (por exemplo, offerId, brand e category) ou evento (por exemplo, date e marketingMethod).

Os campos de segmentos agem de forma semelhante a um GROUP BY no SQL. Os campos de segmentos dividem métricas selecionadas, agrupando por cada segmento na cláusula SELECT.

Veja um exemplo de consulta que retorna cliques por dia, em ordem decrescente por clicks, dentro da condição adicionada de um período. Apenas as linhas com pelo menos uma métrica solicitada for diferente de zero serão retornadas.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

O exemplo de resposta a seguir mostra que o comerciante teve 1.546 cliques todos os produtos, em todos os métodos de marketing, em 1o de dezembro de 2020 e 829 cliques em todos os produtos e métodos de marketing no dia 2 de dezembro de 2020. O comerciante não teve cliques em 3 de dezembro de 2020, então nada é retornado nessa data.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}