Iklan Katalog Advantage+ untuk Aplikasi Seluler

Anda dapat menyiapkan iklan katalog Advantage+ di perangkat seluler dengan Facebook SDK. Anda harus menggabungkan penautan dalam dan penautan dalam yang ditangguhkan ke aplikasi untuk memberikan pengalaman terbaik bagi orang yang menggunakan aplikasi Anda.

Langkah 1: Siapkan SDK Facebook Seluler untuk iOS/Android

Integrasikan Facebook SDK untuk iOS atau Android.

Langkah 2: Siapkan Peristiwa Aplikasi Seluler

Di web, gunakan peristiwa Meta Pixel seperti ViewContent untuk melacak interaksi peristiwa. Di perangkat seluler, Anda dapat melacak peristiwa yang sama dengan Peristiwa Aplikasi.

Anda harus mengirim tiga peristiwa wajib yang sama dari aplikasi Anda seperti yang Anda lakukan dari Pixel Anda: ViewContent, AddToCart, dan Purchase. Iklan katalog Advantage+ mewajibkan peristiwa-peristiwa ini berfungsi dengan benar.

Peristiwa iOS	Peristiwa Android	Setara Web
`FBSDKAppEventNameViewedContent`	`AppEventsConstants:: EVENT_NAME_VIEWED_CONTENT`	`ViewContent`
`FBSDKAppEventNameAddedToCart`	`AppEventsConstants:: EVENT_NAME_ADDED_TO_CART`	`AddToCart`
`[[FBSDKAppEvents shared] logPurchase:(double) currency:(NSString ) parameters:(NSDictionary )];`	`AppEventsConstants:: EVENT_NAME_PURCHASED`	`Purchase`

Contohnya, peristiwa ViewContent terpicu saat seseorang melihat sebuah produk dalam aplikasi:

[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
  valueToSum:54.23
  parameters:@{
    FBSDKAppEventParameterNameCurrency    : @"USD",
    FBSDKAppEventParameterNameContentType : @"product",
    FBSDKAppEventParameterNameContentID   : @"123456789"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "1234");

logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
                120.00,
                parameters);

Anda juga dapat menyediakan array nilai JSON untuk ID produk saat satu peristiwa terjadi pada beberapa produk. Contoh: Anda dapat mengirim beberapa produk dengan peristiwa Purchase.

[[FBSDKAppEvents shared] logPurchase:54.23 currency : @"USD" parameters:@{
  FBSDKAppEventParameterNameContentID   : @"['1234','5678']",
  FBSDKAppEventParameterNameContentType : @"product"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "['1234', '5678']");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASED,
                180.00,
                parameters);

Beberapa ID Konten

Jika memiliki beberapa ID konten, Anda memberikan array JSON keluar, contoh:

"[\"1234\",\"5678\"]"

Parameter Opsional

Untuk setiap peristiwa aplikasi, Anda dapat mengirimkan parameter tambahan, Anda harus mengirimkannya saat seseorang melakukan pembelian:

Nama	Deskripsi
`_valueToSum` string	Opsional. Nilai produk atau jumlah pembelian
`fb_currency` string	Opsional. Mata uang produk atau jumlah pembelian

Menggunakan Partner Pengukuran Seluler (MMP)

Jika Anda menggunakan Partner Pengukuran Seluler (MMP) yang disetujui untuk melaporkan peristiwa ke Facebook, Anda juga dapat menyesuaikan implementasi untuk mengirimkan peristiwa yang diperlukan. Saat proses ini bervariasi sesuai MMP, biasanya akan terlihat seperti ini:

Sesuaikan integrasi Anda untuk melaporkan tiga peristiwa wajib ke MMP, beserta parameter wajib.
Dengan MMP, petakan nama peristiwa Anda ke nama peristiwa Facebook.
Uji Peristiwa Aplikasi.

Peristiwa yang Diperlukan untuk MMP

Peristiwa berikut adalah wajib:

Nama	Deskripsi
`fb_mobile_content_view`	Ketika akun Pusat Akun sudah melihat sebuah produk
`fb_mobile_add_to_cart`	Saat barang sudah ditambahkan ke keranjang
`fb_mobile_purchase`	Saat barang/beberapa barang sudah dibeli

Anda juga harus mengirimkan dua parameter tambahan agar Iklan Katalog Advantage+ berfungsi:

ID barang yang telah dilihat, telah ditambahkan ke keranjang belanja, atau telah dibeli
Apakah ID adalah product atau product_group

Berikut parameter tambahan yang tersedia:

Nama	Deskripsi
`fb_content_type` string	`product` atau `product_group`
`fb_content_id` string	Wajib. String berisi array berenkode JSON dari ID produk atau grup produk peritel
`_valueToSum` string	Opsional. Nilai produk yang dibeli
`fb_currency` string	Opsional. Mata uang produk atau jumlah pembelian

Catatan:Anda juga harus mengirimkan parameter _valueToSum dan fb_currency saat seseorang membeli barang.

Menguji Peristiwa Aplikasi

