Iklan Multibahasa

Sesuaikan berbagai bagian materi iklan seperti gambar, video, teks, dan isi iklan untuk menjangkau penutur bahasa yang berbeda. Facebook mengoptimalkan iklan Anda untuk menampilkan versi bahasa yang tepat kepada orang yang tepat.

Ini membantu Anda dengan mudah menyiapkan iklan dalam berbagai bahasa dan memberikan versi bahasa yang paling relevan di iklan Anda kepada pemirsa sambil mempertahankan penargetan yang luas untuk iklan tersebut. Ini memungkinkan Anda memiliki konten yang dipersonalisasi berdasarkan bahasa lisan pemirsa sambil mempertahankan iklan yang hemat biaya.

Untuk informasi umum tentang fitur ini, lihat Pusat Bantuan Iklan, Beriklan ke pemirsa multibahasa. Lihat tujuan kampanye iklan yang didukung.

Iklan Multibahasa adalah salah satu dari tiga API kami yang menggunakan aturan penyesuaian aset.

Mulai

Sebelum memulai, periksalah batasan untuk produk ini. Jika kasus penggunaan Anda memenuhi spesifikasi kami, lanjutkan ke langkah-langkah berikut:

• Langkah 1: Buat kampanye iklan dan set iklan
• Langkah 2: Sediakan materi iklan melalui asset_feed_spec —lihat juga Bahasa yang Tersedia.
• Langkah 3: Buat iklan dengan asset_feed_spec dalam creative_spec
• Langkah 4 Opsional: Tampilkan pratinjau iklan Anda

Jika Anda tidak memiliki sumber daya untuk menerjemahkan iklan Anda secara manual, lihat layanan terjemahan otomatis.

Langkah 2: Sediakan materi iklan melalui asset_feed_spec

Materi Iklan Multibahasa ditentukan menggunakan asset_feed_spec. Beranda aset adalah koleksi elemen materi iklan yang berbeda, seperti gambar, judul, isi, dan sebagainya. Buat asset_feed_spec di /adcreative.

Untuk membuat asset_feed_spec, sediakan array aset untuk setiap bahasa yang berbeda. Tambahkan label untuk memberi tanda pada setiap aset untuk mengidentifikasi bahasa yang dimiliki aset tersebut. Facebook menggunakan label di asset_customization_rules untuk mengelompokkan aset berdasarkan bahasa. Sebaiknya sediakan setidaknya satu aset per jenis aset.

Parameter yang Tersedia

Parameter yang harus disediakan di asset_feed_spec mencakup:

Aturan Penyesuaian Aset

Tentukan aset yang muncul bersama untuk pemirsa berbahasa tertentu. Setiap aturan memiliki customization_spec yang menentukan bahasa lokal orang-orang yang melihat aset ini selama penayangan iklan.

Sediakan tepat satu aturan default. Aturan ini harus menyertakan aset yang ditampilkan Facebook jika bahasa pilihan seseorang tidak cocok dengan lokal mana pun yang ditentukan dalam beranda aset. Ini membantu mencegah penayangan yang kurang tepat dari iklan Anda.

Bahasa yang Tersedia

Bahasa lokal yang Anda sediakan di customization_spec haruslah ID lokal yang didukung dalam penargetan iklan. Lihat Penargetan dan Penempatan, Lokal. Anda dapat mencari bahasa tertentu menggunakan endpoint /search. Gunakan parameter q untuk mencari nama bahasa tertentu. Kosongkan parameter ini untuk mendapatkan daftar semua bahasa yang didukung:

curl -G \
  -d "type=adlocale" \
  -d "q=en" \
  -d "limit=2" \
  -d "access_token=<ACCESS_TOKEN>" \ 
  https://graph.facebook.com/v21.0/search

Jika berhasil, Anda akan mendapatkan daftar bahasa:

{
  "data": [
    {
      "key": 6,
      "name": "English (US)"
    },
    {
      "key": 24,
      "name": "English (UK)"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD",
    }
  }
}

Anda harus menggunakan kunci dalam hasil penelusuran ini sebagai bahasa lokal dalam aturan penyesuaian aset Anda. Untuk informasi selengkapnya, lihat Pencarian Penargetan.

Langkah 3: Buat Iklan menggunakan Spesifikasi Beranda Aset

Anda dapat membuat beranda aset menggunakan kolom asset_feed_spec di POST ad_account_ID/adcreatives:

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Essayez notre délicieuse recette de guacamole!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "french"}],
         },
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Les meilleurs avocats!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com/en",
           "adlabels": [{"name": "english"}],
         },
         {
           "website_url": "www.jaspersmarket.com/fr",
           "adlabels": [{"name": "french"}],
         },
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>",
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "customization_spec": {
             "locales": [9,44],
           },
           "title_label": {"name": "french"},
           "body_label": {"name": "french"},
           "description_label": {"name": "french"},
           "link_url_label": {"name": "french"},
         },
         {
             "is_default": true,
           "customization_spec": {
             "locales": [24]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"},
         },
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Setelah berhasil, Anda mendapatkan ID untuk materi iklan:

{"id":"238474593777777"}

Jika asset_feed_spec Anda tidak memenuhi batasan di bawah, Anda akan melihat kesalahan.

Untuk membuat iklan dengan ID materi iklan ini, panggil POST act_AD_ACCOUNT_ID/ads. Alternatifnya, untuk menampilkan bahasa yang berbeda di iklan Anda, sediakan asset_feed_spec dan object_story_spec di parameter creative untuk iklan.

Untuk memverifikasi asset_feed_spec baru, panggil GET pada ID iklan atau ID materi iklan:

curl -G \
-d 'fields=object_story_spec,asset_feed_spec' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>

Langkah 4 Opsional: Tampilkan Pratinjau Iklan Anda

Lihat pratinjau versi bahasa yang berbeda dari iklan Anda menggunakan endpoint generatepreview. Tambahkan kolom dynamic_asset_label dengan adlabel dalam aturan untuk melihat versi bahasa tertentu.

Contoh: untuk melihat pratinjau versi Prancis dari materi iklan di atas:

curl -G \
  --data-urlencode 'creative={ 
    "object_story_spec": { 
      "page_id": "<PAGE_ID>" 
    },
    "asset_feed_spec": {
      ...
    }
  }' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'dynamic_asset_label=french'
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Terjemahan Otomatis

