Untuk mempromosikan inventaris penerbangan Anda di Facebook, Anda harus membagikan informasi tentang penerbangan Anda dengan Facebook. Caranya dengan membuat katalog penerbangan lalu mengisinya dengan rute penerbangan. Ada tiga cara untuk mengisi katalog Anda dan terus memperbaruinya.
Anda dapat membuat dan mengelola katalog penerbangan Anda di Commerce Manager:
Beranda penerbangan adalah file dengan inventaris penerbangan Anda. Setiap baris atau item dalam file mewakili satu rute. Anda dapat menggunakan satu atau beberapa beranda penerbangan, selama semua beranda berisi inventaris lengkap penerbangan Anda.
Contoh CSV | Contoh TSV (diratakan)
"
tanda kutip"
. image
dapat diwakili menggunakan nilai berenkode JSON atau dengan set kolom teks biasa “diratakan” yang dilabeli menggunakan sintaksis berjalur JSON, seperti image[0].url
, image[0].tag[0]
, image[0].tag[1]
. Kedua aturan itu bisa digunakan secara bergantian di file yang sama.<listings>
akar menyertakan satu set node <listing>
, masing-masing mewakili satu penerbangan.<?xml
yang valid.Pengurai kabar berita otomatis mendeteksi pengkodean teks UTF8
, UTF16
, atau UTF32
, dan defaultnya adalah LATIN1
jika bertemu dengan urutan byte tak terduga. Anda dapat menyediakan teks di nilai kolom dalam bahasa apa pun, namun nama kolom harus diberikan persis di bawah ini, dalam bahasa Inggris.
Kolom yang didukung berikut ini dirancang untuk item yang Anda tambahkan ke katalog produk Anda.
Untuk katalog yang dilokalkan, lihat kolom yang didukung untuk iklan penerbangan.
Kolom dan Jenis | Deskripsi |
---|---|
jenis: string | Wajib. Kode IATA tempat asal. Mendukung kode IATA bandara dan kota. Gunakan Pencarian Kode IATA untuk memvalidasi kode IATA Anda. Tips: Untuk meningkatkan kinerja, hindari menggunakan spasi untuk kolom pengidentifikasi unik ini. Contoh: |
jenis: string | Wajib. Kode IATA destinasi. Mendukung kode IATA bandara dan kota. Gunakan Pencarian Kode IATA untuk memvalidasi kode IATA Anda. Tips: Untuk meningkatkan kinerja, hindari menggunakan spasi untuk kolom pengidentifikasi unik ini. Contoh: |
jenis: objek | Wajib. Item maks: 20 Data gambar untuk penerbangan ini. Anda bisa menyediakan hingga 20 gambar untuk penerbangan ini. Setiap gambar berisi dua kolom: Lihat Parameter Objek Gambar |
jenis: string | Wajib. Ukuran maksimal: 5.000 Paragraf pendek yang mendeskripsikan rute. |
jenis: string | Wajib hanya jika Anda tidak menentukan tautan dalam pada level iklan. Anda dapat menggunakan kolom Tautan ke situs eksternal tempat Anda dapat melihat penerbangan. Jika tautan dalam ditentukan di level iklan, itu akan diutamakan. |
jenis: string | Nama kota asal. Contoh: |
jenis: string | Nama kota destinasi. Contoh: |
jenis: string | Harga penerbangan. Anda harus menentukan nilainya dengan mata uang. Contoh: |
jenis: elemen | Tautan dalam langsung ke halaman detail penerbangan di aplikasi seluler Anda menggunakan Tautan Aplikasi. Anda dapat menentukan tautan dalam (dengan urutan menurun, tertinggi ke terendah):
|
jenis: string | Harga penerbangan sekali jalan. Anda harus menentukan nilainya dengan mata uang. Contoh: |
jenis: bilangan bulat | Prioritas penerbangan. Nilai dari 0 (prioritas terendah) ke 5 (prioritas tertinggi). Penerbangan tanpa nilai ini akan memiliki priority=0. Contoh: |
Jenis: string | Mengontrol apakah barang aktif atau diarsipkan di katalog Anda. Hanya barang aktif yang bisa dilihat oleh orang di iklan, toko, atau saluran Anda lainnya. Nilai yang didukung: Contoh: Catatan: Beberapa platform partner seperti Shopify dapat menyinkronkan barang ke katalog Anda dengan status yang disebut staging, yang berperilaku sama seperti Kolom ini sebelumnya disebut |
Nama dan Jenis Kolom | Deskripsi |
---|---|
jenis: string | Wajib. URL gambar penerbangan. Ikuti spesifikasi gambar berikut:
|
jenis: string | String yang mewakili konten yang ada di gambar. Beberapa tanda bisa dikaitkan dengan sebuah gambar. Contoh:
|
Jika Anda memiliki aplikasi terpisah untuk iPhone dan iPad, tentukan informasi khusus iPhone dan iPad. Jika tidak, tentukan hanya informasi iOS.
Nama dan Jenis Kolom | Keterangan |
---|---|
jenis: string | Skema khusus untuk aplikasi iOS. Contoh: |
jenis: string | ID aplikasi untuk App Store. Contoh: 1234 |
jenis: string | Nama aplikasi (sesuai untuk tampilan). Contoh: |
jenis: string | Skema khusus untuk aplikasi iPhone. Contoh: |
jenis: string | ID aplikasi untuk App Store. Contoh: |
jenis:string | Nama aplikasi (sesuai untuk tampilan). Contoh: |
jenis: string | Skema khusus untuk aplikasi iPhone. Contoh: |
jenis: string | ID aplikasi untuk App Store. Contoh: |
jenis: string | Nama aplikasi (sesuai untuk tampilan). Contoh: |
jenis: string | Skema khusus untuk aplikasi Android. Contoh: |
jenis: string | Nama paket berkualifikasi lengkap untuk pembuatan keinginan. Contoh: |
jenis: string | Nama kelas Aktivitas berkualifikasi lengkap untuk pembuatan keinginan. Contoh: |
jenis: string | Nama aplikasi (sesuai untuk tampilan). Contoh: |
Sediakan tautan dalam di kabar mengikuti spesifikasi Tautan Aplikasi. Informasi tautan dalam di kabar lebih diutamakan daripada informasi apa pun yang dikumpulkan Facebook dengan metadata Tautan Aplikasi dengan crawler web kami.
Jika Anda sudah memiliki informasi tautan dalam dari Tautan Aplikasi, Anda tidak perlu menentukan data ini. Facebook menggunakan informasi dari Tautan Aplikasi untuk menampilkan tautan dalam yang benar. Untuk menampilkan tautan dalam di iklan Anda, lihat Iklan Katalog Advantage+, Template Iklan.
Facebook dapat secara otomatis menambahkan rute ke katalog Anda berdasarkan pixel dan aktivitas peristiwa aplikasi. Setiap kali peristiwa yang diterima dengan rute yang belum ada di katalog, rute dapat ditambahkan secara otomatis. Ini memungkinkan Anda menggunakan iklan penerbangan untuk semua penerbangan Anda tanpa harus berurusan dengan beranda penerbangan.
Untuk mengaktifkan ini, buat permintaan POST
ke katalog penerbangan Anda dan atur generate_items_from_events
ke true
.
curl \ -F 'flight_catalog_settings={generate_items_from_events:1}' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
Rute yang ditambahkan secara otomatis tidak memiliki gambar (untuk ditampilkan di iklan). Oleh karena itu, Anda perlu menyediakan gambar umum yang akan digunakan untuk semua rute yang dibuat secara otomatis.
curl \ -F 'fallback_image_url=http://example.com/some.image_1.jpg' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
Segera setelah katalog Anda dikaitkan dengan pixel dan/atau aplikasi, dan menerima peristiwa iklan penerbangan, katalog Anda terisi. Anda dapat memverifikasi ini dengan meng-kueri katalog.
curl \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights
Anda dapat menggabungkan mengunggah beranda penerbangan dengan rute yang dibuat secara otomatis. Menggabungkan opsi ini memungkinkan Anda memanfaatkan iklan penerbangan untuk semua penerbangan Anda, sekaligus memberikan gambar khusus untuk rute terpenting Anda menggunakan beranda penerbangan.
Untuk melakukannya, gabungkan langkah mengunggah beranda penerbangan dengan secara otomatis mengisi katalog Anda.
Bagian berikut hanya relevan jika Anda ingin mengelola katalog Anda menggunakan API ini.
Katalog penerbangan adalah kontainer untuk inventaris penerbangan Anda. Untuk menggunakan API katalog, pastikan Anda memiliki Level Akses Marketing API yang sesuai dan Anda telah menerima Ketentuan Layanan dengan membuat katalog pertama Anda melalui Pengelola Bisnis.
Untuk membuat katalog penerbangan untuk iklan penerbangan, atur vertical
ke flights
:
curl -X POST \ -F 'name="Test Flight Catalog"' \ -F 'vertical="flights"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/{business-id}/owned_product_catalogs
Setelah Anda membuat katalog, Anda harus mengunggah beranda penerbangan Anda ke Facebook. Gunakan API untuk membuat objek beranda untuk setiap beranda yang ingin Anda unggah. Kami mendukung unggahan terjadwal dan langsung.
Set penerbangan merupakan subset katalog Anda. Untuk menyiapkan iklan penerbangan, Anda harus membuat setidaknya set penerbangan.
Set penerbangan ditetapkan oleh filter yang diterapkan pada katalog penerbangan. Contoh: Anda membuat set penerbangan dengan semua rute yang berangkat dari London. Perhatikan, Anda pun dapat membuat set penerbangan tanpa filter. Dalam kasus itu, set destinasi akan berisi semua penerbangan dalam katalog Anda.
use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;
$flight_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);
$flight_set->setData(array(
ProductSetFields::NAME => 'Test Flight Set',
ProductSetFields::FILTER => array(
'origin_airport' => array(
'eq' => 'LHR',
),
),
));
$flight_set->create();
from facebookads.adobjects.productset import ProductSet
flight_set = ProductSet(None, <PRODUCT_CATALOG_ID>)
flight_set[ProductSet.Field.name] = 'Test Flights Set'
flight_set[ProductSet.Field.filter] = {
'origin_airport': {
'eq': 'SFO',
},
}
flight_set.remote_create()
curl \
-F 'name=Test Flight Set' \
-F 'filter={"origin_airport":{"eq":"LHR"}}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/<PRODUCT_CATALOG_ID>/product_sets
Parameter filter
tersusun atas operator dan data berikut:
Operator | Jenis Filter |
---|---|
| Berisi substring. Operator tidak sensitif huruf besar/kecil. |
| Tidak berisi substring. Operator tidak sensitif huruf besar/kecil. |
| Berisi substring. Operator tidak sensitif huruf besar/kecil. |
| Tidak berisi substring. Operator tidak sensitif huruf besar/kecil. |
| Sama dengan. Operator tidak sensitif huruf besar/kecil. |
| Tidak sama dengan. Operator tidak sensitif huruf besar/kecil. |
| Kurang dari. Hanya untuk kolom numerik. |
| Kurang dari atau sama dengan. Hanya untuk kolom numerik. |
| Lebih besar dari. Hanya untuk kolom numerik. |
| Lebih besar atau sama dengan. Hanya untuk kolom numerik. |
Data | Data yang difilter |
---|---|
| Kode IATA tempat asal. |
| Kode IATA destinasi. |
| Harga penerbangan. Harga dalam sen. |
| Paragraf pendek yang mendeskripsikan rute. |