Iklan yang Mengeklik ke Multidestinasi

Panduan ini menjelaskan cara membuat dan menerbitkan iklan yang mengeklik ke multidestinasi menggunakan Marketing API.

Iklan yang mengeklik ke multidestinasi mengarahkan orang yang mengeklik iklan Anda langsung ke percakapan dengan bisnis Anda di aplikasi berkirim pesan atau aplikasi (Messenger, Instagram, atau WhatsApp) yang kemungkinan besar akan mereka tanggapi. Gunakan iklan ini untuk menjangkau orang dalam skala besar dan memberikan layanan individual yang menonjol.

Iklan multidestinasi berarti iklan dapat masuk ke kombinasi destinasi apa pun: obrolan Messenger, obrolan Instagram, obrolan WhatsApp.

Jika Anda ingin membuat iklan yang hanya masuk ke satu destinasi, lihat:

• Iklan yang Mengeklik ke Messenger
• Iklan yang Mengeklik ke Instagram
• Iklan yang Mengeklik ke WhatsApp

Ringkasan Pembuatan Iklan

Dokumen ini menjelaskan langkah-langkah yang perlu diikuti untuk menyiapkan integrasi Anda untuk iklan klik ke multidestinasi. Anda akan perlu:

1. Membuat kampanye iklan
2. Membuat set iklan yang menautkan iklan Anda ke kampanye iklan Anda
3. Membuat materi iklan untuk jenis iklan Multidestinasi yang ingin Anda sajikan
4. Membuat iklan dengan menautkan materi iklan ke set iklan Anda

Sebelum memulai

Panduan ini berasumsi Anda memiliki:

• Akun iklan dengan Meta
• Telah mengunggah aset apa pun, seperti gambar atau video, untuk digunakan dalam iklan Anda ke server Meta

Langkah 1: Buat kampanye iklan

Mulailah dengan membuat kampanye iklan Anda. Untuk melakukan ini, buat permintaan POST ke endpoint /act_<AD_ACCOUNT_ID>/campaigns dengan <AD_ACCOUNT_ID> adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:

Parameter

Permintaan

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

Tanggapan

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan ID kampanye yang baru Anda buat.

{
  "id": "<AD_CAMPAIGN_ID>"
}

Memperbarui

Anda dapat memperbarui kampanye dengan membuat permintaan POST ke /<AD_CAMPAIGN_ID>.

Membaca

Untuk memastikan bahwa Anda telah berhasil membuat kampanye klik ke multidestinasi, Anda dapat membuat permintaan GET ke /<AD_CAMPAIGN_ID>. Lihat referensi Kampanye Iklan untuk daftar lengkap parameter yang tersedia.

Permintaan

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CAMPAIGN_ID>

Tanggapan

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

Langkah 2: Buat set iklan

Setelah Anda memiliki kampanye iklan, buat set iklan. Untuk membuat set iklan, buat permintaan POST ke endpoint /act_<AD_ACCOUNT_ID>/adsets dengan <AD_ACCOUNT_ID> adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:

Parameter

Kunjungi referensi Set Iklan Akun Iklan kami untuk daftar lengkap parameter yang tersedia.

Permintaan

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Tanggapan

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan ID set iklan yang baru Anda buat.

{
  "id": "<AD_SET_ID>"
}

Memperbarui

Anda dapat memperbarui set iklan dengan membuat permintaan POST ke /<AD_SET_ID>.

Membaca

Untuk memastikan bahwa Anda telah berhasil membuat set iklan klik ke multidestinasi, Anda dapat membuat permintaan GET ke /<AD_SET_ID>. Lihat referensi Set Iklan untuk daftar lengkap parameter yang tersedia.

Permintaan

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_SET_ID>

Tanggapan

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_ID>"
}

Langkah 3: Buat materi iklan

Dengan materi iklan, Anda dapat menambahkan aset ke iklan Anda. Untuk membuat materi iklan, buat permintaan POST ke endpoint /act_<AD_ACCOUNT_ID>/adcreatives dengan <AD_ACCOUNT_ID> adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:

Parameter

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
} 

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

Kunjungi referensi Materi Iklan untuk daftar lengkap parameter yang tersedia.

Mengisi Pesan Selamat Datang di Halaman

Pesan default yang dilihat pelanggan adalah "Halo! Bisakah minta info lebih lanjut tentang ini?". Anda dapat membuat pengalaman pengguna yang lebih disesuaikan untuk iklan Anda yang mengklik ke multidestinasi dengan menyesuaikan pesan salam, pencair suasana, dan pesan isi otomatis iklan di kolom page_welcome_message di bawah object_story_spec.

Untuk informasi lebih lanjut tentang pencair suasana, lihat ice_breakers referensi.

Batasan

• Judul pencair suasana tidak boleh lebih dari 80 karakter.
• Tanggapan pencair suasana tidak boleh lebih dari 300 karakter.
• Teks pesan tidak boleh lebih dari 300 karakter.

