Colunas salvas

A nova API Search Ads 360 Reporting já está disponível. A nova API oferece mais flexibilidade para criar relatórios personalizados e integrar os dados aos seus aplicativos de geração de relatórios e processos. Saiba mais sobre como migrar e usar os novos relatórios do Search Ads 360 API.

Para gerar relatórios sobre atividades do Floodlight, metas do Google Analytics ou um anunciante pode fazer login na interface do Search Ads 360 e criar um ou mais colunas salvas, como colunas de atividade do Floodlight, colunas de atividades do Google Analytics ou colunas de fórmula. Você pode incluir uma coluna salva em uma solicitação de relatório para fazer o download dos dados ou filtrar um relatório.

Acessar uma lista de colunas salvas

Para ver todas as colunas salvas que um anunciante criou, envie uma SavedColumns.list() solicitação. A resposta inclui savedColumnName para cada uma das colunas do anunciante.

Solicitar relatórios das colunas salvas

Para incluir uma coluna salva em uma solicitação de relatório, adicione uma coluna com o Atributo savedColumnName definido como o nome da coluna:

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

Ao usar colunas salvas, lembre-se de que:

  • As colunas salvas são definidas no nível do anunciante. Se você for incluir uma coluna salva em uma solicitação, request.reportScope deve especificar um anunciante ou um nível inferior do projeto. Consequentemente, cada relatório pode incluir colunas salvas somente para um um único anunciante.

  • Os nomes das colunas salvos diferenciam maiúsculas de minúsculas, espaços em branco e sensíveis à pontuação. A O atributo savedColumnName precisa corresponder ao nome da coluna salva exatamente. Se o nome de uma coluna salva for idêntico ao nome da outra coluna na mesma solicitação, o Search Ads 360 exige que você especifique um headerText alternativo e exclusivo para uma ou ambas as colunas.

  • As colunas salvas podem ser modificadas ou removidas no gerenciamento de campanhas do Search Ads 360 interface a qualquer momento. se uma solicitação que especifica colunas salvas falhar, tente removendo as colunas salvas da solicitação e enviando-a novamente.

  • Os relatórios incrementais não podem conter métricas que não sejam explicitamente suportados pela API (por exemplo, colunas de atividade do Google Analytics). Em adição, já que os usuários do Search Ads 360 podem redefinir as colunas salvas, os relatórios que contêm colunas salvas podem não ser precisos.