Desgloses de la API de estadísticas

Puedes agrupar los resultados de la API de estadísticas en conjuntos diferentes mediante desgloses.

La API de estadísticas puede devolver varias métricas, tanto estimadas como en desarrollo. Los valores de los desgloses de las estadísticas son estimados. Para obtener más información, consulta API de estadísticas, Métricas estimadas y obsoletas.

Limitaciones

Campos no disponibles

No pueden solicitarse los siguientes campos cuando se especifica un desglose:

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

Restricciones de las métricas de acción fuera de Meta

Dejarán de estar disponibles los siguientes desgloses de las métricas de acción fuera de Meta, con excepción de las métricas para campañas de apps que funcionan exclusivamente con Android o iOS 14.4 o versiones anteriores, web y SKAN modelada:

Desgloses del 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 colocan en las categorías "desconocido" o "sin categoría" (por ejemplo, para targetId sería 0).
• Tipo 2: la API de estadísticas no devolverá ninguna fila si la consulta contiene este desglose junto con las métricas fuera del sitio (por ejemplo, la métrica de acciones con los desgloses de tipo 2).

Nota: Se admitirán los desgloses que figuran a continuación para métricas en Meta, como impresiones, clic en el enlace, etc. No se aplicarán los cambios a los datos históricos anteriores al 27 de abril de 2021. Los desgloses de los datos históricos seguirán estando a disposición.

Métricas de acción

No estarán disponibles las métricas si se presentan las siguientes condiciones:

• Cuando hay un intento de agregación en varios elementos de la configuración de atribución.
• Cuando se solicitan con desgloses impactados (esta restricción solo se aplica a las actividades fuera de Meta y a los tipos de acción).

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

Desgloses generales

Los siguientes desgloses están disponibles.

Notas

• Actualmente, no se admite el filtrado de app_id y skan_conversion_id con el campo filtering.
• El desglose de dma no está disponible en las métricas estimated_ad_recall_rate ni video_thruplay_watched_actions.
• El desglose de dma utiliza una metodología de muestras 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, es posible que estas no estén representadas en la muestra o que podrían duplicarse. Por lo tanto, se aconseja también consultar las impresiones correspondientes para obtener un número más preciso.
• frequency_value solo se usa con reach. Por ejemplo, la frecuencia con la que un usuario único vio un anuncio.
• De forma predeterminada, los desgloses por image_asset y video_asset no están disponibles a nivel de la cuenta publicitaria para los activos usados en 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 de activos de contenido dinámico admiten solamente un conjunto limitado de métricas:

La siguiente llamada agrupa los resultados por age y por 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 constituyen un desglose disponible que usa el siguiente análisis:

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

Consulta Combinar desgloses para conocer los límites respecto del número de desgloses que puedes solicitar con el desglose por hora. Los desgloses por hora no admiten campos únicos, que son campos antepuestos con unique_*, reach o frequency. Los campos reach y frequency devolverán un valor de cero cuando se usen los 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 en el campo actions. Puedes usar los siguientes desgloses para action_breakdowns:

Debajo figuran los posibles desgloses 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, action_type se añade implícitamente como el action_breakdowns.

Recuento total en actions

El recuento total (suma) de todos los valores devueltos en resultados de 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 la 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.

Combinar desgloses

Debido a restricciones de almacenamiento, solo están disponibles algunas permutaciones de desgloses. Las permutaciones marcadas con un asterisco (*) se pueden unir a 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 desgloses de estadísticas por hora.
• No se puede solicitar el campo video_avg_time_watched_actions con el desglose por región.
• action_type se añade implícitamente como action_breakdowns cuando el parámetro action_breakdowns no está especificado.