API Thông tin chi tiết chia nhỏ

Bạn có thể nhóm các kết quả của API Thông tin chi tiết thành nhiều nhóm bằng cách sử dụng số liệu chia nhỏ.

API Thông tin chi tiết có thể trả về một vài số liệu ước tính, đang phát triển hoặc cả hai loại dữ liệu này. Các giá trị trong thông tin chi tiết chia nhỏ đều ở dạng ước tính. Để biết thêm thông tin, hãy xem phần API Thông tin chi tiết, Số liệu ước tính và không dùng nữa.

Giới hạn

Trường không khả dụng

Bạn không thể yêu cầu các trường sau đây khi chỉ định số liệu chia nhỏ:

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

Hạn chế đối với số liệu hành động ngoài Meta

Sau đây là các số liệu chia nhỏ sẽ không còn khả dụng cho số liệu hành động ngoài Meta.

Loại 1

• region
• dma
• hourly_stats_aggregated_by_audience_time_zone
• hourly_stats_aggregated_by_advertiser_time_zone

Loại 2

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

Quy tắc liên quan đến truy vấn chứa các số liệu chia nhỏ ở trên:

• Loại 1 - API Thông tin chi tiết sẽ không trả về các số liệu ngoài trang web không được hỗ trợ (ví dụ: số liệu hành động có số liệu chia nhỏ thuộc Loại 1).
• Loại 2 - API sẽ vẫn trả về các số liệu trên web ngoài trang web. Tuy nhiên, những số liệu này sẽ không chứa giá trị số liệu chia nhỏ. Khi bạn truy vấn bằng những số liệu chia nhỏ này, hệ thống sẽ không trả về số liệu trên di động nữa.

Lưu ý: Những số liệu chia nhỏ liệt kê ở trên vẫn sẽ dùng được cho các số liệu trên Meta, chẳng hạn như lượt hiển thị, lượt click vào liên kết, v.v. Ngoài ra, các thay đổi này sẽ không ảnh hưởng đến dữ liệu cũ trước ngày 27/04/2021. Bạn vẫn sẽ dùng được số liệu chia nhỏ cho dữ liệu cũ.

Số liệu hành động

Số liệu sẽ không có sẵn trong những trường hợp sau:

• Khi có hoạt động tổng hợp trên nhiều cài đặt phân bổ
• Khi được yêu cầu với các số liệu chia nhỏ bị ảnh hưởng (hạn chế này chỉ áp dụng cho loại hành động ngoài Meta).

Lưu ý: Số liệu sẽ có sẵn nếu truy vấn bằng action_attribution_windows=1d_click,7d_click,1d_view (không bao gồm khoảng thời gian mặc định).

Số liệu tổng quát chia nhỏ

Hiện có các số liệu chia nhỏ sau đây.

Lưu ý

• Hiện không hỗ trợ lọc app_id và skan_conversion_id bằng trường filtering.
• Số liệu estimated_ad_recall_rate hoặc số liệu video_thruplay_watched_actions không có số liệu chia nhỏ dma.
• Số liệu chia nhỏ dma sử dụng phương pháp lấy mẫu để tính toán các số liệu riêng biệt như số người tiếp cận. Trong trường hợp có lượng lớn khu vực DMA nhưng dung lượng tương đối thấp, những khu vực đó có thể không được biểu thị trong mẫu hoặc có thể được mở rộng quy mô theo lũy thừa 2. Vì vậy, bạn cũng nên truy vấn số lượt hiển thị tương ứng để tăng tính chính xác.
• frequency_value chỉ được sử dụng với reach. Ví dụ: tần suất nhìn thấy quảng cáo của một người dùng.
• Theo thiết kế, các số liệu chia nhỏ image_asset và video_asset không có ở cấp độ tài khoản quảng cáo đối với các tài sản được dùng trong Nội dung động.
• Hành động đối với quảng cáovideo_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions và video_p100_watched_actions không hỗ trợ số liệu chia nhỏ region.
• Toàn bộ số liệu chia nhỏ về tài sản Nội dung động chỉ hỗ trợ một nhóm số liệu giới hạn:

Lệnh gọi sau sẽ nhóm kết quả theo age và 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"

Số liệu chia nhỏ theo giờ

Hiện tại, có thể thu được số liệu chia nhỏ về thống kê theo giờ khi sử dụng các số liệu chia nhỏ sau:

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

Hãy xem phần Kết hợp số liệu chia nhỏ để biết các giới hạn về số lượng dữ liệu chia nhỏ mà bạn có thể yêu cầu thông qua số liệu chia nhỏ theo giờ. Số liệu chia nhỏ theo giờ không hỗ trợ bất kỳ trường nào có unique_*, reach hoặc frequency ở đầu. Các trường reach và frequency sẽ trả về 0 khi số liệu chia nhỏ theo giờ đang được sử dụng.

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"

Số liệu hành động chia nhỏ

Nhóm các kết quả trong trường actions. Bạn có thể sử dụng các số liệu chia nhỏ sau cho action_breakdowns:

Sau đây là các số liệu chia nhỏ mà bạn có thể nhập vào trường 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

Nếu thông số action_breakdowns không được chỉ định, action_type sẽ tự động được thêm làm action_breakdowns.

Tổng số trong actions

Tổng số (tổng) tất cả các giá trị được trả về trong kết quả nhóm (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

Trong ví dụ này, post_engagement là tổng của link_click, comment, like và post_reaction, trong đó post_reaction là số lượng tất cả lượt bày tỏ cảm xúc, bao gồm cả lượt thích. Trường total_actions biểu thị tổng các hành động ở cấp cao nhất của một đối tượng, chẳng hạn như page_engagement, mobile_app_install và app_custom_event.

Kết hợp số liệu chia nhỏ

Do các giới hạn về lưu trữ nên bạn chỉ thực hiện được một số phép hoán đổi số liệu chia nhỏ. Các phép hoán đổi được đánh dấu hoa thị (*) có thể kết hợp với action_type, action_target_id và action_destination. Đây là tên của action_target_id.

Giới hạn

• Không thể yêu cầu các trường video_* thông qua số liệu thống kê chia nhỏ theo giờ.
• Không thể yêu cầu trường video_avg_time_watched_actions thông qua số liệu chia nhỏ theo khu vực.
• action_type sẽ tự động được thêm làm action_breakdowns khi thông số action_breakdowns không được chỉ định.