Dokumen ini sudah diperbarui.
Terjemahan ke Bahasa Indonesia belum selesai.
Bahasa Inggris diperbarui: 20 Nov 2023

Iklan Destinasi - Katalog & Kabar

Untuk mempromosikan destinasi di Facebook, Anda harus membagikan informasi tentang itu dengan Facebook. Anda melakukan ini dengan membuat katalog destinasi lalu mengisinya dengan destinasi.

Unggah file CSV atau XML untuk "kabar destinasi" dengan destinasi yang ingin Anda promosikan

Anda dapat membuat dan mengelola katalog destinasi Anda dalam Commerce Manager.

Untuk menggunakan API dalam mengelola katalog:

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

Kabar Destinasi - Mengunggah Destinasi Anda ke Facebook

Kabar destinasi merupakan file berisi destinasi yang ingin Anda promosikan. Setiap baris atau item dalam file itu menyatakan satu destinasi. Anda dapat menggunakan satu atau beberapa kabar destinasi, selama semua kabar bersamaan berisi semua destinasi yang ingin Anda promosikan.

Format Kabar Destinasi yang Didukung

CSV - Contoh & Deskripsi

Contoh CSV | Contoh TSV (diratakan) | Contoh TSV (gaya JSON)

  • Baris pertama harus mencantumkan nama kolom pilihan sesuai urutan nilai yang akan diberikan. Baris berikutnya berisi nilai yang sesuai untuk setiap destinasi.
  • Kolom yang berisi spasi kosong atau koma harus diapit oleh "tanda kutip".
  • Kolom berlapis atau multi-nilai seperti address, neighborhood, atau image dapat diwakili menggunakan nilai berenkode JSON atau dengan set kolom teks biasa bergaya “rata” yang dilabeli menggunakan sintaksis berjalur JSON, seperti address.city, neighborhood[0], 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 set node <listing>, masing-masing mewakili satu destinasi.
  • File harus diawali dengan tanda deklarasi <?xml yang valid.

The feed parser automatically detects UTF8, UTF16, or UTF32 text encodings, and defaults to LATIN1 if it encounters an unexpected byte sequences. You can provide text in field values in any language; however, field names must be given exactly as below, in English.

Kolom yang Didukung - Destinasi

Kolom yang didukung berikut ini dirancang untuk item yang Anda tambahkan ke katalog produk Anda.

Untuk katalog yang dilokalkan, lihat kolom yang didukung untuk destinasi.

Nama dan Jenis KolomDeskripsi

destination_id

jenis: string

Wajib.

Panjang maks: 100

Pengidentifikasi unik Anda untuk destinasi dalam katalog. Ini akan dicocokkan dengan content_ids yang disediakan dalam peristiwa aplikasi dan pixel destination Anda. Tips: Untuk meningkatkan kinerja, hindari menggunakan spasi untuk kolom pengidentifikasi unik ini.

address

jenis: objek

Wajib.

Alamat lengkap untuk destinasi yang harus dapat ditemukan lokasinya

Lihat Parameter Objek Alamat

image

jenis: objek

Wajib.

Item maksimal: 20

Data gambar untuk destinasi ini. Anda bisa memberikan hingga 20 gambar untuk destinasi 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

url

jenis: string

Wajib.

Tautkan ke situs eksternal tempat Anda dapat melihat halaman destinasi. Anda pun dapat menetapkan URL level iklan menggunakan template_url_spec. URL di level iklan lebih diutamakan daripada URL di kabar.

type

jenis: string

Wajib.

Item maksimal: 20

