Membuat dan Menjalankan Kampanye Iklan

Halaman ini berisi langkah pembuatan kampanye iklan untuk partner terkelola (penjual) yang sudah Anda aktifkan ke iklan partner terkelola.

Sebelum Anda Memulai

Sebelum Anda membuat dan menjalankan kampanye iklan untuk partner Anda, pastikan Anda telah menyelesaikan langkah-langkah ini:

Izin yang Diperlukan

Untuk memanggil Seller Ad Creation API, pengguna membutuhkan izin berikut:

Admin Bisnis Penjual

Menargetkan Lokasi Yang Diatur DSA (Uni Eropa)

Untuk kampanye iklan yang menargetkan Uni Eropa (UE) dan/atau wilayah terkait, kolom dsa_payor dan dsa_beneficiary wajib diisi. Informasi yang diberikan dalam 2 kolom ini akan ditampilkan kepada pengguna akhir untuk menunjukkan siapa yang membayar iklan dan siapa penerima iklan tersebut.

Informasi penerima dan pembayar akan diperlukan untuk semua kampanye yang menargetkan UE dan wilayah terkait. Jika kolom tidak disediakan, pengiklan tidak akan dapat membuat kampanye MPA dan API akan menampilkan tanggapan kegagalan dengan kode kesalahan yang terdaftar di bawah.

Panggilan Seller Ad Creation API

Permintaan

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "lifetime_budget=10000&start_time=1598286074&end_time=1598286074&override_targeting_countries=['US','UK']&use_marketplace_template=true&product_set_id=<PRODUCT_SET_ID>" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

Tanggapan terhadap panggilan API segera ditampilkan dengan ASYNC_SESSION_ID. Sementara permintaan terus diproses, ASYNC_SESSION_ID harus di-polling sampai status terminal [COMPLETED|FAILED] tercapai.

Parameter

Nama	Deskripsi
`conversion_domain` string	Wajib. Mengatur domain konversi dalam alur pembuatan iklan. Kolom `conversion_domain` harus sesuai dengan konfigurasi Meta Pixel. Kolom ini hanya boleh berisi domain tingkat pertama dan kedua, dan bukan URL lengkap. Misalnya, facebook.com.
`custom_event_type` enum	Opsional. Peristiwa aplikasi yang harus dioptimalkan untuk iklan prospek dan penargetan ulang. Nilai:`CONTENT_VIEW`, `ADD_TO_CART`, `PURCHASE` Syarat: Anda hanya dapat menentukan kolom ini ketika `use_marketplace_template` adalah `true` dan `use_seller_template` adalah `false`.
`dsa_payor` string (maks. 512 karakter)	Opsional. Pembayar kampanye. Catatan: Kolom ini Wajib untuk kampanye yang menargetkan UE dan/atau wilayah terkait.
`dsa_beneficiary` string (maks. 512 karakter)	Opsional. Penerima kampanye. Catatan: Kolom ini Wajib untuk kampanye yang menargetkan UE dan/atau wilayah terkait.
`end_time` datetime	Wajib. Waktu akhir untuk kampanye iklan, dalam cap waktu UTC UNIX.
`lifetime_budget` string numerik	Wajib. Anggaran kampanye dalam mata uang akun iklan. Dalam dunia iklan, angka offset bisa 1 atau 100 (untuk mata uang dengan konsep sen). Misalnya, `lifetime_budget = 1` dalam USD (offset 100) berarti 1/100 (offset) = $0,01 (1 sen). `lifetime_budget = 1` dalam JPY (offset 1) berarti 1/1 (offset) = ¥1 (1 Yen).
`override_creative_text` string	Wajib. Isi materi iklan.
`override_targeting_countries` list<strings>	Opsional. Penargetan negara dalam kampanye. Ini mengesampingkan negara-negara yang ditetapkan selama pembuatan bisnis penjual untuk iklan prospek dan penargetan ulang.
`product_set_id` string numerik	Opsional. ID set produk dalam katalog produk penjual yang akan dipromosikan oleh kampanye ini di semua iklannya.
`start_time` datetime	Wajib. Waktu mulai untuk kampanye iklan, dalam cap waktu UTC UNIX.
`use_marketplace_template` bool	Opsional. Tentukan kolom ini untuk membuat kampanye menggunakan template default yang tersedia secara global untuk semua penjual. Syarat:`use_marketplace_template` atau `use_seller_template` harus dipakai, tetapi jangan keduanya.
`use_seller_template` bool	Opsional. Tentukan kolom ini untuk membuat kampanye menggunakan template khusus yang diterapkan untuk penjual tersebut. Syarat:`use_marketplace_template` atau `use_seller_template` harus dipakai, tetapi jangan keduanya.

