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:
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.
Contoh CSV | Contoh TSV (diratakan) | Contoh TSV (gaya JSON)
"
tanda kutip"
. 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.<listings>
akar menyertakan set node <listing>
, masing-masing mewakili satu destinasi.<?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 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 Kolom | Deskripsi |
---|---|
jenis: string | Wajib. Panjang maks: 100 Pengidentifikasi unik Anda untuk destinasi dalam katalog. Ini akan dicocokkan dengan |
jenis: objek | Wajib. Alamat lengkap untuk destinasi yang harus dapat ditemukan lokasinya Lihat Parameter Objek Alamat |
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: Lihat Parameter Objek Gambar |
jenis: string | Wajib. Tautkan ke situs eksternal tempat Anda dapat melihat halaman destinasi. Anda pun dapat menetapkan URL level iklan menggunakan |
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 |
jenis: string | Wajib. Nama paling umum dari destinasi. |
jenis: string | Opsional. Item maksimal: 20 Satu atau beberapa lingkungan sekitar untuk destinasi. Contoh: |
jenis: float | Opsional. Garis lintang destinasi. Contoh: |
jenis: float | Opsional. Garis bujur destinasi. Contoh: |
jenis: string | Opsional. Ukuran maksimal: 5.000 Paragraf pendek yang menjelaskan destinasi. |
jenis: string | Opsional. Dapat berupa harga terendah atau rata-rata untuk destinasi ini. Anda harus menentukan nilainya dengan mata uang. Contoh: |
jenis: int | Opsional. Perubahan harga:
Ini dapat digunakan untuk membuat set produk dan di materi iklan universal ("harga rata-rata turun sebesar X"). |
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:
|
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 |
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.
Nama dan Jenis Kolom | Deskripsi |
---|---|
jenis: string | Wajib. URL gambar destinasi. Ikuti spesifikasi gambar berikut:
|
jenis: string | Opsional. String yang mewakili apa yang ada di gambar. Beberapa tanda bisa dikaitkan dengan sebuah gambar. Contoh:
|
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 Kolom | Deskripsi |
---|---|
jenis: string | Alamat jalan destinasi. Contoh: |
jenis: string | Wajib. Kota tempat destinasi berada. Contoh: |
jenis: string | Wajib. Negara bagian, distrik, daerah, atau provinsi destinasi. Contoh: |
jenis: string | Kode pos untuk destinasi. Wajib kecuali jika negara tidak memiliki sistem kode pos. Contoh:
|
jenis: string | Wajib. Negara destinasi. Contoh: |
jenis: string | Nilai untuk digunakan di URL tautan dalam ( |
If you have separate apps for iPhone and iPad, specify iPhone and iPad specific information. Otherwise specify only iOS information.
Field Name and Type | Description |
---|---|
type: string | A custom scheme for the iOS app. Example: |
type: string | The app ID for the App Store. Example: 1234 |
type: string | The name of the app (suitable for display). Example: |
type: string | A custom scheme for the iPhone app. Example: |
type: string | The app ID for the App Store. Example: |
type:string | The name of the app (suitable for display). Example: |
type: string | A custom scheme for the iPhone app. Example: |
type: string | The app ID for the App Store. Example: |
type: string | The name of the app (suitable for display). Example: |
type: string | A custom scheme for the Android app. Example: |
type: string | A fully-qualified package name for intent generation. Exammple: |
type: string | The name of the app (suitable for display). Example: |
Bagian berikut hanya relevan untuk mengelola katalog Anda menggunakan API ini.
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
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.
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:
Operators | Filter Type |
---|---|
| Contains substring. Operator is case-insensitive. |
| Does not contain substring. Operator is case-insensitive. |
| Contains substring. Operator is case-insensitive. |
| Does not contain substring. Operator is case-insensitive. |
| Equal to. Operator is case-insensitive. |
| Not equal to. Operator is case-insensitive. |
| Less than. For numeric fields only. |
| Less than or equal to. For numeric fields only. |
| Greater than. For numeric fields only. |
| Greater than or equal to. For numeric fields only. |
Data | Data yang difilter |
---|---|
| Negara destinasi. |
| Harga untuk destinasi ini. Harga dalam sen. |
| Mata uang. |
| Penurunan atau kenaikan harga. |
| Kota destinasi. |
| Deskripsi untuk destinasi ini. |
| Nama untuk destinasi ini. |
| Pengidentifikasi unik Anda untuk destinasi dalam katalog. |