Cómo generar informes sobre variables personalizadas de Floodlight

La nueva API de informes de Search Ads 360 ya está disponible. La nueva API proporciona una flexibilidad mejorada para crear informes personalizados y, además, integrar los datos en procesos y aplicaciones de informes. Obtén más información para migrar a la nueva API de informes de Search Ads 360 y usarla.

Los anunciantes usan variables de Floodlight personalizadas para informar datos de conversión únicos según las necesidades de su empresa, como el género de la película que compró un usuario, el nombre de la tienda en la que se compró un artículo, los costos de envío, etc. Los datos se pueden subir con una etiqueta de Floodlight en el sitio del anunciante o con la API de Search Ads 360, y puedes usar la API para descargar informes que contengan los datos.

Obtén más información sobre las variables personalizadas de Floodlight en Search Ads 360.

Métrica o dimensión

Como parte de la configuración de las variables personalizadas de Floodlight, un anunciante utiliza la IU de Search Ads 360 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 las variables que se definen como métricas.
    Por ejemplo, un anunciante usa una variable personalizada de Floodlight 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ú la incluyes en un informe adGroup, verás los costos de envío totales asociados a cada grupo de anuncios en el alcance del informe.

    En el informe 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 las 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, las incluyen en los informes. También puedes incluir estas columnas de Floodlight en una solicitud de informe, al igual que 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 usa una variable personalizada de Floodlight para hacer un seguimiento de los nombres de las tiendas. Después de que un usuario de Search Ads 360 defina esta variable como una dimensión, puedes usarla para segmentar un informe de adGroup y ver la cantidad de compras de cada tienda que se atribuyen a los anuncios del grupo de anuncios.

    En el informe conversion, Search Ads 360 proporciona datos sin procesar sobre conversiones individuales, en lugar de datos agregados. Por lo tanto, cuando agregues una dimensión personalizada al informe de conversion, verás el valor de la dimensión. Para continuar con el ejemplo del párrafo anterior, si segmentas un informe conversion por la dimensión personalizada storeName, verás el nombre de la tienda en la que se produjo cada compra específica.

    Nota: Cuando los usuarios de Search Ads 360 definen una columna de informes de Floodlight, pueden usar dimensiones personalizadas como 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: Siempre establece esto en 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 en función de una dimensión personalizada

Para segmentar un informe por una dimensión personalizada, sigue estos pasos:

  • Deberás conocer el nombre compatible que se especificó cuando se creó la variable personalizada de Floodlight en Campaign Manager. El nombre descriptivo también aparece en la IU de Search Ads 360 cuando se configuran dimensiones y métricas personalizadas.

  • El alcance del informe debe ser de un anunciante específico o inferior.

  • Cada solicitud de informe solo puede especificar una dimensión personalizada. Sin embargo, la solicitud puede incluir segmentos no personalizados adicionales.
    Por ejemplo, puedes segmentar un informe por la dimensión personalizada storeName y por segmentos no personalizados por trimestre y dispositivo. Solo ten en cuenta que la cantidad 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: Siempre establece esto en Floodlight.

Por ejemplo, si un anunciante creó una dimensión personalizada llamada storeName, incluye el valor customDimensionName de storeName 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"
     }
   ],
   ...
}