Contoh

Buat objek page_welcome_message untuk menambahkan pencair suasana dengan pesan salam.

"page_welcome_message": {
  "type":"VISUAL_EDITOR",
  "version":2,
  "landing_screen_type":"welcome_message",
  "media_type":"text",
  "text_format":{
    "customer_action_type":"ice_breakers",
    "message":{
      "ice_breakers":[
        {"title":"Can I make a purchase?","response":"This is a response 1"},
        {"title":"Can I see a menu?", "response":"This is a response 2"},
        {"title":"Where are you located?", "response":"This is a response 3"}],
      "quick_replies":[],
      "text":"Hi {{user_first_name}}! Please let us know how we can help you."}
  },
  "user_edit":false,
  "surface":"visual_editor_new"
}

Contoh membuat materi iklan

Tambahkan kolom page_welcome_message ke materi iklan sebagai berikut.

Permintaan

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Tanggapan

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan ID materi iklan yang baru Anda buat.

{
  "id": "<AD_CREATIVE_ID>"
}

Membuat materi iklan menggunakan konten Instagram

Postingan Instagram

Lihat Gunakan Postingan sebagai Iklan Instagram untuk detail selengkapnya.

curl -X POST \
  -F 'name=Sample ad creative from Instagram post' \
  -F 'object_id=<PAGE_ID>' \
  -F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
  -F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
  -F 'call_to_action={
       "type": "INSTAGRAM_MESSAGE",
       "value": {
         "link": "https://www.instagram.com"
       }
     }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Gambar Instagram

curl -X POST \
  -F 'name=Sample ad creative from Instagram image' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
       "link_data": {
         "message": "<AD_PRIMARY_TEXT>",
         "picture": "<IMAGE_URL>"
         "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
         "call_to_action": {
           "type": "INSTAGRAM_MESSAGE",
           "value": {
             "app_destination": "INSTAGRAM_DIRECT"
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Membuat materi iklan menggunakan konten Facebook

Lihat Gunakan Postingan sebagai Iklan Instagram: Postingan Facebook untuk detail selengkapnya.

curl -i -X POST \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives
  ?object_story_id=<postOwnerID_postID>
  &instagram_actor_id=<IG_USER_ID>
  &call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
  &access_token=<ACCESS_TOKEN>"

object_story_id adalah ID postingan dalam format postOwnerID_postID sedangkan instagram_actor_id adalah ID akun Instagram yang terhubung dengan Halaman atau ID akun Instagram yang didukung Halaman. Lihat detail selengkapnya di Menyiapkan Akun Instagram dengan Halaman.

Memperbarui

Anda dapat memperbarui materi iklan dengan membuat permintaan POST ke /<AD_CREATIVE_ID>.

Membaca

Untuk memastikan bahwa Anda telah berhasil membuat materi iklan klik ke multidestinasi, Anda dapat membuat permintaan GET ke /<AD_CREATIVE_ID>. Lihat Materi Iklan untuk daftar lengkap parameter yang tersedia.

Permintaan

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

Tanggapan

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

Langkah 4: Buat iklan

Iklan memungkinkan Anda untuk menghubungkan informasi materi iklan dengan set iklan Anda. Untuk membuat iklan, buat permintaan POST ke endpoint /act_<AD_ACCOUNT_ID>/ads dengan <AD_ACCOUNT_ID> adalah ID akun iklan Meta Anda. Permintaan Anda harus menyertakan:

Parameter

Permintaan

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

Tanggapan

Setelah berhasil, aplikasi Anda akan menerima tanggapan JSON dengan ID iklan yang baru Anda buat.

{
  "id": "<AD_ID>"
}

Ajakan bertindak

Anda juga dapat mengatur ajakan bertindak saat membuat iklan Anda.

"asset_feed_spec": {
  "optimization_type": "DOF_MESSAGING_DESTINATION",
  "call_to_actions": [
    {
      "type": "MESSAGE_PAGE",
      "value": {
        "app_destination": "MESSENGER",
        "link": "https://fb.com/messenger_doc/"
      }
    },
    {
      "type": "INSTAGRAM_MESSAGE",
      "value": {
        "app_destination": "INSTAGRAM_DIRECT",
        "link": "https://www.instagram.com"
      }
    }
  ]
}

Lihat dokumentasi Spesifikasi Kabar Aset untuk informasi selengkapnya.

Memperbarui

Anda dapat memperbarui iklan dengan membuat permintaan POST ke /<AD_ID>.

Membaca

Untuk memastikan bahwa Anda telah berhasil membuat iklan klik ke multidestinasi, Anda dapat membuat permintaan GET ke /<AD_ID>. Lihat referensi iklan untuk daftar lengkap parameter yang tersedia.

Permintaan

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

Tanggapan

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}