Marketing API

Iklan Reels

Buat iklan Meta dengan fokus pada penempatan reels yang tersedia dan pelajari praktik terbaik tentang operasi iklan kami.

Prasyarat

  • Anda sebelumnya telah membuat aplikasi Facebook
  • Anda sudah familier dengan Marketing API dan telah mengaktifkan Facebook Login

Jika Anda tidak memenuhi prasyarat tersebut, silakan baca dokumentasi developer kami.

Pengujian Sandbox

Meta menawarkan lingkungan pengujian, yang sebenarnya tidak menayangkan iklan, tetapi memungkinkan Anda untuk:

  • Menambahkan Marketing API sebagai produk dalam aplikasi Meta Anda di bagian Alat untuk membuat dan mengedit iklan menggunakan API kami tanpa dikenakan biaya
  • Membuat akun iklan untuk menggunakan Marketing API

Baca praktik terbaik pengujian kami.

Langkah 1: Akses Aset

Token akses adalah string buram yang mengidentifikasi pengguna, aplikasi, atau Halaman, dan dapat digunakan oleh aplikasi untuk melakukan panggilan Graph API. Anda dapat melihat kapan kedaluwarsanya dan aplikasi mana yang membuatnya. Panggilan Marketing API pada aplikasi Meta perlu menyertakan token akses.

Dapatkan token akses dengan izin yang diperlukan:

  • ads_management: buat perubahan pada akun iklan yang dipilih

  • ads_read: bacakan data iklan

  • read_insights: bacakan insight kinerja

Gunakan token akses sistem karena memiliki waktu kedaluwarsa yang lebih lama.

Lapisan Otorisasi Tambahan

Untuk mengakses endpoint Marketing API, Anda perlu membuat aplikasi Bisnis. Mereka tunduk pada layer tambahan otorisasi Graph API yang disebut sebagai level akses. Selama Tinjauan Aplikasi, aplikasi Anda juga harus meminta izin dan fitur khusus. Anda harus menyelesaikan Verifikasi Bisnis jika aplikasi Anda akan digunakan oleh pengguna aplikasi yang tidak memiliki peran di aplikasi itu sendiri, atau peran dalam Bisnis yang telah mengeklaim aplikasi tersebut.

Jika aplikasi Anda mengelola akun iklan orang lain, Anda harus:

  • ads_read akses lanjutan

dan/atau

  • ads_management akses lanjutan

Langkah 2: Ambil Akun Iklan

Ambil akun iklan pengiklan Anda dan biarkan mereka memilih salah satu untuk pembuatan iklan.

Melalui API Pengelolaan Bisnis kami, Anda dapat melihat semua akun iklan yang dapat diakses oleh bisnis mereka. Ini menampilkan semua akun iklan yang dimiliki oleh suatu bisnis. Perhatikan bahwa Anda memerlukan izin business_management di level aplikasi dan pengguna. Baca API Pengelolaan Aset Bisnis.

Contoh Panggilan

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v21.0/<BUSINESS_ID>/owned_ad_accounts"

Langkah 3: Buat Kampanye

Kampanye adalah struktur organisasi level tertinggi dalam akun iklan dan harus mewakili satu tujuan untuk pengiklan. Objek ini berisi tujuan iklan Anda dan satu atau lebih set iklan. Hal ini membantu Anda mengoptimalkan dan mengukur hasil untuk setiap tujuan iklan. Pelajari selengkapnya tentang membuat, membaca, memperbarui, dan menghapus kampanye di sini.

Contoh Panggilan

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Langkah 4: Definisi Target

Untuk memungkinkan pengiklan menjangkau kelompok tertentu, tentukan parameter ini dalam permintaan API Anda:

  • demografi (usia, jenis kelamin, lokasi)
  • minat
  • perilaku

Kemudian calon pelanggan yang kemungkinan besar berminat dengan produk atau layanan Anda akan dijangkau.

Contoh Panggilan

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=My Custom Audience' \
  -F 'subtype=CUSTOM' \
  -F 'description=People who live in New York, aged 25-40, interested in technology' \
  -F 'customer_file_source=USER_PROVIDED_ONLY' \
  -F 'targeting_spec={
        "geo_locations": {
          "countries": ["US"],
          "regions": [{"key": "4081"}]  # New York region key
        },
        "age_min": 25,
        "age_max": 40,
        "interests": [{"id": "6003139266461", "name": "Technology"}]
      }' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/customaudiences

