Perincian Insights API

Anda dapat mengelompokkan hasil Insights API ke dalam set yang berbeda menggunakan perincian.

Insights API dapat memberikan beberapa metrik yang berupa estimasi, dalam pengembangan, atau keduanya. Nilai perincian insight adalah estimasi. Untuk informasi selengkapnya, lihat Insights API, Metrik Estimasi, dan Metrik yang Dihentikan.

Batasan

Kolom yang tidak tersedia

Kolom berikut tidak dapat diminta saat menentukan perincian:

• app_store_clicks
• newsfeed_avg_position
• newsfeed_clicks
• relevance_score
• newsfeed_impressions

Batasan untuk Metrik Tindakan di Luar Meta

Perincian berikut tidak akan lagi tersedia untuk metrik tindakan di luar Meta dengan pengecualian metrik untuk kampanye aplikasi yang secara eksklusif menargetkan Android, iOS 14.4 ke bawah, Web, dan dimodel SKAN:

Perincian Materi Iklan Dinamis

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

Jenis 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

Jenis 2

• product_id
• action_carousel_card_id/action_carousel_card_name

Aturan terkait dengan perincian di atas:

• Jenis 1 — Nilai perincian ini dimasukkan ke dalam keranjang "tidak diketahui" atau "tidak dikategorikan" (misal: untuk targetId adalah 0).
• Jenis 2 — Insights API tidak akan mengembalikan baris apa pun jika kueri berisi perincian ini bersama dengan metrik di luar situs (mis., metrik tindakan dengan perincian Jenis 2).

Catatan: Perincian yang terdaftar di atas akan tetap didukung untuk metrik di Meta seperti impresi, klik tautan, dsb. Perubahan juga tidak akan memengaruhi data historis sebelum 27 April 2021; perincian untuk data historis akan terus tersedia.

Metrik Tindakan

Metrik tidak akan tersedia dalam skenario berikut:

• Saat ada upaya agregasi di beberapa pengaturan atribusi
• Saat diminta dengan perincian yang terpengaruh (pembatasan ini hanya berlaku untuk di luar Meta & jenis tindakan).

Catatan: Metrik akan tersedia jika melakukan kueri dengan action_attribution_windows=1d_click,7d_click,1d_view (tidak termasuk periode default).

Perincian Generik

Perincian berikut tersedia.

Catatan

• Pemfilteran app_id dan skan_conversion_id menggunakan kolom filtering saat ini tidak didukung.
• Perincian dma tidak tersedia untuk metrik estimated_ad_recall_rate atau metrik video_thruplay_watched_actions.
• Perincian dma menggunakan metode sampling untuk menghitung metrik unik, seperti jangkauan. Jika ada sejumlah besar wilayah DMA dengan volume yang relatif rendah, wilayah DMA tersebut mungkin tidak terwakili dalam sampling atau dapat ditingkatkan menjadi pangkat 2. Oleh karena itu, disarankan untuk meng-kueri impresi yang sesuai demi meningkatkan akurasi.
• frequency_value digunakan hanya dengan reach. Sebagai contoh, seberapa sering seorang pengguna unik melihat iklan.
• Menurut desainnya, perincian image_asset dan video_asset tidak tersedia di level akun iklan untuk aset yang digunakan dalam Materi Iklan Dinamis.
• Tindakan iklanvideo_p25_watched_actions, video_p50_watched_actions, video_p75_watched_actions, video_p95_watched_actions, dan video_p100_watched_actions tidak mendukung perincian region.
• Semua perincian aset Materi Iklan Dinamis hanya mendukung set metrik yang terbatas:

Panggilan berikut mengelompokkan hasil berdasarkan age dan 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"

Perincian Per Jam

Kini tersedia perincian statistik per jam menggunakan perincian berikut:

• hourly_stats_aggregated_by_advertiser_time_zone
• hourly_stats_aggregated_by_audience_time_zone

Lihat Pemaduan Perincian untuk batasan mengenai jumlah perincian yang dapat Anda minta dengan perincian per jam. Perincian per jam tidak mendukung kolom unik, yang merupakan kolom dengan penambahan unique_*, reach, atau frequency. Kolom reach dan frequency akan memberikan 0 perincian per jam digunakan.

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"

Perincian Tindakan

Kelompokkan hasil di kolom actions. Anda dapat menggunakan perincian berikut untuk action_breakdowns:

Berikut ini adalah perincian yang dapat dimasukkan ke dalam kolom 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

Jika parameter action_breakdowns tidak ditentukan, action_type secara implisit ditambahkan sebagai action_breakdowns.

Jumlah Total di actions

Jumlah total (jumlah) dari semua nilai yang ditampilkan dalam hasil grup (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

Dalam contoh ini, post_engagement adalah jumlah link_click, comment, like, dan post_reaction, dengan post_reaction adalah jumlah semua tanggapan, termasuk suka. Kolom total_actions mewakili sejumlah tindakan level atas untuk sebuah objek, seperti page_engagement, mobile_app_install, dan app_custom_event.

Memadukan Perincian

Dikarenakan batasan penyimpanan, maka hanya tersedia sebagian permutasi perincian. Permutasi yang ditandai dengan tanda bintang (*) dapat digabung dengan action_type, action_target_id, dan action_destination yang merupakan nama untuk action_target_id.

Batasan

• Kolom video_* tidak dapat diminta dengan perincian statistik per jam.
• Kolom video_avg_time_watched_actions tidak dapat diminta dengan perincian wilayah.
• action_type secara implisit ditambahkan sebagai action_breakdowns saat parameter action_breakdowns tidak ditentukan.