Cara termudah untuk menguji apakah integrasi Anda berfungsi adalah dengan Bantuan Iklan Aplikasi untuk melihat peristiwa dan parameter yang dilaporkan ke Facebook secara realtime.

Pilih aplikasi.
Anda akan melihat dua fitur di bagian bawah halaman. Pilih Uji Peristiwa Aplikasi.
Ada dua opsi: melihat peristiwa yang Anda laporkan, atau dengan ID Iklan tertentu. Di sebagian besar kasus, memilih Saya sudah cukup. Pastikan Facebook telah terinstal di perangkat dan Anda sudah login.
Saat Anda melakukan tindakan di aplikasi, peristiwa akan muncul di fitur beserta parameternya.

Anda akan melihat tiga nama peristiwa ini jika integrasi berhasil:

FB_MOBILE_CONTENT_VIEW
FB_MOBILE_ADD_TO_CART
FB_MOBILE_PURCHASE

Pelajari selengkapnya tentang peristiwa aplikasi iOS dan Android.

Untuk memverifikasi fungsi peristiwa aplikasi Anda, Anda dapat memeriksa acara terbaru di

Pengelola Peristiwa Facebook

Langkah 3: Siapkan Penautan Dalam

Dengan memberikan tautan dalam di kabar produk, semua orang yang berinteraksi dengan iklan Anda di Facebook dapat langsung menuju lokasi spesifik dari aplikasi Anda. Contoh: saat seseorang mengeklik iklan di Facebook untuk seluler, orang tersebut akan melihat produk di aplikasi seluler Anda. Lihat Penautan Dalam dan Verifikasikan Penautan Dalam untuk informasi selengkapnya.

Fallback ke Web versus App Store

Jika menggunakan tautan dalam, Anda dapat menentukan perilaku fallback apabila seseorang belum menginstal aplikasi Anda. Jika Anda menyediakan tautan dalam di kabar produk, orang tanpa aplikasi Anda akan melihat URL web untuk produk di dalam iklan.

Karena tujuan Anda adalah untuk meningkatkan penjualan katalog, Anda mungkin ingin orang melihat halaman produk, bukan menginstal aplikasi Anda. Oleh karena itu, kami membuatnya default untuk URL web, meskipun Anda dapat menentukan perilaku yang berbeda untuk kontrol lebih lanjut. Atur perilaku fallback ke applink_treatment saat Anda membuat iklan katalog Advantage+ dan gunakan salah satu opsi berikut:

Nama	Deskripsi
`web_only`	Selalu kirim seseorang ke URL web yang ada. Tindakan ini mengesampingkan semua tautan dalam di kabar Anda.
`deeplink_with_web_fallback`	Jika aplikasi tersebut terinstal dan kami memiliki tautan dalam Anda yang sesuai, kirim seseorang ke aplikasi Anda. Jika salah satu syarat berikut tidak terpenuhi, kirim mereka ke URL situs webnya.
`deeplink_with_appstore_fallback`	Jika aplikasi tersebut terinstal, dan kami memiliki informasi tautan dalam yang sesuai, kirim seseorang ke aplikasinya. Jika aplikasi belum terinstal, arahkan mereka ke app store untuk mendapatkan aplikasinya.

Langkah 4: Siapkan Kabar Produk

Sekarang Anda perlu menyediakan tautan dalam yang sebenarnya untuk iklan katalog Advantage+. Lihat Katalog Produk, Penautan Dalam untuk informasi selengkapnya.

Langkah 5: Spesifikasi Pelacakan

Untuk mengukur peristiwa konversi dari situs web dan aplikasi seluler, pastikan iklan katalog Advantage+ memiliki Spesifikasi Pelacakan yang benar, yang diatur untuk peristiwa ini:

Peristiwa	Spesifikasi Pelacakan
`offsite_conversion`	`{ 'action.type': 'offsite_conversion', 'fb_pixel': FB_PIXEL_ID }`
`app_custom_event`	`{'action.type':'app_custom_event','application':APP_ID}`
`mobile_app_install`	`{'action.type':'mobile_app_install','application':APP_ID}`

Selanjutnya Facebook dapat melacak setiap peristiwa yang terjadi dari iklan katalog Advantage+, terlepas dari apakah seseorang melihat situs web atau aplikasi Anda. Untuk menetapkan spesifikasi pelacakan ini:

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad(<AD_ID>);

$ad->{'tracking_spec'} = array(
  array(
    'action.type' => array('app_custom_event'),
    'application' => array($app_id),
  ),
  array(
    'action.type' => array('offsite_conversion'),
    'offsite_pixel' => array(<PIXEL_ID>),
  ),
  array(
    'action.type' => array('mobile_app_install'),
    'application' => array($app_id),
  ),

);
$ad->update();

curl \
  -F 'tracking_spec=[ 
    {"action.type":["app_custom_event"],"application":["101"]}, 
    {"action.type":["offsite_conversion"],"offsite_pixel":["<PIXEL_ID>"]}, 
    {"action.type":["mobile_app_install"],"application":["101"]} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<AD_ID>