Langkah 5: Buat Set Iklan

Set iklan bisa berisi satu atau lebih iklan. Iklan dalam set iklan harus memiliki penargetan, anggaran, tagihan, tujuan pengoptimalan, dan durasi yang sama.

Anda dapat mengatur anggaran, jadwal, penargetan, strategi tawaran, dan opsi penempatan. Set iklan memungkinkan penyesuaian bagaimana dan di mana iklan ditayangkan kepada segmen pemirsa tertentu, mengoptimalkan kinerja, dan mencapai tujuan marketing.

Parameter utama:

  • kriteria penargetan pemirsa
  • anggaran harian atau sepanjang masa promosi
  • opsi penjadwalan untuk mengontrol kapan iklan ditampilkan

Detail selengkapnya di sini.

Anda dapat memilih penempatan manual yang menyertakan iklan reel Instagram dan Facebook, atau penempatan otomatis default. Jika Anda tidak menentukan apa pun untuk kolom penempatan tertentu, semua posisi default yang mungkin untuk kolom itu akan dipertimbangkan.

Contoh Panggilan

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=Reels Ad Set' \
  -F 'campaign_id=YOUR_CAMPAIGN_ID' \
  -F 'daily_budget=5000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=REACH' \
  -F 'start_time=2024-07-10T10:00:00-0700' \
  -F 'end_time=2024-07-20T10:00:00-0700' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"age_min":18,"age_max":65}' \
  -F 'promoted_object={"page_id":"YOUR_PAGE_ID"}' \
  -F 'status=PAUSED' \
  -F 'instagram_actor_id=YOUR_INSTAGRAM_ACTOR_ID' \
  -F 'publisher_platforms=["instagram"]' \
  -F 'instagram_positions=["reels"]' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/adsets

Penargetan Penempatan: Posisi Reels yang Tersedia, Tujuan yang Kompatibel, dan Tujuan Pengoptimalan

publisher_platformsfacebook_position atau instagram positionTujuan yang Kompatibeloptimization_goal
instagram

reels, profile_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

instagram

reels, profile_reels

 OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

instagram

reels, profile_reels

 OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

instagram

reels, profile_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

VISIT_INSTAGRAM_PROFILE

instagram

reels, profile_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

POST_ENGAGEMENT

REACH

IMPRESSIONS

REMINDERS_SET

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

instagram

reels, profile_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

facebookfacebook_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

facebookfacebook_reels

OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

facebookfacebook_reels

OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

facebookfacebook_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

QUALITY_CALL

facebookfacebook_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

POST_ENGAGEMENT

REACH

IMPRESSIONS

EVENT_RESPONSES

QUALITY_CALL

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

PAGE_LIKES

facebookfacebook_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

QUALITY_CALL

Batasan

Tujuan yang Kompatibel + Kombinasi optimization_goal FB Reels Memenuhi Syarat? IG Reels Memenuhi Syarat?

OUTCOME_AWARENESS + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_TRAFFIC + VISIT_INSTAGRAM_PROFILE

❌

✅

OUTCOME_TRAFFIC + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_ENGAGEMENT + EVENT_RESPONSES

✅

❌

OUTCOME_ENGAGEMENT + REMINDERS_SET

❌

✅

OUTCOME_ENGAGEMENT + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + PAGE_LIKES

✅

❌

OUTCOME_SALES + QUALITY_CALL

✅

❌

Langkah 6: Pilih Materi Iklan

Materi iklan adalah komponen visual dan tekstual dari iklan, yang mendukung format iklan berikut:

  • gambar
  • video
  • carousel
  • memungkinkan desain iklan khusus

Otomatiskan elemen desain dan optimalkan kinerja menggunakan proses materi iklan kami.

Menggunakan Kembali Reel yang Ada sebagai Materi Iklan

Pengguna dapat menyediakan aset baru atau menggunakan kembali reel yang ada dari akun Instagram mereka sebagai materi iklan.

