Business Management APIs

Memulai

Pelajari cara menerapkan pengelolaan aset materi iklan.

Pengelolaan Aset Materi Iklan hanya tersedia untuk mitra terpilih. Silakan hubungi Mitra Meta Anda untuk informasi selengkapnya.

Persyaratan

Untuk menggunakan API ini, Anda membutuhkan:

Izin

Setelah masuk ke aplikasi Anda, Anda harus meminta izin berikut ini kepada pengguna:

  • business_creative_management - Kelola folder materi iklan bisnis dan materi iklan bisnis. Wajib untuk semua endpoint API Pengelola Aset Materi Iklan Bisnis.
  • business_creative_insights - Akses insight aset materi iklan bisnis.
  • business_management - Kelola pengguna bisnis dan terima permintaan persetujuan kemitraan.

Batasan

  • Pengguna aplikasi (pengiklan) haruslah admin bisnis yang diwakili oleh ID pengelola bisnis

Langkah 1: Buat Folder Materi Iklan Bisnis

Buat folder materi iklan bisnis atas nama bisnis pengiklan dengan membuat permintaan POST ke endpoint {business-id}/creative_folders. Dalam kasus ini, {business-id} adalah ID bisnis pengiklan.

Izin business_creative_management diperlukan untuk tindakan ini.

Contoh Permintaan

curl -X POST \
  -F 'name={folder-name}' \
  -F 'access_token={access-token}' \
  https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/creative_folders

Contoh Tanggapan

{ “id”: “{business-creative-folder-id}” }

Anda juga dapat membuat subfolder.

Langkah 2: Tambahkan Materi Iklan ke Folder

Tambahkan aset materi iklan yang ada ke folder dengan membuat permintaan POST ke {business-id}/images atau {business-id}/videos. Anda memerlukan izin business_creative_management untuk melakukan tindakan ini.

Tambahkan Gambar

Contoh — Untuk menambahkan gambar:

curl -X POST \
  -F 'bytes={image-content-in-bytes-format}' \
  -F 'name={image-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  https://graph.facebook.com/{version}/{business-id}/images

Tanggapan

{
  "images":{
    "{image-name}":{
      "id":"{business-image-id}",
      "hash":"{hash}",
      "url":"{image-url}"
    }
  }
}

Mengunggah Video

Unggah video dalam satu permintaan, jika ukurannya kurang dari beberapa megabyte, atau unggah dalam potongan. Buat panggilan API untuk unggahan video di graph-video.facebook.com dan bukan graph.facebook.com.

Contoh — Kirim POST ke {business-id}/video dan sertakan nama video Anda, sumber, dan ID folder materi iklan bisnis.

curl -X POST \
  -F 'name={video-name}' \
  -F 'source='@{video-path}'' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  https://graph-video.facebook.com/{version}/{business-id}/videos

Tanggapan

{ 
    "success": true, 
    "business_video_id": "{business-video-id}" 
}

Mengunggah Video Terpotong

Untuk video yang lebih besar, kirimkan satu permintaan start, satu atau beberapa permintaan transfer, dan satu permintaan finish.

Untuk membuat permintaan start dan membuat sesi pengunggahan video, kirim permintaan POST ke /{business-id}/videos, atur kolom upload_phase ke start, dan tentukan file_size, dalam byte.

curl -X POST \
  -F 'title={video-name}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'access_token={access-token}' \
  -F 'upload_phase=start' \
  -F 'file_size={video_file_size_in_bytes}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Contoh Tanggapan

{
  "upload_session_id": "{session-id}",
  "business_video_id": "{business-video-id}",
  "video_id": "{video-id}",
  "start_offset": "0",
  "end_offset": "52428800"
}

Untuk mengunggah [0, 52428800] dari video Anda, potong file menjadi beberapa bagian sesuai dengan offset awal dan akhir, lalu kirimkan potongan-potongan itu dengan permintaan transfer. Kami mengirimkan offset baru untuk setiap potongan. Gunakan offset baru ini untuk mengunggah setiap potongan.

Contoh: Kirimkan potongan pertama Anda

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=transfer' \
  -F 'upload_session_id={session-id}' \
  -F 'start_offset=0' \
  -F 'video_file_chunk=@{binary-chunk-filename}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Jika berhasil, kami menanggapi dengan offset untuk potongan berikutnya:

{
 "start_offset": "52428800",    //Start byte position of the next file chunk.
 "end_offset": "104857601"      //End byte position of the next file chunk.
}

Potong dan unggah potongan kedua dengan rentang [52428800, 104857601] dari file Anda dan kirimkan:

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=transfer' \
  -F 'start_offset=52428801' \
  -F 'upload_session_id={your-upload-sesson-id}' \
  -F 'video_file_chunk={binary-chunk-filename}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Kirim semua potongan tambahan hingga start_offset sama dengan end_offset:

{
  "start_offset": "152043520",
  "end_offset": "152043520"
}

Ini berarti Anda mengunggah seluruh file. Sekarang Anda harus memposting video ini dan menutup sesi unggah.

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=finish' \
  -F 'upload_session_id={session-id}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Jika Anda menemui kesalahan selama mengunggah, Anda dapat mencoba mengunggah potongan itu lagi. Biasanya kesalahan disebabkan oleh masalah tanggapan. Ulangi unggahan Anda untuk bagian yang gagal. Untuk informasi selengkapnya tentang kesalahan, lihat:

Setelah Anda mengunggah materi iklan ke folder, pengiklan yang memiliki akses ke folder tersebut dapat membuat iklan di Pengelola Iklan atau dengan Marketing API.

Semua materi iklan yang diunggah akan muncul di Pengelola Iklan > Pemilihan Media UI. Anda dapat menggunakannya di Pembuatan Iklan dan Pengeditan Iklan. Selain itu, folder dan aset materi iklan tersedia di fitur Galeri Media Pengelola Bisnis di Pengelola Bisnis > Galeri Media.

Langkah 3: Sediakan URL Tautan Dalam ke Aset dan Buat Iklan atau Postingan

Untuk mendapatkan URL tautan dalam untuk aset tertentu, buat kueri pada kolom media_library_url dari aset gambar atau video yang diunggah:

curl -X GET \  
  -F 'access_token={partner-access-token}' \
https://graph.facebook.com/v<API_VERSION>/<asset_id>?fields=media_library_url

Untuk menggunakan tautan dalam Anda untuk membuat iklan atau posting halaman, tambahkan &action=CREATE_AD atau &action=CREATE_POST di akhir tautan:

https://business.facebook.com/asset_library/business_creatives/?object_id=<OBJECT_ID>&action=CREATE_AD