Iklan Penerbangan - Katalog & Beranda

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.

  1. Unggah file CSV atau XML untuk 'beranda penerbangan' dengan inventaris penerbangan
  2. Gunakan aktivitas peristiwa untuk secara otomatis mengisi katalog Anda
  3. Gabungkan beranda penerbangan dengan penerbangan yang dibuat secara otomatis

Anda dapat membuat dan mengelola katalog penerbangan Anda di Commerce Manager:

  1. Buat katalog penerbangan
  2. Unggah beranda Anda ke Facebook
  3. Buat set produk dari katalog penerbangan Anda
  4. Kaitkan katalog ke sumber peristiwa Anda

Beranda Penerbangan - Unggah Penerbangan Anda ke Facebook

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.

Format Beranda Penerbangan yang Didukung

CSV > Contoh - Deskripsi

Contoh CSV | Contoh TSV (diratakan)

  • Baris pertama harus mencantumkan nama kolom pilihan sesuai urutan nilai yang akan diberikan. Baris berikutnya berisi nilai yang sesuai untuk setiap penerbangan.
  • Kolom yang berisi spasi kosong atau koma harus diapit oleh "tanda kutip".
  • Kolom bertingkat atau multi-nilai seperti 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.

XML > Contoh - Deskripsi

Contoh XML

  • Node XML <listings> akar menyertakan satu set node <listing>, masing-masing mewakili satu penerbangan.
  • File harus diawali dengan tanda deklarasi <?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 - Iklan Penerbangan

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 JenisDeskripsi

origin_airport

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: SFO

destination_airport

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: JFK

image

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: url dan tag. Anda bisa mengaitkan beberapa tanda dengan sebuah gambar. Anda harus menyediakan setidaknya satu image. Setiap gambar dapat berukuran hingga 4 MB.

Lihat Parameter Objek Gambar

description

jenis: string

Wajib.

Ukuran maksimal: 5.000

Paragraf pendek yang mendeskripsikan rute.

url

jenis: string

Wajib hanya jika Anda tidak menentukan tautan dalam pada level iklan. Anda dapat menggunakan kolom Deep Link di Pengelola Iklan, atau template_url_spec dalam API).

Tautan ke situs eksternal tempat Anda dapat melihat penerbangan. Jika tautan dalam ditentukan di level iklan, itu akan diutamakan.

origin_city

jenis: string

Nama kota asal.

Contoh: San Francisco

destination_city

jenis: string

Nama kota destinasi.

Contoh: New York

price

jenis: string

Harga penerbangan. Anda harus menentukan nilainya dengan mata uang.

Contoh: 99.99 USD

applink

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):

  1. di level iklan menggunakan template_url_spec
  2. Di sini di beranda menggunakan Objek Tautan Aplikasi
  3. dengan menambahkan tanda meta Tautan Aplikasi ke situs web Anda.

one_way_price

jenis: string

Harga penerbangan sekali jalan. Anda harus menentukan nilainya dengan mata uang.

Contoh: 99.99 USD

priority

jenis: bilangan bulat

Prioritas penerbangan. Nilai dari 0 (prioritas terendah) ke 5 (prioritas tertinggi). Penerbangan tanpa nilai ini akan memiliki priority=0.

Contoh: 5

status

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: active, archived. Barang secara default akan berstatus aktif. Pelajari selengkapnya tentang mengarsipkan barang.


Contoh: active


Catatan: Beberapa platform partner seperti Shopify dapat menyinkronkan barang ke katalog Anda dengan status yang disebut staging, yang berperilaku sama seperti archived.

Kolom ini sebelumnya disebut visibility. Meskipun kami masih mendukung nama kolom lama, kami merekomendasikan Anda menggunakan nama yang baru.

Parameter Objek Gambar

Nama dan Jenis KolomDeskripsi

url

jenis: string

Wajib.

URL gambar penerbangan. Ikuti spesifikasi gambar berikut:

  • Semua gambar harus dalam format JPG, GIF, atau PNG.

  • Untuk iklan carousel dan iklan koleksi: Gambar ditampilkan dalam format persegi (1:1). Ukuran minimum gambar 500 x 500 px. Kami rekomendasikan 1024 x 1024 px untuk kualitas terbaik.

  • Untuk iklan gambar tunggal: Gambar ditampilkan dengan rasio aspek 1,91:1. Ukuran minimum gambar adalah 500 x 500 px. Kami rekomendasikan 1200 x 628 px untuk kualitas terbaik.