Anda dapat membuat iklan dari reels Instagram atau Facebook organik yang sudah ada dan memenuhi syarat untuk dipromosikan, dengan syarat:

  • Kurang dari 90 detik
  • Memiliki rasio aspek vertikal layar penuh (9:16)
  • Bebas dari musik berhak cipta, GIF, stiker interaktif, atau filter kamera dari pihak ketiga
  • Tidak dibagikan ke Facebook

Untuk menggunakan kembali reel Instagram organik sebagai materi iklan untuk kampanye iklan baru:

  1. Dapatkan ID akun Instagram Business, yang harus dihubungkan ke Halaman Facebook

    • GET/{ad_account_id}/connected_instagram_accountsatau
    • GET/{business_id}/instagram_business_accounts

  2. Temukan Reel yang Ingin Anda Promosikan

    • GET/{ig-business-account-user-id}/media

  3. Sediakan Materi Iklan

    • Daripada menentukan instagram_actor_id dalam spesifikasi materi iklan, atur instagram_user_id sebagai ID pengguna Instagram
    • Tentukan source_instagram_media_id sebagai ID media
    • Atau, perbarui call_to_action untuk promosi Anda

Manfaatkan boost_eligibility_info sebagai cara mudah untuk menentukan apakah media memenuhi syarat untuk dipromosikan sebagai iklan dan boost_ads_list untuk melacak informasi terkait iklan Instragram yang dipromosikan sebelumnya.

Contoh Panggilan

curl -i -X POST \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives?object_id=<PAGE_ID>
&instagram_user_id=<IG_USER_ID>
&source_instagram_media_id=<IG_ORGANIC_MEDIA_ID>
&call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}"
&access_token=<API_ACCESS_TOKEN>

Buat Toolbox Materi Iklan AI

Anda dapat mengotomatiskan pembuatan elemen iklan yang beragam dan menarik, seperti: gambar, video, dan teks. Alat-alat berbasis AI ini membantu mengoptimalkan kinerja iklan dengan menyesuaikan konten dengan preferensi pemirsa dan meningkatkan variasi materi iklan. Pembuatan iklan akan menghasilkan interaksi yang lebih tinggi dan kampanye yang lebih baik.

Langkah 7: Pratinjau Iklan

Pratinjau iklan dalam format Facebook dan Instagram Reels yang ditabulasikan di bawah menggunakan:

  • ID Iklan
  • ID Materi Iklan
  • Spesifikasi Materi Iklan
PLATFORM PENERBITAN Format Iklan

Facebook

DESKTOP_FEED_STANDARD, FACEBOOK_STORY_MOBILE, INSTANT_ARTICLE_STANDARD, INSTREAM_VIDEO_DESKTOP, INSTREAM_VIDEO_MOBILE, MARKETPLACE_DESKTOP, MARKETPLACE_MOBILE, MOBILE_FEED_BASIC, MOBILE_FEED_STANDARD, RIGHT_COLUMN_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE, WATCH_FEED_MOBILE, FACEBOOK_REELS_BANNER, FACEBOOK_REELS_BANNER_DESKTOP, FACEBOOK_REELS_MOBILE, FACEBOOK_REELS_POSTLOOP, FACEBOOK_REELS_STICKER, FACEBOOK_STORY_STICKER_MOBILE, WATCH_FEED_HOME

Instagram

INSTAGRAM_STANDARD, INSTAGRAM_STORY, INSTAGRAM_EXPLORE_CONTEXTUAL, INSTAGRAM_EXPLORE_IMMERSIVE, INSTAGRAM_EXPLORE_GRID_HOME, INSTAGRAM_FEED_WEB, INSTAGRAM_FEED_WEB_M_SITE, INSTAGRAM_PROFILE_FEED, INSTAGRAM_REELS, INSTAGRAM_REELS_OVERLAY, INSTAGRAM_SEARCH_CHAIN, INSTAGRAM_SEARCH_GRID, INSTAGRAM_STORY_CAMERA_TRAY, INSTAGRAM_STORY_WEB, INSTAGRAM_STORY_WEB_M_SITE

Contoh Panggilan

