Versi 3.0

Marketing API

Dirilis 1 Mei 2018 | Tersedia Hingga 1 Februari 2019 | Postingan Blog

• Fitur Baru
• Perubahan Penting
• Penghentian
• Penghentian Segera

Fitur Baru

Strategi Penawaran Biaya Terendah, Kolom bid_strategy

Kami memperkenalkan kolom baru bid_strategy untuk {account-id}/adsets yang memungkinkan Anda memilih strategi penawaran iklan berdasarkan tujuan bisnis Anda. Tiap strategi memiliki keunggulan dan kelemahan. Opsinya mencakup:

• LOWEST_COST - Dapatkan hasil terbanyak berdasarkan anggaran yang ditetapkan dan penayangan iklan optimization_goal. Facebook akan secara otomatis menawar lebih sesuai kebutuhan untuk menghabiskan anggaran Anda. Anda dapat memberikan maksimum penawaran atau tidak memberikan batas dengan opsi ini.

• TARGET_COST - Memberikan biaya rata-rata yang stabil untuk iklan seiring dengan peningkatan anggaran iklan yang Anda tetapkan.

Untuk informasi selengkapnya, lihat Pembelian dan Pengoptimalan Iklan, Strategi Penawaran.

Iklan Koleksi, Pembuatan

API baru untuk Membuat Iklan Koleksi - Dahulu, Facebook membuat canvas di latar belakang tiap kali Anda membuat iklan koleksi. Hal ini membatasi akses Anda ke canvas yang berada di latar belakang. Anda tidak dapat menggunakannya untuk menargetkan ulang pemirsa dengan pemirsa interaksi canvas. Kini saat membuat iklan koleksi dari set produk, Anda juga harus secara eksplisit membuat canvas dengan elemen yang tepat. Saat Anda menggunakan canvas ini dalam iklan koleksi, Facebook secara otomatis membuat iklan koleksi. Untuk detail selengkapnya, lihat Iklan Koleksi dari Set Produk.

Perubahan Penting

Pengelolaan Iklan

• Invalidasi Kolom Kanan - Kami membuat tidak valid iklan yang hanya menargetkan posisi Facebook, right_hand_column dengan objek yang tidak valid untuk right_hand_column di {ad_account_id}/adsets. Kami sekarang hanya mendukung penempatan kanan untuk format iklan yang didukung dengan tujuan ini: Traffic, Konversi, dan Penjualan Katalog Produk.

• is_autobid and is_average_price_pacing dihentikan dalam GET dan POST pada v3.0 dan lebih baru.

Pemirsa dan Penargetan Iklan

• Perubahan Sintaks Aturan untuk Pemirsa Khusus - Kami memperbarui struktur aturan yang digunakan untuk membuat pemirsa khusus situs web, pemirsa khusus aplikasi seluler, pemirsa khusus interaksi halaman, pemirsa interaksi iklan prospek, pemirsa interaksi canvas, dan pemirsa khusus offline. Ini memungkinkan Anda untuk membuat aturan berdasarkan perilaku agregat, aturan dari sumber peristiwa yang berbeda-beda, dan untuk mengecualikan aturan. Lihat:

  • Pemirsa Khusus dari Situs Web Anda, Aturan Pemirsa,

  • Pemirsa Khusus dari Aplikasi Seluler Anda, Aturan Pemirsa,

  • Pemirsa Khusus Interaksi Halaman,

  • Pemirsa Interaksi untuk Iklan Prospek

  • Pemirsa Interaksi untuk Canvas dan

  • Pemirsa Khusus dari Konversi Offline.

Iklan Dinamis

• Akses Katalog Produk - Untuk mengakses item katalog, Anda harus menentukan vertikal katalog yang tepat. Jika permintaan tidak cocok dengan vertikal yang tepat untuk katalog, Anda akan mendapatkan kesalahan. Misalnya, jika Anda memiliki katalog ecommerce, sebaiknya akses dengan endpoint /products yang sesuai, seperti GET {catalog_id}/products, GET {product_feed_id}/products, atau GET {product_set_id}/products. Anda tidak dapat mengakses katalog dengan endpoint untuk vertikal lain seperti GET {catalog_id}/autos, GET {product_feed_id}/hotels, atau GET {product_set_id}/flights.