tag

jenis: string

String yang mewakili konten yang ada di gambar. Beberapa tanda bisa dikaitkan dengan sebuah gambar.

Contoh:

  • Fitness Center
  • Swimming Pool

INSTAGRAM_STANDARD_PREFERRED - Mengizinkan pengiklan memberi tanda pada gambar tertentu di beranda mereka sebagai gambar default yang akan digunakan untuk Instagram. Tanda ini sensitif huruf besar/kecil.

Jika Anda memiliki aplikasi terpisah untuk iPhone dan iPad, tentukan informasi khusus iPhone dan iPad. Jika tidak, tentukan hanya informasi iOS.

Nama dan Jenis KolomKeterangan

ios_url

jenis: string

Skema khusus untuk aplikasi iOS.

Contoh: example-ios://electronic

ios_app_store_id

jenis: string

ID aplikasi untuk App Store.

Contoh: 1234

ios_app_name

jenis: string

Nama aplikasi (sesuai untuk tampilan).

Contoh: Electronic Example iOS

iphone_url

jenis: string

Skema khusus untuk aplikasi iPhone.

Contoh: example-iphone://electronic

iphone_app_store_id

jenis: string

ID aplikasi untuk App Store.

Contoh: 5678

iphone_app_name

jenis:string

Nama aplikasi (sesuai untuk tampilan).

Contoh: Electronic Example iPhone

ipad_url

jenis: string

Skema khusus untuk aplikasi iPhone.

Contoh: example-ipad://electronic

ipad_app_store_id

jenis: string

ID aplikasi untuk App Store.

Contoh: 9010

ipad_app_name

jenis: string

Nama aplikasi (sesuai untuk tampilan).

Contoh: Electronic Example iPad

android_url

jenis: string

Skema khusus untuk aplikasi Android.

Contoh: example-android://electronic

android_package

jenis: string

Nama paket berkualifikasi lengkap untuk pembuatan keinginan.

Contoh: com.electronic

android_class

jenis: string

Nama kelas Aktivitas berkualifikasi lengkap untuk pembuatan keinginan.

Contoh: com.electronic.Example

android_app_name

jenis: string

Nama aplikasi (sesuai untuk tampilan).

Contoh: Electronic Example Android

Tautan Dalam Produk

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.

Buat Penerbangan Otomatis - Tambahkan Rute ke Katalog Secara Otomatis Menggunakan Aktivitas Peristiwa

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

Gabungan - Gunakan Beranda Penerbangan dengan Penerbangan yang Dibuat Secara Otomatis

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.

Membuat Katalog Penerbangan menggunakan API

Dokumen Referensi

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

Mengunggah Beranda Penerbangan Anda melalui API

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.

Filter Katalog Penerbangan ke Set Penerbangan

Dokumen Referensi

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:

OperatorJenis Filter

i_contains

Berisi substring. Operator tidak sensitif huruf besar/kecil.

i_not_contains

Tidak berisi substring. Operator tidak sensitif huruf besar/kecil.

contains

Berisi substring. Operator tidak sensitif huruf besar/kecil.

not_contains

Tidak berisi substring. Operator tidak sensitif huruf besar/kecil.

eq

Sama dengan. Operator tidak sensitif huruf besar/kecil.

neq

Tidak sama dengan. Operator tidak sensitif huruf besar/kecil.

lt

Kurang dari. Hanya untuk kolom numerik.

lte

Kurang dari atau sama dengan. Hanya untuk kolom numerik.

gt

Lebih besar dari. Hanya untuk kolom numerik.

gte

Lebih besar atau sama dengan. Hanya untuk kolom numerik.

DataData yang difilter

origin_airport

Kode IATA tempat asal.

destination_airport

Kode IATA destinasi.

price

Harga penerbangan. Harga dalam sen.

description

Paragraf pendek yang mendeskripsikan rute.