Разбивки Insights API

Результаты Insights API можно группировать, используя разбивки.

Insights API может возвращать приблизительные метрики, метрики в разработке или приблизительные метрики в разработке. Статистические данные в разбивке являются приблизительными. Подробные сведения см. в этом разделе.

Ограничения

Недоступные поля

При настройке разбивки нельзя запросить следующие поля:

• app_store_clicks;
• newsfeed_avg_position;
• newsfeed_clicks;
• relevance_score;
• newsfeed_impressions.

Ограничения для метрик действий вне Meta

Следующие разбивки более не доступны для всех метрик действий вне Meta.

Тип 1

• region
• dma
• hourly_stats_aggregated_by_audience_time_zone
• hourly_stats_aggregated_by_advertiser_time_zone

Тип 2

• action_device
• action_destination
• action_target_id
• product_id
• action_carousel_card_id/action_carousel_card_name
• action_canvas_component_name

Правила, связанные с запросами, содержащими перечисленные выше разбивки:

• тип 1 — Insights API не вернет поддерживаемые метрики сторонних сайтов (например, метрику действий с разбивками типа 1);
• тип 2 — API будет по-прежнему возвращать разбивки сторонних сайтов, однако они не будут содержать значение разбивки. Мобильные метрики, запрошенные с этими разбивками, не больше возвращаться не будут.

Примечание. Перечисленные выше разбивки будут по-прежнему поддерживаться для таких метрик на Meta, как количество показов, количество кликов по ссылкам и т. д. Изменения также не повлияют на более ранние данные, полученные до 27 апреля 2021 года. Разбивки для таких данных будут по-прежнему доступны.

Метрики действий

Метрики будут недоступны в следующих сценариях:

• при попытке агрегирования с разными настройками атрибуции;
• при запросе с затронутыми разбивками (это ограничение применяется только для типов действий вне Meta).

Примечание. Метрики будут доступны при запросе с окнами action_attribution_windows=1d_click,7d_click,1d_view (не относится к окну по умолчанию).

Общие разбивки

Доступны следующие разбивки:

Примечания

• Фильтрация app_id и skan_conversion_id с помощью поля filtering пока не поддерживается.
• Разбивку dma нельзя использовать для метрик estimated_ad_recall_rate и video_thruplay_watched_actions.
• В разбивке dma для вычисления уникальных метрик, таких как охват, используется методология выборки. В экземплярах, где имеется большое количество регионов DMA со сравнительно небольшими объемами, они могут не представляться в выборке или масштабироваться до степени 2. Поэтому для повышения точности рекомендуется запрашивать и соответствующие показы.
• Значение frequency_value используется только с параметром reach. Например, оно обозначает, как часто уникальный пользователь видел рекламное объявление.
• Разбивки image_asset и video_asset недоступны на уровне рекламного аккаунта для объектов, которые используются в динамическом креативе.
• Для действий с рекламойvideo_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions и video_p100_watched_actions не поддерживается разбивка по параметру region.
• Все разбивки для динамического креатива поддерживают лишь ограниченный набор метрик:

Следующий вызов группирует результаты по параметрам age и 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"

Почасовые разбивки

Теперь данные статистики можно разбить по часам с помощью этих параметров:

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

Ограничения по количеству разбивок, которые можно запросить вместе с почасовой разбивкой, перечислены в разделе Объединение разбивок. Почасовые разбивки не поддерживают уникальные поля, т. е. любые поля, которые начинаются с unique_*, reach или frequency. Если применяются почасовые разбивки, поля reach и frequency возвращают 0.

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"

Разбивка по действиям

Вы можете сгруппировать результаты в поле actions. Параметр action_breakdowns позволяет применить указанные ниже разбивки.

Поле 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

Если параметр action_breakdowns не указан, в качестве action_breakdowns неявным образом добавляется action_type.

Общее количество действий в поле actions

Общее количество (сумма) всех значений, возвращенных в результатах группы (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

В этом примере post_engagement представляет собой сумму link_click, comment, like и post_reaction, где post_reaction — это число всех реакций, в т. ч. отметок "Нравится". Поле total_actions представляет собой сумму действий верхнего уровня для объекта, например page_engagement, mobile_app_install и app_custom_event.

Объединение разбивок

Поскольку объем хранимых данных ограничен, доступны не все сочетания разбивок. Разбивки, помеченные звездочкой (*), можно объединить с action_type, action_target_id и action_destination (название action_target_id).

Ограничения

• При разбивке статистики по часам нельзя запросить поля video_*.
• При разбивке по регионам нельзя запросить поле video_avg_time_watched_actions.
• Параметр action_type неявным образом добавляется в качестве action_breakdowns, если параметр action_breakdowns не указан.