curl -X POST \
  'https://graph.facebook.com/v21.0/act_{ad_account_id}/adpreviews' \
  -F 'access_token={your_access_token}' \
  -F 'creative={
        "object_story_spec": {
            "instagram_actor_id": "{instagram_actor_id}",
            "video_data": {
                "video_id": "{video_id}",
                "title": "Check out our new product!",
                "description": "Exciting new features and benefits.",
                "call_to_action": {
                    "type": "LEARN_MORE",
                    "value": {
                        "link": "https://www.example.com/product"
                    }
                }
            }
        }
    }' \
  -F 'ad_format=INSTAGRAM_REELS'

Langkah 8: Jadwalkan Penayangan Iklan

Untuk memesan iklan menggunakan marketing API, buat objek grup iklan dan tautkan objek set iklan Anda ke Materi Iklan. Gunakan /act_{ad_account_id}/ads untuk mengirimkan objek Iklan Anda, dan validasi tanggapan untuk mengonfirmasi pemesanan yang berhasil. Langkah ini menyelesaikan penyiapan iklan Anda, membuatnya siap ditayangkan berdasarkan konfigurasi yang disediakan.

Contoh Panggilan

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Langkah 9: Tinjau Kinerja

Gunakan Insight API untuk mengambil metrik dari akun iklan ke iklan:

  • act_<AD_ACCOUNT_ID>/insights
  • <CAMPAIGN_ID>/insights
  • <ADSET_ID>/insights
  • <AD_ID>/insights

Saat menjalankan kampanye di Instagram dan Facebook, tambahkan breakdowns=publisher_platform untuk melihat statistik penempatan Facebook dan Instagram secara terpisah, seperti yang ditunjukkan dalam contoh panggilan di bawah. Saat memerinci insight berdasarkan level Penempatan, dimungkinkan untuk melihat bagaimana kinerja iklan melalui penempatan Instagram dan Facebook Reels.

Contoh Panggilan

curl -X GET \
  'https://graph.facebook.com/v21.0/{ad_account_id}/insights' \
  -F 'access_token={your_access_token}' \
  -F 'level=campaign' \
  -F 'fields=campaign_name,impressions,clicks,spend' \
  -F 'breakdowns=publisher_platform,platform_position' \
  -F 'filtering=[{"field":"platform_position","operator":"IN","value":["instagram_reels"]}]' \
  -F 'time_range={"since":"2024-06-01","until":"2024-06-30"}'

Pertimbangan Penting

Tujuan Baru yang Didukung di ODAX (Validasi Tujuan Pengalaman Iklan Berbasis Hasil)

  • OUTCOME_APP_PROMOTION
  • OUTCOME_AWARENESS
  • OUTCOME_ENGAGEMENT
  • OUTCOME_LEADS
  • OUTCOME_SALES
  • OUTCOME_TRAFFIC

Batas Laju

Marketing API memiliki logika pembatasan laju sendiri dan dikecualikan dari semua pembatasan laju Graph API. Fitur yang memengaruhi kuota batas laju Marketing API adalah Akses Standar Pengelolaan Iklan. Secara default, Anda mendapatkan Akses Standar saat menambahkan produk Marketing API ke Dasbor Aplikasi Anda, yang memberi Anda akses pengembangan ke Marketing API. Untuk meningkatkan kuota pembatasan laju, tingkatkan ke Advanced Access.

Dasar-Dasar Materi Iklan

Iklan Reels mengubah perhatian menjadi tindakan sehingga bisa melejitkan hasil. Saat Anda membuatnya dengan cara yang benar, mereka akan menjadi lebih efektif.

1. Buat video 9:16 untuk membuat video Anda menarik: Reels adalah format video layar penuh yang imersif. Untuk membantu materi iklan Anda sesuai dengan format Reels, pertimbangkan untuk memulai dengan video dan mengubah ukurannya menjadi 9:16.

2. Buat zona aman agar pesan Anda jelas: Kerjakan di dalam zona aman agar overlay stiker teks, ajakan bertindak, atau pesan utama tidak terhalang oleh antarmuka pengguna Reels. Kosongkan 35% bagian bawah materi iklan 9:16 Anda dari teks, logo, dan elemen utama lainnya.

3. Buat dengan suara untuk membuat video Anda menghibur: Audio – baik itu musik, alih suara, maupun efek suara – adalah pendorong utama interaksi dan hiburan di Reels.