Colunas salvas

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

Para gerar relatórios sobre atividades do Floodlight, metas do Google Analytics ou KPIs personalizados, o anunciante pode fazer login na IU do Search Ads 360 e criar uma ou mais colunas salvas, como colunas de atividades 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 dela ou filtrar um relatório.

Acessar uma lista de colunas salvas

Para ver todas as colunas salvas que um anunciante criou, envie uma solicitação SavedColumns.list() . A resposta inclui o 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 dela:

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

Ao usar as colunas salvas, lembre-se do seguinte:

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

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

• As colunas salvas podem ser modificadas ou removidas na interface de gerenciamento de campanhas do Search Ads 360 a qualquer momento. Se uma solicitação que especifica colunas salvas falhar, remova essas colunas da solicitação e envie-a novamente.

• Relatórios incrementais não podem conter métricas que não sejam explicitamente compatíveis com a API (por exemplo, colunas de atividade do Google Analytics). Além disso, como os usuários do Search Ads 360 podem redefinir as colunas salvas, os relatórios incrementais que contêm colunas salvas podem não ser precisos.