Gerar relatórios sobre variáveis personalizadas do Floodlight

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.

Os anunciantes usam variáveis personalizadas do Floodlight para relatar dados de conversão exclusivos das necessidades comerciais, como o gênero de um filme comprado por um usuário, o nome da loja onde um item é comprado, os custos de frete e assim por diante. Os dados podem ser enviados por uma tag do Floodlight no site do anunciante ou pela API Search Ads 360, e você pode usar a API para fazer o download de relatórios que contêm os dados.

Saiba mais sobre as variáveis personalizadas do Floodlight no Search Ads 360.

Métrica ou dimensão

Como parte da configuração de variáveis personalizadas do Floodlight, o anunciante usa a interface do Search Ads 360 para indicar como cada variável pode ser usada nos relatórios:

  • Métrica: na maioria dos relatórios, o Search Ads 360 agrega os valores das variáveis definidas como métricas.
    Por exemplo, um anunciante usa uma variável personalizada do Floodlight para rastrear os custos de frete. Se um usuário do Search Ads 360 definir essa variável como uma métrica e você incluí-la em um relatório adGroup, vai ver os custos totais de frete associados a cada grupo de anúncios no escopo do relatório.

    No relatório conversion, o Search Ads 360 mostra dados brutos sobre conversões individuais em vez de dados agregados.

    Observação: as métricas personalizadas também podem aparecer nas colunas de relatórios do Floodlight. Na interface do Search Ads 360, os usuários adicionam métricas personalizadas às colunas de relatório do Floodlight e incluem essas colunas nos relatórios. Essas colunas do Floodlight também podem ser incluídas em uma solicitação de relatório, assim como qualquer outro tipo de coluna salva.

  • Dimensão: variáveis definidas como dimensões podem ser usadas para segmentar a maioria dos relatórios.
    Por exemplo, um anunciante usa uma variável personalizada do Floodlight para rastrear nomes de lojas. Depois que um usuário do Search Ads 360 definir essa variável como uma dimensão, você poderá usá-la para segmentar um relatório adGroup e ver o número de compras de cada loja atribuídas a anúncios no grupo de anúncios.

    No relatório conversion, o Search Ads 360 mostra dados brutos sobre conversões individuais em vez de dados agregados. Portanto, ao adicionar uma dimensão personalizada ao relatório conversion, você verá o valor da dimensão. Continuando com o exemplo do parágrafo anterior, se você segmentar um relatório conversion pela dimensão personalizada storeName, verá o nome da loja em que cada compra específica ocorreu.

    Observação: quando os usuários do Search Ads 360 definem uma coluna de relatórios do Floodlight, eles podem usar dimensões personalizadas como filtro para que a coluna informe somente as conversões que registraram um valor de dimensão específico.

Incluir métricas personalizadas em uma solicitação de relatório

Para incluir métricas personalizadas em uma solicitação de relatório:

Em seguida, em uma solicitação de relatório, inclua:

  • customMetricName: especifica o nome de fácil utilização da métrica personalizada.
    O nome da métrica personalizada diferencia maiúsculas de minúsculas.

  • platformSource: sempre defina como Floodlight.

Por exemplo, se um anunciante criou uma métrica personalizada chamada shippingCost, inclua o shippingCost customMetricName em um relatório:

{
   "reportScope": {
     "agencyId": "12300000000000456", // Replace with your ID
     "advertiserId": "21700000000011523", // Replace with your ID
   },
   ...
   "columns": [
     {
        "customMetricName": "shippingCost",
        "platformSource": "floodlight"
     }
   ],
   ...
}
   

Segmentar um relatório por uma dimensão personalizada

Para segmentar um relatório por uma dimensão personalizada:

  • É preciso saber o nome amigável que foi especificado quando a variável personalizada do Floodlight foi criada no Campaign Manager. Ele também aparece na interface do Search Ads 360 ao configurar dimensões e métricas personalizadas.

  • O escopo do relatório precisa ser um anunciante específico ou um nível inferior.

  • Cada solicitação de relatório pode especificar somente uma dimensão personalizada. No entanto, a solicitação pode incluir outros segmentos não personalizados.
    Por exemplo, você pode segmentar um relatório pela dimensão personalizada storeName e pelos segmentos não personalizados de trimestre e dispositivo. Lembre-se de que o número de linhas pode aumentar exponencialmente a cada segmento adicional.

Em seguida, em uma solicitação de relatório, inclua:

  • customDimensionName: especifica o nome simples da dimensão personalizada.
    O nome da dimensão personalizada diferencia maiúsculas de minúsculas.

  • platformSource: sempre defina como Floodlight.

Por exemplo, se um anunciante criou uma dimensão personalizada chamada storeName, inclua o storeName customDimensionName em um relatório para segmentar métricas por nome de loja:

{
   "reportScope": {
     "agencyId": "20700000000000123", // Replace with your IDs
     "advertiserId": "2170000012345" // Replace with your IDs
   },
   "reportType": "campaign",

   "columns": [
     { "columnName": "campaignId" },
     { "columnName": "clicks" },
     { "columnName": "cost" },
     { "columnName": "dfaRevenue"},

     {
        "customDimensionName": "storeName",
        "platformSource": "floodlight"
     }
   ],
   ...
}