Anda dapat menggunakan layanan terjemahan otomatis kami, jika Anda tidak memiliki sumber daya untuk menerjemahkan iklan Anda secara manual. Kemampuan ini menerjemahkan teks iklan default Anda ke bahasa tambahan, sehingga Anda dapat menjangkau pemirsa multibahasa.

Sumber untuk terjemahan otomatis dapat ditemukan di aset teks yang ditentukan oleh aturan penyesuaian asett default. Salinan iklan yang diterjemahkan secara otomatis diberi label sebagai "Diterjemahkan Secara Otomatis".

Untuk membuat versi terjemahan otomatis dari teks iklan Anda, tambahkan autotranslate ke asset_feed_spec. Kemudian, tentukan bahasa yang Anda inginkan untuk digunakan dalam terjemahan salinan Anda. Lihat contoh:

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "autotranslate": ["fr_XX"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         }
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}]
         }
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}]
         }
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com",
           "adlabels": [{"name": "english"}]
         }
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "optimization_type": "LANGUAGE",
       "asset_customization_rules": [
         {
           "is_default": true,
           "customization_spec": {
             "locales": [6]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"}
         }
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Salinan yang diterjemahkan secara otomatis dapat ditinjau dengan panggilan ke kolom asset_feed_spec pada materi iklan.

Setiap pengeditan salinan terjemahan otomatis pada spesifikasi akan dihapus jika bahasa yang sama ditentukan di kolom autotranslate. Hasil edit ini akan diganti dengan terjemahan baru dari salinan iklan default. Jika Anda benar-benar membutuhkan pengeditan, hapus bahasa dari kolom autotranslate.

link_urls

Anda dapat menambahkan URL tautan khusus ke versi iklan yang diterjemahkan secara otomatis.

Untuk melakukan ini, tambahkan URL language-specific ke kolom link_urls bersama dengan adlabel dan tambahkan aturan baru ke asset_customization_rules dengan kode lokal terkait dan link_url_label untuk bahasa ini.

Pembatasan

Berikut ini adalah batasan pada beranda aset Anda.

Format Iklan

• Hanya satu format iklan per asset_feed_spec
• Untuk format SINGLE_IMAGE, Anda harus menyediakan setidaknya satu gambar.
• Untuk format SINGLE_VIDEO, Anda harus menyediakan setidaknya satu video

Aset, Umum

• Anda dapat menyediakan maksimal 49 aset untuk setiap jenis aset kecuali call_to_action_types.
• Anda harus menyediakan tepat satu aset call_to_action_type untuk semua tujuan.

Aset Teks

• Anda harus menyediakan setidaknya satu aset teks, seperti title, isi, description, dan link_urls, untuk setiap versi bahasa di beranda aset.
• Semua aset teks harus memiliki kolom adlabels.
• Panjang maksimum: 255 karakter untuk judul, 4096 karakter untuk isi, dan 10.000 karakter untuk deskripsi.

Aset Gambar dan Video

• Untuk ukuran gambar yang direkomendasikan berdasarkan penempatan dan tujuan, lihat Panduan Iklan.
• Anda dapat menggunakan hingga satu aset gambar atau video tanpa adlabel. Kami menggunakan gambar atau video ini untuk semua versi bahasa.
• Jika Anda menyediakan video atau gambar tambahan, Anda harus menyertakan adlabel dan sediakan label-label ini di aturan penyesuaian aset Anda.

Aset URL Tautan

• Jika Anda menyediakan url_tags, kami menambahkannya ke link_url sebagai parameter untuk setiap aset di iklan.
• Jika Anda menggunakan tujuan APP_INSTALLS, link_url Anda harus sama dengan promoted_object.object_store_url set iklan.

Aturan Penyesuaian Aset

• Anda harus menyediakan aturan penyesuaian aset untuk setiap varian bahasa di asset_feed_spec.
• Anda harus menyediakan satu aturan default. Ini adalah aturan penyesuaian aset dengan is_default diatur ke true. Ini bertindak sebagai aturan cadangan dan memungkinkan iklan untuk ditampilkan bahkan ketika bahasa seseorang tidak cocok dengan bahasa apa pun di asset_feed_spec.

Penempatan

• Iklan Multibahasa mendukung semua penempatan.

Tujuan dan Jenis Destinasi yang Tersedia

• LINK_CLICKS - Situs web dan aplikasi, tanpa Messenger.
• APP_INSTALLS - Desktop atau aplikasi seluler.
• CONVERSIONS - Situs web dan aplikasi, tanpa Messenger.
• REACH - Semua jenis destinasi.
• BRAND_AWARENESS - Semua jenis destinasi.
• VIDEO_VIEWS - Semua jenis destinasi

Jenis Pembelian yang Didukung

• REACH - Jangkauan dan Frekuensi
• AUCTION

Arah Terjemahan yang Didukung

Arah terjemahan berikut ini didukung. Gunakan kode dialek yang sesuai di kolom autotranslate: