Cómo generar informes sobre variables personalizadas de Floodlight
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Los anunciantes usan las variables de Floodlight personalizadas para registrar los datos de conversiones que tienen las siguientes características:
únicos según las necesidades de su empresa, como el género de una película que compra el usuario, el nombre
de la tienda en la que se compra un artículo, los costos de envío, etc. Los datos se pueden subir
por una etiqueta de Floodlight en el sitio del anunciante
por la API de Search Ads 360
y puedes usar la API para descargar informes que contienen los datos.
Más información sobre Floodlight personalizado
variables en Search Ads 360.
Métrica o dimensión
En la configuración de las variables personalizadas de Floodlight, un anunciante usa Search Ads 360
IU para indicar cómo se puede usar cada variable en los informes:
Métrica: En la mayoría de los informes, Search Ads 360 agrega los valores de
variables definidas como métricas.
Por ejemplo, un anunciante utiliza una variable de Floodlight personalizada para hacer un seguimiento de los costos de envío.
Si un usuario de Search Ads 360 define esta variable como una métrica y tú incluyes la variable
en un informe de adGroup
verás los costos de envío totales asociados con cada grupo de anuncios en el alcance del informe.
En la conversion
, Search Ads 360 proporciona datos sin procesar sobre conversiones individuales en lugar de datos agregados.
Nota: Las métricas personalizadas también pueden aparecer en
Columnas de informes de Floodlight. En la
IU de Search Ads 360, los usuarios agregan métricas personalizadas a las columnas de informes de Floodlight y, luego, incluyen
las columnas de informes de Floodlight en los informes. También puedes incluir estas columnas de Floodlight
en una solicitud de informe, así como puedes incluir cualquier otro tipo de
columna guardada.
Dimensión: Las variables que se definen como dimensiones se pueden usar para segmentar.
la mayoría de los informes.
Por ejemplo, un anunciante utiliza una variable de Floodlight personalizada para hacer un seguimiento de los nombres de las tiendas. Después del
un usuario de Search Ads 360 define esta variable como una dimensión, puedes usarla para segmentar un
Informe de adGroup
y
ver la cantidad de compras en cada tienda que se atribuyen a los anuncios del grupo de anuncios.
En la conversion
de estado, Search Ads 360 proporciona datos sin procesar sobre conversiones individuales en lugar
datos agregados. Por lo tanto, cuando agregas una dimensión personalizada al informe conversion
,
verás el valor de la dimensión. Continuando con el ejemplo del párrafo anterior, si
segmentar un informe de conversion
por la dimensión personalizada storeName, verás
Es el nombre de la tienda en la que se realizó cada compra específica.
Nota: Cuando los usuarios de Search Ads 360 definen una
columna de informes de Floodlight,
Puede usar dimensiones personalizadas como un filtro para que la columna informe solo las conversiones que
registraron un valor de dimensión específico.
Cómo incluir métricas personalizadas en una solicitud de informe
Para incluir métricas personalizadas en una solicitud de informe, sigue estos pasos:
Luego, en una solicitud de informe, incluye lo siguiente:
customMetricName
: Especifica el nombre descriptivo de la métrica personalizada.
El nombre de la métrica personalizada distingue mayúsculas de minúsculas.
platformSource
: Establece siempre esto en modo floodlight.
Por ejemplo, si un anunciante creó una métrica personalizada llamada shippingCost,
Incluye el costo de envío customMetricName
en un informe:
{
"reportScope": {
"agencyId": "12300000000000456", // Replace with your ID
"advertiserId": "21700000000011523", // Replace with your ID
},
...
"columns": [
{
"customMetricName": "shippingCost",
"platformSource": "floodlight"
}
],
...
}
Cómo segmentar un informe por una dimensión personalizada
Para segmentar un informe según una dimensión personalizada, sigue estos pasos:
Debes saber el nombre amable que se
se especifica cuando el valor personalizado
La variable de Floodlight se creó en Campaign Manager.
El nombre descriptivo también aparece en la IU de Search Ads 360 durante la configuración
dimensiones y métricas personalizadas.
El alcance del informe debe ser de un anunciante específico.
o una versión inferior.
-
Cada solicitud de informe solo puede especificar una dimensión personalizada. Sin embargo,
solicitud puede incluir
segmentos no personalizados adicionales.
Por ejemplo, puedes segmentar un informe por la dimensión personalizada storeName y
según el trimestre y los segmentos no personalizados por dispositivo. Solo ten en cuenta que el número de filas podría
aumentar exponencialmente con cada segmento adicional.
Luego, en una solicitud de informe, incluye lo siguiente:
customDimensionName
: Especifica el nombre descriptivo de la dimensión personalizada.
El nombre de la dimensión personalizada distingue mayúsculas de minúsculas.
platformSource
: Establece siempre esto en modo floodlight.
Por ejemplo, si un anunciante creó una dimensión personalizada llamada storeName,
Incluye el storeName customDimensionName
en un informe para segmentar las métricas por nombre de tienda:
{
"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"
}
],
...
}
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-08-20 (UTC)
[null,null,["Última actualización: 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```"]]