Versi 2.11

API Marketing

Dirilis 7 November 2017 | Kiriman Blog

• Fitur Baru
• Breaking Changes
• Penghentian
• Penghentian Seketika

Fitur Baru

Desain Baru API Pengelola Bisnis

Kini kami memiliki hubungan baru yang mewakili klien dan agensi. Sebelumnya kami juga tidak memiliki user; kami menangani semua akses dan undangan ke sebuah bisnis dan aset-asetnya melalui bid/userpermissions yang menyebabkan masalah kinerja. Hal-hal yang menjadi sorotan dari API baru meliputi:

• Pengguna dalam Lingkup Bisnis - Pengguna yang baru memiliki hubungan dengan bisnis tertentu dan memiliki izin yang berada dalam lingkup ke bisnis ini. Pengguna dapat mengelola akses profil, izin, dan asetnya yang berhubungan dengan bisnis tersebut.
• Undangan - Undang orang untuk mengakses bisnis melalui endpoint yang baru. Periksa dan perbarui status undangan pengguna pada endpoint tersebut.
• Kategori Aset - Pisahkan berbagai jenis aset menjadi beberapa kategori dan sediakan endpoint terpisah untuk setiap kategori. Hal ini mempermudah penomoran halaman hasil ketika Anda membaca aset. Ini juga mengurangi masalah kinerja jika Anda mengelola ribuan aset untuk sebuah bisnis. Untuk desain baru ini, kami menambahkan beberapa endpoint baru.

Untuk mengakses pengguna di bisnis:

• BUSINESS_ID/business_users
• BUSINESS_ID/system_users
• BUSINESS_ID/pending_users

Untuk mengakses aset yang ditetapkan ke pengguna:

• BUSINESS_USER_ID/assigned_pages
• BUSINESS_USER_ID/assigned_ad_accounts
• BUSINESS_USER_ID/assigned_product_catalogs
• SYSTEM_USER_ID/assigned_pages
• SYSTEM_USER_ID/assigned_ad_accounts
• SYSTEM_USER_ID/assigned_product_catalogs
• PENDING_USER_ID/assigned_pages
• PENDING_USER_ID/assigned_ad_accounts
• PENDING_USER_ID/assigned_product_catalogs

Untuk mengakses halaman bisnis:

• BUSINESS_ID/owned_pages - Untuk mendapatkan daftar Halaman yang dimiliki bisnis
• BUSINESS_ID/client_pages - Untuk mendapatkan daftar Halaman klien bisnis
• BUSINESS_ID/pending_owned_pages - Untuk mendapatkan daftar Halaman milik bisnis yang menunggu persetujuan
• BUSINESS_ID/pending_client_pages - Untuk mendapatkan daftar Halaman milik klien bisnis yang menunggu persetujuan

Untuk mengakses akun iklan bisnis:

• BUSINESS_ID/owned_ad_accounts - Untuk mendapatkan daftar akun iklan yang dimiliki bisnis
• BUSINESS_ID/client_ad_accounts - Untuk mendapatkan daftar akun iklan klien bisnis
• BUSINESS_ID/pending_owned_ad_accounts - Untuk mendapatkan daftar akun iklan milik bisnis yang menunggu persetujuan
• BUSINESS_ID/pending_client_ad_accounts - Untuk mendapatkan daftar akun iklan milik klien bisnis yang menunggu persetujuan

Untuk mengakses katalog produk bisnis

• BUSINESS_ID/owned_product_catalogs - Untuk mendapatkan daftar katalog produk yang dimiliki bisnis
• BUSINESS_ID/client_product_catalogs - Untuk mendapatkan daftar katalog produk milik klien bisnis

Untuk mengakses aplikasi bisnis:

• BUSINESS_ID/owned_apps - Untuk mendapatkan daftar aplikasi milik bisnis
• BUSINESS_ID/client_apps - Untuk mendapatkan daftar aplikasi klien bisnis
• BUSINESS_ID/pending_client_apps - Untuk mendapatkan daftar aplikasi milik klien bisnis yang menunggu persetujuan

Untuk informasi selengkapnya, buka Pengelola Bisnis, API, Pengelola Bisnis, Pengguna Sistem, API Pengelolaan Aset Bisnis, dan API Pengelola Bisnis, Praktik Terbaik.