• String Kosong dalam Tanda Template - Kami tidak mengizinkan string kosong lagi sebagai paramater untuk Iklan Dinamis, opsi tanda template. Misalnya, jika Anda meneruskan string kosong ke {{trip.checkin_date date_format:}} Anda mendapatkan kesalahan. Untuk mengetahui info latar belakang, lihat Iklan Dinamis, Pengelolaan Iklan.

Wawasan Iklan dan Pengukuran

• Waktu Habis Wawasan - Jika kami mengharapkan permintaan Insights API mengakibatkan waktu habis sebelum selesai, kami mengembalikan kesalahan dengan kode kesalahan 100 dan subkode 1504033. Kami memperkirakan ini berdasarkan ukuran permintaan dan kemajuan pemrosesan yang dibuat sesuai dengan batas waktu habis. Jika Anda mendapatkan kesalahan ini, sebaiknya lakukan permintaan Insights API asinkron untuk data ini. Lihat Pekerjaan Asinkron Insights API.

• Nilai Negatif dalam Data Peristiwa - Jika Anda memposting data peristiwa ke {data_set_id}/events dengan nilai negatif, ini akan gagal. Ini berdampak pada kolom data untuk POST /{data_set_id-id}/events.

• Wawasan tentang Pengoptimalan Anggaran Kampanye - adset_budget_value sekarang mengembalikan using campaign budget saat kampanye iklan menggunakan pengoptimalan anggaran kampanye. Ini berdampak pada:

  • GET {adaccount-id}/insights,

  • GET {campaign-id}/insights,

  • GET {adset-id}/insights,

  • GET {ad-id}/insights,

  • POST {adaccount-id}/insights,

  • POST {campaign-id}/insights,

  • POST {adset-id}/insights,

  • POST {ad-id}/insights.

• Pengurutan Default untuk Piksel - Jika Anda memanggil edge GET {account_id}/adspixel di akun bisnis atau akun iklan, kami mengembalikan hasil yang diurutkan secara default, menurut nama piksel, bukan waktu pengaktifan piksel terakhir.

• Ganti nama kolom statistik piksel - Kami mengganti nama kolom timestamp di edge statistik piksel menjadi start_time. Ini mewakili waktu mulai saat kami mulai menggabungkan data per jam pada pengaktifan piksel. Kami sekarang mengembalikannya dalam format ISO 8601 dan menyertakan offset zona waktu. Ini memperbaiki masalah saat kami mengembalikan cap waktu Unix yang tidak valid. Ini memengaruhi endpoint berikut: GET {ads-pixel-id}/stats

Penghentian

Pengelola Bisnis

Menghentikan endpoint POST {pixel-id}/shared_agencies. Harap gunakan UI Pengelola Bisnis untuk membagikan piksel iklan ke agensi.

Pengelolaan Iklan

• Menghentikan kpi_custom_conversion_id, kpi_type, dan kpi_results dari /{ad_campaign_id} dan /ad_account_ID/campaigns.

• Menghentikan bendera `unduh ulang` dari endpoint berikut untuk menyederhanakan API:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  Anda tetap dapat membaca informasi ini dengan parameter `kolom`.

• Menghentikan kolom zipbytes dari POST act_{ad-account-id}/adimages dan menghapus kemampuan untuk mengunggah file ZIP di edge tersebut. Harap gunakan gambar dengan ekstensi: jpg, jpeg, gif, bmp, png, tiff, atau tif.

• Menghentikan metode saat ini untuk membuat iklan koleksi yang menggunakan satu panggilan API dengan semua aset yang diperlukan sebagai parameter. Anda sekarang perlu membuat canvas terlebih dahulu, lalu menggunakan tautan canvas untuk membuat iklan koleksi. Ini memungkinkan Anda mengakses objek canvas yang ada di latar belakang agar Anda dapat, misalnya, menargetkan ulang pemirsa. Lihat Iklan Koleksi.

