인사이트 API 분석 데이터

분석 데이터를 사용하여 인사이트 API 결과를 각 세트로 묶을 수 있습니다.

인사이트 API는 추산되거나 개발 중이거나 또는 그 두 가지 과정에 있는 여러 가지 지표를 반환할 수 있습니다. 인사이트 분석 데이터 값은 추산됩니다. 자세한 내용은 인사이트 API, 추산 및 사용 중단된 지표를 참조하세요.

제한 사항

사용할 수 없는 필드

다음의 필드는 분석 데이터를 지정할 때 요청할 수 없습니다.

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

Meta 외부 행동 지표에 대한 제한

다음 분석 데이터는 더 이상 Meta 외부 행동 지표에 사용할 수 없습니다. 단, Android, iOS 14.4 이하, 웹 및 SKAN 모델링만을 대상으로 하는 앱 캠페인의 지표는 예외입니다.

다이내믹 크리에이티브 분석 데이터

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

유형 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

유형 2

• product_id
• action_carousel_card_id/action_carousel_card_name

위의 분석 데이터와 관련된 규칙:

• 유형 1 — 이 분석 데이터 값은 '알 수 없음' 또는 '카테고리 없음' 버킷에 넣습니다(예: targetId의 경우 0).
• 유형 2 — 쿼리에 오프셋 지표와 함께 이 분석 데이터가 포함될 경우 인사이트 API는 행을 반환하지 않습니다(예: 유형 2 분석 데이터를 포함한 행동 지표).

참고: 위에 나열된 분석 데이터는 Meta 내 지표(예: 노출, 링크 클릭)에는 지원됩니다. 변경 사항은 2021년 4월 27일 이전의 과거 데이터에는 영향을 미치지 않습니다. 과거 데이터의 분석 데이터는 계속 사용할 수 있습니다.

행동 지표

다음과 같은 시나리오에서는 지표가 제공되지 않습니다.

• 여러 기여 설정에서 집계를 시도한 경우
• 해당 분석 데이터를 포함하여 요청한 경우(이 제한은 Meta 외부 및 행동 유형에만 적용됨)

참고:action_attribution_windows=1d_click,7d_click,1d_view로 쿼리하는 경우 지표가 제공됩니다(기본 기간 미포함).

일반 분석 데이터

다음 분석 데이터를 사용할 수 있습니다.

참고

• 현재 filtering 필드를 사용한 app_id와 skan_conversion_id에 대한 필터링은 지원되지 않습니다.
• 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_type이 action_breakdowns로 암시적으로 추가됩니다.

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_target_id의 이름인 action_type, action_target_id 및 action_destination과 결합할 수 있습니다.

제한 사항

• video_* 필드는 시간별 통계 분석 데이터를 사용하여 요청할 수 없습니다.
• video_avg_time_watched_actions 필드는 지역 분석 데이터로 요청할 수 없습니다.
• action_breakdowns 매개변수를 지정하지 않을 경우 action_type이 action_breakdowns로 암시적으로 추가됩니다.