Iklan Karosel, Lokasi Realtime

Anda kini dapat membuat iklan karosel dengan lampiran yang menunjukkan lokasi realtime. Menambahkan opsi type=REALTIME dan location_source_id = PAGE_ID di place_data untuk AD_CREATIVE_ID/object_story_spec. Ini tersedia pada kolom object_story_spec di:

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

Kunjungan Toko, Menargetkan Lokasi Geografis

Anda kini dapat menargetkan area geografis di luar radius sekitar lokasi toko. Kami menambahkan parameter geo_locations di kolom targeting_specs ketika Anda membuat set iklan dengan kunjungan toko sebagai tujuan Anda. Jika ketersediaannya terbatas, hubungi Perwakilan Facebook untuk memperoleh akses. Lihat Tujuan Kunjungan Toko

• POST AD_ACCOUNT_ID/adsets memiliki opsi baru.
• Mendukung semua area geografis di Spesifikasi Penargetan, Lokasi kecuali penargetan berdasarkan country_groups dan menargetkan jenis lokasi travel_in.
• Membuat iklan dengan tujuan STORE_VISITS tersedia secara terbatas, lihat Kunjungan Toko

Set Iklan, Jenis Tujuan

Ini mencerminkan jenis tujuan penautan iklan; dengan kata lain, tempat yang dituju seseorang ketika orang tersebut mengeklik iklan atau ajakan bertindak yang ada di dalam iklan. Ini menyediakan jenis tujuan yang konsisten untuk semua iklan di dalam set iklan, sehingga iklan hanya memuat jenis materi iklan yang berbeda-beda. Lihat Set Iklan, Jenis Tujuan.

• Ditambahkan destination_type untuk set iklan
• Tersedia di /ADSET_ID

Indikator Kinerja Kunci

Ditambahkan kolom baru kpi_type ke AD_ACCOUNT_ID/CAMPAIGN_ID yang menjelaskan jenis indikator kinerja kunci yang ingin Anda lacak untuk kampanye maupun objek iklan di dalam kampanye. Untuk melihat data wawasan berdasarkan kpi_type dalam kpi_results membuat panggilan ini:

• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights

Untuk informasi selengkapnya, lihat Kampanye Iklan, Referensi.

Breaking Changes

Pengelolaan Iklan

• Menghapus penargetan iklanright_hand_column - Iklan yang menargetkan posisi ini dengan materi iklan yang tidak valid untuk right_hand_column di AD_ACCOUNT_ID/adsets akan menghasilkan kesalahan. Kami tidak memperbolehkan penempatan right_hand_column saja dengan format iklan video, koleksi, atau canvas. Untuk penempatan right_hand_column saja, Anda hanya dapat menggunakan format gambar tunggal dan karosel.

• GET VERSION/RF_PREDICTION_ID/pause_periodsDiubah - Untuk mengembalikan Array saat ini, bukan String untuk memungkinkan penanganan yang lebih mudah.

API Pengelola Bisnis

• Penamaan ulang kolom — Kolom admin_system_user telah diubah namanya menjadi admin, dan kolom system_user telah diubah namanya menjadi employee. Ini berdampak pada edge berikut:

  • /{business-id}/userpermissions
  • /{business-id}/system_users

Penghentian

Pengelolaan Iklan

Penghentian pengoptimalan untukVIDEO_VIEWS - Kampanye dengan tujuan VIDEO_VIEWS tidak lagi dapat menggunakan CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT, atau REACH sebagai tujuan pengoptimalan:

• Membuat set iklan dengan tujuan pengoptimalan ini akan menghasilkan kesalahan.
• Duplikasi set iklan dengan tujuan pengoptimalan REACH secara otomatis dikonversikan ke tujuan pengoptimalan VIDEO_VIEWS.
• Menduplikasi set iklan dengan CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, atau POST_ENGAGEMENT sebagai tujuan pengoptimalan akan menghasilkan kesalahan. Ini karena pembuatan atau duplikasi iklan di dalam set iklan yang sudah ada berupaya untuk menggunakan kembali salah satu tujuan pengoptimalan ini.

Edge yang dipengaruhi oleh perubahan ini:

• POST ACCOUNT_ID/adsets
• POST AD_ACCOUNT_ID/ads
• POST CAMPAIGN_ID/copies
• POST ADSET_ID/copies
• POST AD_ID/copies

