Gerar relatórios sobre variáveis personalizadas do Floodlight

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.

Os anunciantes usam variáveis personalizadas do Floodlight para informar dados de conversão que são exclusivos para suas necessidades comerciais, como o gênero de um filme que um usuário compra, o nome da loja na qual um item é comprado, custos de envio e assim por diante. É possível fazer o upload dos dados 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 o Floodlight personalizado variáveis no Search Ads 360.

Métrica ou dimensão

Como parte da configuração das variáveis personalizadas do Floodlight, um anunciante usa a ferramenta interface para indicar como cada variável pode ser usada em relatórios:

  • Métrica: na maioria dos relatórios, o Search Ads 360 agrega os valores de variáveis que são 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ê a incluir em um relatório adGroup, você verá os custos totais de frete associados a cada grupo de anúncios no escopo do relatório.

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

    Observação: as métricas personalizadas também podem aparecer Colunas de relatórios do Floodlight. Na interface do Search Ads 360, os usuários adicionam métricas personalizadas às colunas de relatórios do Floodlight e incluem colunas de relatórios do Floodlight nos relatórios. Também é possível incluir essas colunas do Floodlight em uma solicitação de relatório, assim como é possível incluir 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 um usuário do Search Ads 360 definir essa variável como uma dimensão, será possível usá-la para segmentar uma adGroup no relatório e ver o número de compras de cada loja que são atribuídas aos anúncios no grupo de anúncios.

    No conversion relatório, o Search Ads 360 fornece dados brutos sobre conversões individuais em vez de dados agregados. Então, quando você adiciona 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 de 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 coluna de relatórios do Floodlight, eles usar dimensões personalizadas como filtro para que a coluna informe apenas as conversões que registrou 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 amigável 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 com o nome shippingCost, inclua o custo do frete 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:

  • Você precisa saber o nome amigável que foi especificado quando a tag personalizada A variável do Floodlight foi criada no Campaign Manager. Esse nome também aparece na interface do Search Ads 360 durante a configuração dimensões e métricas personalizadas.

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

  • Cada solicitação de relatório pode especificar somente uma dimensão personalizada. Mas o solicitação pode incluir outros segmentos não personalizados.
    Por exemplo, é possível segmentar um relatório pela dimensão personalizada storeName e por trimestre e por dispositivos não personalizados. Lembre-se de que o número de linhas pode aumentam exponencialmente a cada segmento adicional.

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

  • customDimensionName: especifica o nome amigável 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 da 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"
     }
   ],
   ...
}