Desgloses de la API de insights

Puedes utilizar los desgloses para agrupar los resultados de la API de insights en distintos conjuntos.

La API de insights puede devolver varias métricas estimadas, en desarrollo o de ambos tipos. Los valores de desglose de los insights son una estimación. Para obtener más información, consulta API de insights, Métricas estimadas y obsoletas.

Limitaciones

Campos no disponibles

Al especificar un desglose, no se pueden solicitar los campos siguientes:

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

Restricciones para resultados de acción que no sean de Meta

Los desgloses siguientes ya no estarán disponibles para las métricas de acción que no sean de Meta, a excepción de las métricas para campañas de aplicaciones dirigidas exclusivamente a Android o iOS 14.4 y versiones anteriores modeladas para SKAN y web:

Desgloses de contenido dinámico

• ad_format_asset
• body_asset
• call_to_action_asset
• description_asset
• image_asset
• link_url_asset
• title_asset
• video_asset

Tipo 1

• region
• dma
• hourly_stats_aggregated_by_audience_time_zone
• hourly_stats_aggregated_by_advertiser_time_zone
• action_device
• platform_position
• publisher_platform
• action_target_id

Tipo 2

• product_id
• action_carousel_card_id/action_carousel_card_name

Reglas relacionadas con los desgloses anteriores:

• Tipo 1: estos valores de desglose se ponen en los grupos "desconocido" o "sin categoría" (p. ej., para targetId, sería 0).
• Tipo 2: la API de insights no devolverá ninguna fila si la consulta incluye este desglose junto con métricas de fuera del sitio (p. ej., métrica de acciones con desgloses de tipo 2).

Nota: Los desgloses indicados anteriormente se seguirán admitiendo para las métricas de Meta, como impresiones, clics en el enlace, etc. Estos cambios tampoco afectarán a los datos históricos anteriores al 27 de abril de 2021; los desgloses de datos históricos seguirán estando disponibles.

Métricas de acciones

Las métricas no estarán disponibles en los casos siguientes:

• Cuando haya un intento de agregación en varias opciones de configuración de atribución.
• Cuando se soliciten con los desgloses afectados (esta restricción solo se aplica a los tipos de acción y fuera de Meta).

Nota: Las métricas estarán disponibles si se realizan consultas con action_attribution_windows=1d_click,7d_click,1d_view (sin incluir la ventana predeterminada).

Desgloses genéricos

Se encuentran disponibles los desgloses siguientes:

Notas

• La filtración de app_id y skan_conversion_id mediante el campo filtering no se admite actualmente.
• El desglose dma no está disponible para las métricas estimated_ad_recall_rate y video_thruplay_watched_actions.
• El desglose dma emplea metodologías de muestreo para calcular métricas únicas, como el alcance. En los casos en los que hay un gran número de regiones DMA con volúmenes relativamente bajos, podrían no estar representadas en la muestra o podrían ampliarse a una potencia de 2. Por lo tanto, es aconsejable consultar también las impresiones correspondientes para mejorar la precisión.
• frequency_value solo se utiliza con reach. Por ejemplo, para determinar la frecuencia con la que un usuario único visualizó un anuncio.
• Por diseño, los desgloses de image_asset y video_asset no están disponibles en el nivel de cuenta publicitaria para los activos utilizados en el contenido dinámico.
• Las acciones de anunciosvideo_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions y video_p100_watched_actions no admiten el desglose por region.
• Todos los desgloses por activo de contenido dinámico admiten únicamente un conjunto limitado de métricas:

La llamada siguiente agrupa los resultados por age y gender.

curl -G \
  -d "breakdowns=age,gender" \
  -d "fields=impressions" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

Desgloses por hora

Ahora, las estadísticas por hora están disponibles si se usan los siguientes desgloses:

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

Consulta Combinación de desgloses para conocer los límites de cantidad de desgloses que puedes solicitar con el desglose por hora. Los desgloses por hora no admiten campos únicos, que son campos cualesquiera con unique_*, reach o frequency antepuesto. Los campos reach y frequency devolverán 0 si se utilizan desgloses por hora.

curl -G \
-d "fields=impressions" \
-d "breakdowns=hourly_stats_aggregated_by_audience_time_zone" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"

Desglose por acción

Agrupa los resultados del campo actions. Puedes utilizar los desgloses siguientes para action_breakdowns:

A continuación se indican los desgloses posibles que se pueden proporcionar en el campo action_breakdowns.

• action_device
• conversion_destination
• matched_persona_id
• matched_persona_name
• signal_source_bucket
• standard_event_content_type
• action_canvas_component_name
• action_carousel_card_id
• action_carousel_card_name
• action_destination
• action_reaction
• action_target_id
• action_type
• action_video_sound
• action_video_type

Si no se especifica el parámetro action_breakdowns, el elemento action_type se añade de forma implícita como action_breakdowns.

Recuento total de actions

Recuento total (suma) de todos los valores devueltos en los resultados del grupo (actions).

total_actions - 33
    page_engagement - 10
        post_engagement - 10
            link_click - 2
            comment - 3
            post_reaction - 3
            like - 2
    mobile_app_install - 12
    app_custom_event - 11
        app_custom_event.fb_mobile_activate_app - 6
        app_custom_event.other - 5

En este ejemplo, post_engagement es una suma de link_click, comment, like y post_reaction, donde post_reaction es el recuento de todas las reacciones, incluidos los Me gusta. El campo total_actions representa una suma de las acciones de nivel superior de un objeto, como page_engagement, mobile_app_install y app_custom_event.

Combinación de desgloses

Debido a las restricciones relativas al almacenamiento, solo están disponibles algunas permutaciones de los desgloses. Las permutaciones marcadas con un asterisco (*) se pueden unir con action_type, action_target_id y action_destination, que es el nombre de action_target_id.

Limitaciones

• Los campos video_* no se pueden solicitar con ningún desglose de estadísticas por hora.
• El campo video_avg_time_watched_actions no se puede solicitar con el desglose por región.
• El elemento action_type se añade de manera implícita como action_breakdowns si el parámetro action_breakdowns no se especifica.