Dihentikanreach - Sebagai optimization_goal untuk tujuan brand awareness. Dihapus untuk atau /adset; hanya tersedia untuk pengoptimalan ad recall saja. Hal ini untuk tidak menyebabkan kebingungan bagi siapa pun yang menggunakan jangkauan sebagai tujuan.

Pengoptimalan dihentikanBRAND_AWARENESS - Diganti oleh AD_RECALL_LIFT. Ini mencerminkan model penayangan iklan baru yang lebih efisien. Tujuan pengoptimalan yang baru ini mendukung materi iklan campuran, seperti iklan statis dan iklan video di dalam set iklan dan tawaran manual yang sama. BRAND_AWARENESS tidak lagi tersedia di:

• POST /ADSET_ID
• GET /ADSET_ID
• POST /AD_ACCOUNT_ID/adsets

Dihentikanfrequency_cap - Termasuk kolom lifetime_frequency_cap dan frequency_cap_reset_period di:

• POST AD_ACCOUNT_ID/adsets
• GET /ADSET_ID
• POST /ADSET_ID

Anda dapat menggunakan frequency_control_specs.

Biaya per tindakan yang dihentikanPOST_ENGAGEMENT - Anda tidak lagi dapat menggunakan POST_ENGAGEMENT sebagai billing_event untuk tujuan ini. Ini akan menyelaraskan penayangan iklan dan pengukuran dengan lebih baik. Ini akan berdampak pada endpoint: /AD_SET_ID.

Wawasan Iklan dan Pengukuran

Dihentikanvideo_15_sec_watched_actions di:

• GET AD_ACCOUNT_ID/insights
• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights
• POST AD_ACCOUNT_ID/insights
• POST CAMPAIGN_ID/insights
• POST ADSET_ID/insights
• POST AD_ID/insights

Dihentikanrecurrence_value - Dari API Pengukuran Lanjutan. Kolom ini juga dikenal di API Atlas sebagai jadwal laporan. Kami menggantinya dengan recurrence_values. Lihat Pengukuran Lanjutan, Jadwal Laporan.

Pengelolaan Bisnis

Endpoint yang dihentikan untuk desain ulang API Pengelola Bisnis:

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

Endpoint yang dihentikan untuk mengelola aset Anda:

• BUSINESS_ID/pages
• BUSINESS_ID/adaccounts
• BUSINESS_ID/product_catalogs
• BUSINESS_ID/apps

Untuk menerima aset, gunakan BUSINESS_ID/owned_ASSET atau BUSINESS_ID/client_ASSET

Endpoint yang dihentikan untuk mengelola aset milik bisnis lain:

• BUSINESS_ID/assigned_ad_accounts
• BUSINESS_ID/assigned_pages
• BUSINESS_ID/assigned_product_catalogs

Sebagai gantinya, gunakan BUSINESS_USER_ID/assigned_ASSET

Penghentian Seketika

Penghentian ini berlaku untuk semua versi API dan akan mulai berlaku pada 14 November 2017.

Iklan Acara dan Iklan Tautan

Dihentikan membuat dan menyunting Iklan Peristiwa atau Iklan Tautan yang tidak terhubung ke halaman yang valid. Format berikut tidak lagi valid dan akan menghasilkan kesalahan.

Tanda tangan yang tengah dihentikan:

• Iklan Acara

  • Tujuan: EVENT_RESPONSES
  • Kolom materi iklan: body, object_id
• Iklan Tautan

  • Tujuan: LINK_CLICKS
  • Kolom materi iklan: title, body, object_url (image_file atau image_hash)

Tanda tangan yang didukung

• Iklan Acara

  • Tujuan: EVENT_RESPONSES
  • Kolom materi iklan: object_story_id atau object_story_spec
• Iklan Tautan

  • Tujuan: LINK_CLICKS
  • Kolom materi iklan: object_story_id atau object_story_spec

Iklan Acara dan Tautan yang sudah Anda buat sebelumnya akan terus berjalan, namun Anda tidak dapat memodifikasi materi iklannya atau membuat iklan baru setelah perubahan ini berlaku, jika tidak maka Anda akan menerima kesalahan. Lihat Iklan Acara dan Lokal dan Iklan, Referensi.