Gerar relatórios sobre variáveis personalizadas do Floodlight
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
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:
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"
}
],
...
}
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-08-20 UTC.
[null,null,["Última atualização 2024-08-20 UTC."],[[["\u003cp\u003eThe new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables allow advertisers to report unique conversion data like product details or shipping costs.\u003c/p\u003e\n"],["\u003cp\u003eCustom Floodlight variables can be defined as metrics (aggregated values) or dimensions (report segmentation).\u003c/p\u003e\n"],["\u003cp\u003eTo include custom metrics in reports, use the \u003ccode\u003ecustomMetricName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e in your request.\u003c/p\u003e\n"],["\u003cp\u003eTo segment reports by a custom dimension, use the \u003ccode\u003ecustomDimensionName\u003c/code\u003e and \u003ccode\u003eplatformSource: floodlight\u003c/code\u003e while limiting to one custom dimension per request.\u003c/p\u003e\n"]]],["The new Search Ads 360 Reporting API allows building custom reports and integrating data into reporting applications. Advertisers can use custom Floodlight variables for unique conversion data. These variables can be defined as metrics (aggregated data) or dimensions (segmentation). To include custom metrics, specify the friendly name and set the platform source to \"floodlight\" in the report request. Similarly, segmenting by a custom dimension requires specifying its friendly name and \"floodlight\" as the platform source. Only one custom dimension is allowed per report request.\n"],null,["# Report on Custom Floodlight Variables\n\nThe new Search Ads 360 Reporting API is now available. The new API provides enhanced flexibility to build custom reports and integrate the data into your reporting applications and processes. Learn more about migrating to and using the [new Search Ads 360 Reporting\nAPI](https://developers.google.com/search-ads/reporting/overview).\n\n\nAdvertisers use **custom Floodlight variables** to report conversion data that is\nunique to their business needs, such as the genre of a movie that a user purchases, the name\nof the store from which an item is purchased, shipping costs, and so on. The data can be uploaded\nby a Floodlight tag on the advertiser's site or\n[by the Search Ads 360 API](/search-ads/v2/how-tos/conversions/custom-data),\nand you can use the API to download reports that contain the data.\n\n\n[Learn more](https://support.google.com/searchads/answer/4397154) about custom Floodlight\nvariables in Search Ads 360.\n\n### Metric or dimension\n\nAs part of setting up custom Floodlight variables, an advertiser uses the Search Ads 360\nUI to indicate how each variable can be used in reports:\n\n-\n **Metric** : In most reports, Search Ads 360 aggregates the values of\n variables that are defined as metrics. \n\n For example, an advertiser uses a custom Floodlight variable to track shipping costs.\n If a Search Ads 360 user defines this variable as a metric and you include the variable\n in an [`adGroup`](/search-ads/v2/report-types/adGroup) report,\n you'll see the total shipping costs associated with each ad group in the report's scope.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of aggregated data.\n\n Note: Custom metrics can also appear in\n [Floodlight reporting columns](https://support.google.com/searchads/answer/6024745). In the\n Search Ads 360 UI, users add custom metrics to Floodlight reporting columns and then include\n the Floodlight reporting columns in reports. You can also include these Floodlight columns\n in a report request, just as you can include any other type of\n [saved column](/search-ads/v2/how-tos/reporting/saved-columns).\n-\n **Dimension** : Variables that are defined as dimensions can be used to segment\n most reports. \n\n For example, an advertiser uses a custom Floodlight variable to track store names. After\n a Search Ads 360 user defines this variable as a dimension, you can use it to segment an\n [`adGroup`](/search-ads/v2/report-types/adGroup) report and\n see the number of purchases from each store that are attributed to ads in the ad group.\n\n\n In the [`conversion`](/search-ads/v2/report-types/conversion)\n report, Search Ads 360 provides raw data about individual conversions instead of\n aggregated data. So when you add a custom dimension to the `conversion` report,\n you'll see the dimension value. Continuing the example from the previous paragraph, if you\n segment a `conversion` report by the storeName custom dimension, you'll see\n the name of the store in which each specific purchase occurred.\n\n\n Note: When Search Ads 360 users define a\n [Floodlight reporting column](https://support.google.com/searchads/answer/6024721), they\n can use custom dimensions as a filter so the column reports only the conversions that\n recorded a specific dimension value.\n\n### Include custom metrics in a report request\n\nTo include custom metrics in a report request:\n\n-\n You'll need to know the **friendly** name that was\n specified when the\n [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when\n [setting up\n custom dimensions and metrics](https://support.google.com/searchads/answer/6024747#set-up).\n\n-\n The scope of the report needs to be a specific advertiser or lower.\n\nThen in a report request, include:\n\n-\n [`customMetricName`](/search-ads/v2/reference/reports#request.columns.customMetricName): Specifies the friendly name of the custom metric.\n\n The custom metric name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom metric named **shippingCost** ,\ninclude the shippingCost `customMetricName` in a report: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"12300000000000456\", // Replace with your ID\n \"advertiserId\": \"21700000000011523\", // Replace with your ID\n },\n ...\n \"columns\": [\n {\n \"customMetricName\": \"shippingCost\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```\n\n### Segment a report by a custom dimension\n\nTo segment a report by a custom dimension:\n\n-\n You'll need to know the **friendly** name that was\n specified when the [custom\n Floodlight variable was created in Campaign Manager](https://support.google.com/dcm/partners/answer/2823222#customvar).\n The friendly name also appears in the Search Ads 360 UI when setting up\n custom dimensions and metrics.\n\n- The scope of the report needs to be a specific advertiser\n or lower.\n\n- Each report request can only specify **one** custom dimension. But the\n request can include [additional non-custom segments](/search-ads/v2/how-tos/reporting/segmented-reports#multiple). \n\n For example, you can segment a report by the storeName custom dimension **and**\n by the quarter and device non-custom segments. Just be aware that the number of rows could\n increase exponentially with each additional segment.\n\nThen in a report request, include:\n\n-\n [`customDimensionName`](/search-ads/v2/reference/reports#request.columns.customDimensionName): Specifies the friendly name of the custom dimension.\n\n The custom dimension name is case sensitive.\n\n-\n [`platformSource`](/search-ads/v2/reference/reports#request.columns.platformSource): Always set this to **floodlight**.\n\n\nFor example if an advertiser created a custom dimension named **storeName** ,\ninclude the storeName `customDimensionName` in a report to segment metrics by store name: \n\n```text\n{\n \"reportScope\": {\n \"agencyId\": \"20700000000000123\", // Replace with your IDs\n \"advertiserId\": \"2170000012345\" // Replace with your IDs\n },\n \"reportType\": \"campaign\",\n\n \"columns\": [\n { \"columnName\": \"campaignId\" },\n { \"columnName\": \"clicks\" },\n { \"columnName\": \"cost\" },\n { \"columnName\": \"dfaRevenue\"},\n\n {\n \"customDimensionName\": \"storeName\",\n \"platformSource\": \"floodlight\"\n }\n ],\n ...\n}\n \n```"]]