Tanggapan

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

Gunakan ASYNC_SESSION_ID untuk memasukkan ID penjual yang sesuai ke iklan partner terkelola.

Lihat Cara Polling Sesi Asinkron untuk Tanggapan untuk informasi selengkapnya.

Tanggapan Berhasil

Jika statusnya adalah COMPLETED, data yang dihasilkan dari polling sesi asinkron akan terlihat seperti ini:

{
  "result": "{\"id\":\"<NEWLY_CREATED_CAMPAIGN_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

Tanggapan Kegagalan

Jika statusnya adalah FAILED, data yang dihasilkan dari polling sesi asinkron akan terlihat seperti ini:

Kode Kesalahan

Kode Kesalahan	Subkode Kesalahan	Deskripsi
1800011	2310154	Postingan materi iklan dibuat oleh aplikasi yang sedang dalam mode pengembangan. Posting tersebut harus bersifat publik agar iklan ini dapat dibuat.
1800103	2310155	Manajer Bisnis {seller_business_id} tidak memiliki segmen katalog bersama. Ini mungkin karena pengaktifan (onboarding) parsial. Anda dapat menggunakan Pusat Kolaborasi untuk berbagi aset dan menambahkan segmen katalog, atau Anda dapat menggunakan Seller Deletion API untuk mengaktifkannya kembali dengan Seller Onboarding API asinkron. Anda juga dapat menghubungi partner Meta Anda untuk mendapatkan bantuan.
1800104	2310156	ID yang Anda masukkan {product_set_id} bukan ID set produk. Masukkan ID set produk yang terkait dengan ID katalog {catalog_id}.
1800105	2310157	ID yang Anda masukkan {product_set_id} bukan ID set produk bagi segmen katalog bisnis ini. Masukkan ID set produk yang terkait dengan ID katalog {catalog_id}.
1800208	2310152	Akun iklan untuk bisnis ini dinonaktifkan karena melanggar Kebijakan Iklan kami atau standar lainnya. Untuk mempelajari lebih lanjut, buka Kemitraan dalam Pusat Kolaborasi, pilih Partner Terkelola dan tab Masalah kualitas. Anda juga dapat menghubungi partner Meta Anda untuk mendapatkan bantuan atau mengajukan banding.
1800209	2310153	Akun iklan yang dimasukkan {account_id} tidak dibuat dengan iklan partner terkelola. Masukkan ID akun yang dibuat untuk bisnis ini ketika diaktifkan untuk masuk ke iklan mitra terkelola.
1800308	2310137	Manajer Bisnis {seller_business_id} untuk bisnis ini tidak memiliki Halaman penjual. Ini mungkin karena pengaktifan (onboarding) parsial. Anda dapat menggunakan Seller Deletion API untuk menghapus penjual dan mengaktifkannya kembali dengan Seller Onboarding API asinkron. Anda juga dapat menghubungi partner Meta Anda untuk mendapatkan bantuan.
1800309	2310159	Halaman penjual untuk bisnis ini dinonaktifkan karena kemungkinan melanggar Kebijakan Iklan kami atau standar lainnya dan tidak dapat digunakan untuk menjalankan iklan. Untuk mempelajari lebih lanjut, buka Kemitraan dalam Pusat Kolaborasi, pilih Partner Terkelola dan tab Masalah kualitas. Anda juga dapat menghubungi partner Meta Anda untuk mendapatkan bantuan atau mengajukan banding.
1800400	2310161	Anggaran kampanye yang dimasukkan terlalu kecil. Sesuai template yang digunakan, anggaran harus minimal {minimum_budget}.
1800402	2310160	Jumlah anggaran prospek dan penargetan ulang yang dimasukkan tidak sama dengan 100%. Masukkan persentase anggaran untuk kampanye prospek dan persentase anggaran untuk kampanye penargetan ulang yang jumlahnya 100%. Selain itu, pastikan ada kampanye prospek dan penargetan ulang yang diidentifikasi dalam template.
1800500	2310166	Anda mencoba menggunakan API iklan partner terkelola (MPA) untuk memperbarui kampanye yang bukan kampanye MPA. Periksa kampanye yang Anda masukkan ({campaign_id}), atau gunakan API lain.
1800501	2310168	ID kampanye yang dimasukkan ({campaign_id}) bukan milik akun iklan ini. Periksa ID lalu coba lagi.
1800700	2310172	Masukkan orang atau organisasi yang membayar untuk set iklan ini.
1800701	2310171	Masukkan orang atau organisasi yang menerima set iklan ini.