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/v19.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/v19.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/v19.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/v19.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

Materi iklan memungkinkan Anda untuk 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 mengeklik ke multidestinasi dengan menyesuaikan pesan salam, pencair suasana, dan pesan isi otomatis di kolom page_welcome_message di bawah object_story_spec.

Contoh

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": {
      "text": "<GREETING_MESSAGE>",
      "ice_breakers": [
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        }
      ]
    }
  }
}

Contoh membuat materi iklan

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/v19.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>"
}

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/v19.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/v19.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>"
}

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/v19.0/<AD_ID>

Tanggapan

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