Jenis destinasi misalnya pantai, kota, makanan, jalan-jalan, budaya, sejarah, belanja, museum, ketenangan, pemandangan, alam, arsitektur, bisnis, orang ramah, relaksasi, pasar malam, gunung, kuil, mendaki, menyelam, dan sebagainya. Beberapa jenis dapat dikaitkan dengan satu destinasi (mis., satu destinasi dapat memiliki beberapa atribut seperti beach dan sightseeing.

name

jenis: string

Wajib.

Nama paling umum dari destinasi.

neighborhood

jenis: string

Opsional.

Item maksimal: 20

Satu atau beberapa lingkungan sekitar untuk destinasi.

Contoh: Soho, Las Vegas Strip

latitude

jenis: float

Opsional.

Garis lintang destinasi.

Contoh: 37.484100

longitude

jenis: float

Opsional.

Garis bujur destinasi.

Contoh: -122.148252

description

jenis: string

Opsional.

Ukuran maksimal: 5.000

Paragraf pendek yang menjelaskan destinasi.

price

jenis: string

Opsional. Dapat berupa harga terendah atau rata-rata untuk destinasi ini. Anda harus menentukan nilainya dengan mata uang.

Contoh: 99.99 USD

price_change

jenis: int

Opsional. Perubahan harga:

  • 0: Tidak ada perubahan harga
  • -10: penurunan harga 10%
  • 20: kenaikan harga 20%

Ini dapat digunakan untuk membuat set produk dan di materi iklan universal ("harga rata-rata turun sebesar X").

applink

jenis: elemen

Opsional. Tautan dalam langsung ke halaman detail destinasi di aplikasi seluler Anda menggunakan Tautan Aplikasi. Tentukan tautan dalam sesuai urutan prioritas, dari yang tertinggi ke terendah:

  1. Di level iklan menggunakan template_url_spec
  2. Di sini di kabar menggunakan Objek Tautan Aplikasi
  3. Dengan menambahkan meta tag Tautan Aplikasi ke situs web Anda.

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.

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.

Parameter Objek Gambar

Nama dan Jenis KolomDeskripsi

url

jenis: string

Wajib.

URL gambar destinasi. 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

Opsional.

String yang mewakili apa 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 kabar mereka sebagai gambar default yang akan digunakan untuk Instagram. Tanda ini sensitif huruf besar/kecil.

Parameter Objek Alamat

Kolom bertingkat atau multinilai seperti address dapat diwakili menggunakan nilai berenkode JSON atau dengan set kolom teks biasa “diratakan” yang dilabeli menggunakan sintaksis berjalur JSON, seperti address.region. Kedua aturan itu bisa digunakan secara bergantian di file yang sama.

Nama dan Jenis KolomDeskripsi

addr1 (address.addr1)

jenis: string

Alamat jalan destinasi.

Contoh: 675 El Camino Real

address.city (city)

jenis: string

Wajib.

Kota tempat destinasi berada.

Contoh: Palo Alto

address.region (region)

jenis: string

Wajib.

Negara bagian, distrik, daerah, atau provinsi destinasi.

Contoh: California

address.postal_code (postal_code)

jenis: string

Kode pos untuk destinasi. Wajib kecuali jika negara tidak memiliki sistem kode pos.

Contoh:

  • 94125
  • NW1 3FG

address.country (country)

jenis: string

Wajib.

Negara destinasi.

Contoh: United States

address.city_id (city_id)

jenis: string

Nilai untuk digunakan di URL tautan dalam (template_url) di materi iklan universal.

If you have separate apps for iPhone and iPad, specify iPhone and iPad specific information. Otherwise specify only iOS information.

Field Name and TypeDescription

ios_url

type: string

A custom scheme for the iOS app.

Example: example-ios://electronic

ios_app_store_id

type: string

The app ID for the App Store.

Example: 1234

ios_app_name

type: string

The name of the app (suitable for display).

Example: Electronic Example iOS

iphone_url

type: string

A custom scheme for the iPhone app.

Example: example-iphone://electronic

iphone_app_store_id

type: string

The app ID for the App Store.

Example: 5678

iphone_app_name

type:string

The name of the app (suitable for display).

Example: Electronic Example iPhone

ipad_url

type: string

A custom scheme for the iPhone app.

Example: example-ipad://electronic

ipad_app_store_id

type: string

The app ID for the App Store.

Example: 9010

ipad_app_name

type: string

The name of the app (suitable for display).

Example: Electronic Example iPad

android_url

type: string

A custom scheme for the Android app.

Example: example-android://electronic

android_package

type: string

A fully-qualified package name for intent generation.

Exammple: com.electronic

android_app_name

type: string

The name of the app (suitable for display).

Example: Electronic Example Android

Bagian berikut hanya relevan untuk mengelola katalog Anda menggunakan API ini.

Buat Katalog Destinasi menggunakan API

Dokumen Referensi

Katalog destinasi merupakan kontainer bagi destinasi yang ingin Anda promosikan. 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 destinasi untuk iklan destinasi, atur vertical ke destinations:

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

Unggah Kabar Destinasi Anda melalui API

Setelah Anda membuat katalog, Anda harus mengunggah kabar destinasi Anda ke Facebook. Gunakan API untuk membuat objek kabar untuk setiap kabar yang ingin Anda unggah. Kami mendukung unggahan terjadwal dan langsung.

Filter Katalog Destinasi ke Set Destinasi

Dokumen Referensi

Set destinasi merupakan subset katalog Anda. Untuk menyiapkan iklan destinasi, Anda membutuhkan set destinasi. Karena itu, Anda harus membuat minimal satu set.

Set destinasi ditetapkan oleh filter yang diterapkan pada katalog destinasi. Contoh: Anda dapat membuat set destinasi dengan semua destinasi yang memiliki penurunan harga besar. Perhatikan, Anda pun dapat membuat set destinasi tanpa filter. Dalam kasus itu, set destinasi akan berisi semua destinasi dalam katalog Anda.

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$destination_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();
from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()
curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

Parameter filter tersusun atas operator dan data berikut:

OperatorsFilter Type

i_contains

Contains substring. Operator is case-insensitive.

i_not_contains

Does not contain substring. Operator is case-insensitive.

contains

Contains substring. Operator is case-insensitive.

not_contains

Does not contain substring. Operator is case-insensitive.

eq

Equal to. Operator is case-insensitive.

neq

Not equal to. Operator is case-insensitive.

lt

Less than. For numeric fields only.

lte

Less than or equal to. For numeric fields only.

gt

Greater than. For numeric fields only.

gte

Greater than or equal to. For numeric fields only.

DataData yang difilter

country

Negara destinasi.

price

Harga untuk destinasi ini. Harga dalam sen.

currency

Mata uang.

price_change

Penurunan atau kenaikan harga.

city

Kota destinasi.

description

Deskripsi untuk destinasi ini.

name

Nama untuk destinasi ini.

destination_set_id

Pengidentifikasi unik Anda untuk destinasi dalam katalog.