• Menghentikan format iklan Carousel untuk iklan dengan tujuan Interaksi Postingan Halaman. Kombinasi ini tidak valid lagi. Lihat Validasi, Tujuan, dan Materi Iklan

Pembelian dan Penawaran Iklan

• Menghentikan kolom is_autobid dan is_average_price_pacing dari endpoint: POST {ad-account-id}/adsets dan POST {adset-id}. Gunakan kolom bid_strategy baru untuk menentukan strategi penawaran tertentu untuk set iklan. Untuk informasi selengkapnya, lihat Penawaran dan Pengoptimalan.

• Menghentikan kolom di bawah delivery_estimate untuk iklan dan akun iklan. Hasilnya tidak memenuhi kebutuhan pengiklan. Selain itu, banyak pengiklan memilii tujuan bisnis yang mungkin tidak terpenuhi dengan baik oleh jumlah tawaran yang disarankan Facebook. Kolom dan parameter yang dihentikan mencakup:

  • Kolom bid_estimate,

  • parameter currency,

  • parameter daily_budget,

  • parameter optimize_for

  Kami merekomendasikan Anda menggunakan nilai bisnis intrinsik yang tepat yang Anda dapatkan dari iklan dan tawaran Facebook berdasarkan ini. Jika Anda belum mengetahui nilai ini, kami menyarankan Anda menggunakan tawaran otomatis. Untuk latar belakang, lihat Pusat Bantuan Iklan, Lelang Iklan dan Pembelian dan Pengoptimalan Iklan.

• Hasil yang dihentikan, yang dikembalikan dari kolom curve_budget_reach di GET /{rf-prediction-id}. Kami sekarang mengembalikan peta, dan menghentikan nilai pengembalian string seri JSON. Ini berdampak pada:: GET /{rf-prediction-id}.

• Menghentikan edge GET /{ad-account-id}/ratecard.

• Menghentikan beberapa kolom yang terkait dengan penagihan pada /ad_accounts. Ini mencakup:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• Menghentikan kolom pixel_id dan external_event_sourceGET /customaudience.

Wawasan Iklan dan Pengukuran

• Menghentikan matched_unique_users di OFFLINE_EVENT_SET_ID dikembalikan oleh GET /{data-set-id} dan GET /{data-set-upload-id}. Lihat API Konversi Offline.

• Menghentikan edge attributed_events dan kolom attribute_stats di GET /{data_set_id} API. Gunakan API GET /{data_set_id}/stats untuk mendapatkan statistik peristiwa teratribusi.

• Menghentikan kolom matched_unique_users di OFFLINE_EVENT_SET_ID yang dikembalikan oleh GET /{data-set-id} dan DAPATKAN /{data-set-upload-id}.

• Menghentikan nilai pengembalian default pada GET {data_set_upload_id}. Ini tidak mengembalikan kolom-kolom ini lagi secara default: first_upload_time, last_upload_time, api_calls, valid_entries, matched_entries, duplicate_entries, event_time_min, event_time_max, event_stats, dan matched_unique_users.

• Menghentikan nilai pengembalian default pada GET {data_set_id}/stats. Ini sekarang hanya mengembalikan statistik jumlah secara default. Untuk menentukan statistik mana yang harus dikembalikan, gunakan parameter fields atau parameter summary untuk statistik kumulatif seperti average_upload_delay.

• Menghentikan nilai pengembalian default untuk GET {data_set_id}. Ini tidak mengembalikan kolom-kolom ini lagi secara default: attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage, valid_entries.

• Menghentikan edge GET {data-set-upload-id}/stats. Harap gunakan kolom valid_entries atau matched_entries dari GET {data-set-upload-id}.

• Menghentikan canvas_component_avg_pct_view dari Insights API.