Menguji Penerapan Audience Network

Ketika Anda mengintegrasikan Audience Network Facebook ke dalam situs web atau aplikasi seluler Anda, Anda harus menguji penerapan Anda di perangkat fisik dengan menggunakan iklan produksi sebelum melanjutkan ke proses produksi. Gunakan SDK Audience Network terbaru di integrasi Anda untuk menyertakan perbaikan bug dan peningkatan terbaru. Bagian berikut ini memberikan panduan langkah demi langkah tentang cara menguji integrasi iklan Audience Network dengan aplikasi atau situs web seluler Anda.

Langkah 1: Uji dengan Iklan Produksi

Langkah 2: Periksa Kode Kesalahan Permintaan Iklan Produksi

Langkah 3: Gunakan Debugger Permintaan Audience Network untuk Diagnosis Permintaan Iklan

Langkah 4: Menguji dengan Iklan Uji

Langkah 5: Daftar Periksa Integrasi Iklan Audience Network

Langkah 1: Uji dengan Iklan Produksi

Menguji dengan iklan produksi merupakan proses dua langkah. Langkah pertama adalah menambahkan sejumlah orang ke halaman pengaturan bisnis Anda guna membuat mereka dapat melihat iklan produksi sebelum aplikasi disetujui. Langkah kedua adalah menetapkan penguji untuk menggunakan aplikasi atau situs web seluler Anda saat sudah login ke Facebook.

Menambahkan Penguji Ke Aplikasi Anda

Anda dapat menguji aplikasi atau situs web seluler Anda di perangkat fisik menggunakan iklan produksi dengan memastikan bahwa orang yang menguji tersebut sudah ditambahkan ke aplikasi Facebook Anda dalam peran tertentu. Berikut adalah metode yang disarankan untuk menambahkan penguji ke aplikasi Anda:

  1. Buka Pengaturan Bisnis Anda.
  2. Klik +Tambahkan di tab Orang di sebelah kiri.
  3. Masukkan alamat email orang yang Anda inginkan ke akun Anda di Pengelola Bisnis. Anda dapat memasukkan beberapa orang di sini.
  4. Jika Anda mau, Anda dapat menetapkan peran untuk orang-orang tersebut, atau Anda dapat mengklik Lewati untuk sekadar menambahkan mereka di Pengelola Bisnis.

Jika Anda menggunakan lapisan mediasi, pastikan lapisan mediasi tersebut mengirimkan permintaan ke Audience Network. Jika Anda sudah mengaktifkan uji di lapisan mediasi, mungkin lapisan mediasi tersebut tidak mengirimkan permintaan apa pun ke server kami.

Pengujian Aplikasi Seluler

  1. Distribusikan aplikasi ke perangkat para penguji Anda dengan melalui metode distribusi pilihan Anda, dan pastikan para penguji telah ditambahkan ke halaman pengaturan pengelola bisnis Anda.
  2. Setiap orang yang Anda tambahkan harus sudah menginstal aplikasi Facebook di perangkat mereka dan login ke Facebook dengan menggunakan ID pengguna Facebook yang Anda tambahkan ke peran Penguji. Ini diwajibkan karena Facebook harus mengenali pengguna sebagai seseorang di dalam bisnis Anda agar dapat mengembalikan iklan.
  3. Orang yang menguji kini dapat meluncurkan aplikasi Anda dan memicu penempatan yang ingin Anda uji. Mereka harus melihat iklan produksi.

Saat menguji penempatan iklan, Facebook akan secara sengaja mengirimkan 20% permintaan tidak terisi untuk mengizinkan Anda menguji bagaimana aplikasi atau situs web seluler menangani kasus yang tidak terisi.

Saat menggunakan Testflight untuk mendistribusikan dan menguji aplikasi Anda, Anda tidak akan dapat melihat iklan nyata di dalam bangunan uji tersebut. Sebagai gantinya, Anda akan perlu menetapkan mode uji sebagaimana yang ditunjukkan di bawah guna mendapatkan iklan dari Audience Network. Setiap kali aplikasi yang didistribusikan Testflight meminta Pengidentifikasi untuk Pengiklan (IDFA), maka aplikasi tersebut akan mendapatkan IDFA yang berbeda. Biasanya, IDFA tetap konstan untuk sebuah perangkat hingga pengguna mengatur ulangnya secara manual. Namun ketika sebuah bangunan Testflight meminta IDFA dari sistem operasi, maka ia tidak akan mendapatkan IDFA "sebenarnya". Sebagai gantinya, yang didapatkan adalah IDFA "tiruan" yang berubah-ubah setiap kali aplikasi memintanya.

Untuk mengatasi masalah ini, Anda dapat menyalakan mode uji untuk memungkinkan ditampilkannya iklan uji.



Langkah 2: Periksa Kode Kesalahan Permintaan Iklan Produksi

Saat menguji penerapan Audience Network Facebook, Anda mungkin akan mengalami salah satu dari beberapa kemungkinan kode kesalahan saat membuat sebuah permintaan. Kode kesalahan tersebut akan dijelaskan di bawah ini.

1000 - Network Error

Tanggapan Server Dokumentasi SDK

Code=1000 “Network Error"

  • Error 1000 - Network Error. SDK Audience Network tidak dapat menjangkau facebook.com (http://facebook.com/)
  • Aplikasi Anda harus berusaha membuat permintaan lainnya hingga jaringan tersebut dapat dijangkau. Kami menyarankan untuk membuat permintaan inkremental hingga koneksi dapat dibangun kembali atau Anda menyatakan timeout.

1001 - No Fill

Ini adalah kesalahan yang biasa terjadi saat melakukan pengujian, dan berkaitan dengan tanggapan "Kosong"; penyebab paling umumnya adalah karena pengguna tersebut tidak login ke Aplikasi Facebook saat menguji pada aplikasi seluler Anda atau tidak login ke situs web seluler Facebook saat menguji pada situs web seluler Anda.

Tanggapan Server Dokumentasi SDK

Code=1001 “No Fill”

  • Error 1001 - No Fill. Mungkin hal ini terjadi karena satu atau beberapa penyebab berikut ini:
  • Pengguna tidak login ke Aplikasi Facebook Native di Perangkat Seluler
  • Pengaktifan Pembatasan Pelacakan Iklan (iOS)
  • Pengaktifan opsi tidak berpartisipasi dalam iklan berdasarkan minat (Android)
  • Tidak ada Inventaris Iklan untuk pengguna saat ini
  • Perangkat uji Anda harus menginstal aplikasi Facebook native.
  • Aplikasi Anda harus berusaha membuat permintaan lainnya setelah 30 detik.

1002 - Ad Load Too Frequently

Tanggapan Server Dokumentasi SDK

Code=1002 “Load Too Frequently”

  • Permintaan Iklan didasarkan pada kombinasi dari:
  • ID perangkat
  • ID penempatan
  • Format Tampilan (Banner, Interstisial, Native)
  • Aplikasi Anda harus berusaha membuat permintaan lainnya setelah 30 menit. Kami juga menyarankan untuk menyesuaikan Tingkat Muat Ulang atau Tingkat Permintaan.

1011 - Display Format Mismatch

Tanggapan Server Dokumentasi SDK

Code=1011 “Display Format Mismatch”

  • Error 1011 - Display Format Mismatch dikarenakan:
  • Format tampilan dalam permintaan iklan tidak sesuai dengan format tampilan yang ditentukan untuk penempatan ini.
  • Setiap penempatan hanya dapat digunakan dengan satu format tampilan.
  • Anda bisa membuat penempatan dalam jumlah banyak agar dapat menggunakan format tampilan yang berbeda-beda.

1203 - Not An App Admin, Developer or Tester

Tanggapan Server Dokumentasi SDK

Code=1203 “Not An App Admin, Developer or Tester”

  • Permintaan awal dari paket harus berasal dari Admin, Developer, atau Penguji Aplikasi.

2000 - Server Error

Tanggapan Server Dokumentasi SDK

Code=2000 “Server Error"

  • Error 2000 - Server Error. Kemungkinan karena:
  • ID Penempatan Tidak Valid - Setiap Penempatan dan Jenis memiliki ID Unik
  • Versi SDK yang Tidak Didukung atau Tidak Diupdate - harap unduh versi terbaru atau update Pod Anda menggunakan Cocoa Pods
  • Telepon/penggunaan metode loadAd yang tidak sesuai. Kami menyarankan untuk menempatkan breakpoint di loadAd dan metode/callback yang terkait.
  • Aplikasi Anda harus berusaha membuat permintaan lainnya setelah 30 detik.

2001 - Internal Error

Tanggapan Server Dokumentasi SDK

Code=2001 “Internal Error”

  • Error 2001 - Internal Error. SDK Audience Network tidak dapat memproses tanggapan dari facebook.com
  • Aplikasi Anda harus berusaha membuat permintaan lainnya setelah 30 detik.
  • Jika hal ini terjadi secara terus-menerus, harap kirimkan laporan bug kepada kami.


Langkah 3: Gunakan Debugger Permintaan Audience Network untuk Diagnosis Permintaan Iklan

Setelah menerapkan penempatan di aplikasi Anda, maka Anda dapat menggunakan alat Debugger Permintaan Audience Network untuk memverifikasi bahwa Facebook menerima permintaan dari aplikasi Anda.

  1. Buka Pengelola Monetisasi
  2. Klik Kelola properti
  3. Klik Pengaturan Properti > Debugger Permintaan di bagian kanan atas
  4. Klik Mulai untuk memantau permintaan dari aplikasi maupun situs web Anda.

Pada perangkat uji iOS atau Android Anda yang sebenarnya, iOS atau Android, navigasikan aplikasi Anda untuk memicu penempatan iklan Audience Network. Permintaan iklan akan muncul di alat tersebut. Harap memverifikasi bahwa permintaan dikirim dengan ID penempatan yang benar, nama paket, dsb.

Hal ini memerlukan perangkat fisik dan tidak akan berfungsi di simulator iOS atau emulator Android

Anda harus login ke aplikasi Facebook di perangkat uji yang sama dengan yang Anda gunakan agar dipantau oleh alat ini.

Jika permintaan iklan tidak muncul di alat ini, berarti bahwa Facebook tidak menerima permintaan seperti yang diharapkan. Anda dapat memeriksa item berikut untuk melakukan debug:

  1. Pastikan Anda menggunakan perangkat fisik, bukan simulator/emulator
  2. Pastikan aplikasi Facebook diinstal di perangkat uji Anda
  3. Pastikan bahwa para penguji yang login ke Facebook di perangkat uji mereka juga memiliki peran di dalam bisnis Anda.
  4. Jika menggunakan mediasi, pastikan lapisan mediasi mengirimkan permintaan ke Facebook Audience Network


Langkah 4: Menguji dengan Iklan Uji

Anda harus memastikan bahwa pengguna yang menguji aplikasi Anda telah ditambahkan ke sebuah peran di Pengelola Bisnis aplikasi Anda. Ini adalah metode uji yang disarankan karena memungkinkan Anda melihat iklan produksi di perangkat fisik. Lihat bagian Pengujian Dengan Iklan Produksi untuk informasi selengkapnya tentang metode uji yang disarankan.

Akan tetapi, sebagaimana dicantumkan di bagian sebelumnya, Anda mungkin menyadari bahwa pengujian UI iklan produksi dengan penampilan UI aplikasi Anda tidak selalu memungkinkan. Selain itu, Anda tidak dapat menjamin bahwa iklan yang diterima oleh aplikasi Anda akan berupa iklan gambar, iklan video, atau iklan carousel. Meminta iklan produksi tidak akan menjamin konten dan format iklan yang kembali. Bagaimana jika Anda ingin menguji dengan iklan yang mengandung konten video potret guna memastikan penampilannya sesuai dengan penampilan UI aplikasi Anda?

Untuk meminta iklan uji, Anda akan menggunakan string jenis iklan uji berikut untuk menggabungkan ID penempatan dengan '#' saat menginisialisasi objek iklan Facebook. Template ID penempatan untuk meminta iklan uji adalah TEST_AD_TYPE#YOUR_PLACEMENT_ID.

Anda sebaiknya tidak mengirim aplikasi Anda ke publik dengan kode uji di atas, karena akan menyebabkan hanya iklan uji saja yang ditampilkan. Sebagai gantinya, Anda sebaiknya menggunakan makro pra-prosesor seperti DEBUG atau TESTING lalu gunakan #ifdef untuk membedakan bangunan uji dari bangunan rilis.

Tabel Jenis Iklan Uji

Jenis Iklan Uji Keterangan Format iklan yang didukung

VID_HD_16_9_46S_APP_INSTALL

Iklan video HD 16x9 berdurasi 46 dtk dengan opsi CTA penginstalan aplikasi

Interstisial, Video yang Mendapatkan Hadiah, Native

VID_HD_16_9_46S_LINK

Iklan video HD 16x9 berdurasi 46 dtk dengan opsi CTA tautan

Interstisial, Video yang Mendapatkan Hadiah, Native

VID_HD_16_9_15S_APP_INSTALL

Iklan video HD 16x9 berdurasi 15 dtk dengan opsi CTA penginstalan aplikasi

Interstisial, Video yang Mendapatkan Hadiah, Native

VID_HD_16_9_15S_LINK

Iklan video HD 16x9 berdurasi 15 dtk dengan opsi CTA tautan

Interstisial, Video yang Mendapatkan Hadiah, Native

VID_HD_9_16_39S_APP_INSTALL

Iklan video HD 9x16 berdurasi 39 dtk dengan opsi CTA penginstalan aplikasi

Interstisial, Video yang Mendapatkan Hadiah, Native

VID_HD_9_16_39S_LINK

Iklan video HD 9x16 berdurasi 39 dtk dengan opsi CTA tautan

Interstisial, Video yang Mendapatkan Hadiah, Native

IMG_16_9_APP_INSTALL

Iklan gambar 16x9 dengan opsi CTA penginstalan aplikasi

Banner, Interstitial, Native

IMG_16_9_LINK

Iklan gambar 16x9 dengan opsi CTA tautan

Banner, Interstitial, Native

CAROUSEL_IMG_SQUARE_APP_INSTALL

iklan carousel dengan gambar kotak dan opsi CTA penginstalan aplikasi

Interstitial, Native

CAROUSEL_IMG_SQUARE_LINK

iklan carousel dengan gambar kotak dan opsi CTA tautan

Interstitial, Native

Saat menguji penempatan iklan Anda dengan jenis iklan percobaan, perhatikan Format Iklan yang Didukung. Misalnya, jika Anda membuat Instance Iklan yang Mendapatkan Hadiah untuk meminta iklan dengan jenis iklan percobaan IMG_16_9_APP_INSTALL, Anda akan mendapatkan pesan kesalahan di layar.

Contoh untuk meminta iklan uji dalam kode di perangkat iOS

Misalnya, untuk meminta iklan uji video dengan rasio aspek 9:16 dan tombol CTA penginstalan aplikasi dalam aplikasi iOS Anda, maka Anda harus menginisialisasi objek FBNativeAd dengan menambahkan baris kode berikut:

[FBNativeAd *nativeAd = [[FBNativeAd alloc] initWithPlacementID:@"VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID"];

Anda dapat menjalankan kode di atas untuk meminta iklan uji di proyek NativeAdSample dari folder sampel SDK Audience Network.

Atau, jika Anda harus meminta iklan uji dengan format konten acak, Anda akan melihat pesan seperti ini dicetak di Logcat saat menguji di perangkat Android fisik:

#ifdef DEBUG
[FBAdSettings setLogLevel:FBAdLogLevelLog];
[FBAdSettings addTestDevice:@"HASHED_ID"];
#endif

Anda akan melihat pesan log di bawah ini:

[FBAudienceNetworkLog/FBAdSettings:94] 
When testing your app with Facebook ad units,  
you must specify the device hashed ID to ensure the delivery of test ads, 
add the following code before loading an ad: `[FBAdSettings addTestDevice:@"HASHED_ID"]`
Test mode device hash: bd675f960298a92003630d76fa612b1706b745ab

Ganti HASHED_ID dengan hash perangkat mode uji yang tercetak pada log di atas.

Saat Anda telah selesai menguji, sebaiknya Anda menghapus pengaturan perangkat uji menggunakan baris kode ini:

[FBAdSettings clearTestDevice:[FBAdSettings testDeviceHash]]; 

Contoh untuk meminta iklan uji dalam kode di perangkat Android

Untuk meminta iklan uji video dengan rasio aspek 9:16 dan tombol CTA penginstalan aplikasi di aplikasi Android Anda, maka Anda harus menginisialisasi objek NativeAd dengan menambahkan baris kode berikut:

nativeAd = new NativeAd(this, "VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID");

Atau, jika Anda harus meminta iklan uji dengan format konten acak, Anda akan melihat pesan seperti ini dicetak di Logcat saat menguji perangkat Android fisik:

Log: Hash perangkat mode uji: HASHED_ID Log: Saat menguji aplikasi Anda dengan unit iklan Facebook, Anda harus menentukan ID dengan hash perangkat tersebut untuk memastikan penayangan iklan pengujian, tambahkan kode berikut ini sebelum memuat sebuah iklan: AdSettings.addTestDevice("HASHED ID");

Anda dapat mengaktifkan iklan uji di perangkat dengan menambahkan baris kode berikut ini sebelum memuat sebuah iklan:

AdSettings.addTestDevice("HASHED ID");

Jika Anda ingin menambahkan beberapa perangkat uji, cukup buat Daftar string yang akan ditambahkan sebelum memuat sebuah iklan:

List<String> testDevices = new ArrayList<>();
testDevices.add("HASHED_ID_1");
testDevices.add("HASHED_ID_2");
AdSettings.addTestDevices(testDevices);

Saat Anda telah selesai menguji, sebaiknya Anda menghapus pengaturan perangkat uji menggunakan baris kode ini:

AdSettings.clearTestDevices();

Contoh untuk meminta iklan uji di dasbor mediasi

Selain meminta iklan uji dari kode, Anda dapat mengonfigurasi nilai ID penempatan dengan jenis iklan uji dari dasbor mediasi Anda jika aplikasi Anda menggunakan mediasi. Misalnya, jika Anda menggunakan MoPub, Anda dapat mengedit jaringan Facebook dan menetapkan nilai ID penempatan untuk iklan native menjadi VID_HD_9_16_39S_APP_INSTALL#YOUR_PLACEMENT_ID. Aplikasi Anda akan menerima iklan uji video dengan rasio aspek 9:16 dan tombol CTA penginstalan aplikasi.



Langkah 5: Daftar Periksa Integrasi Iklan Audience Network

  1. Instal dan login ke aplikasi Facebook di perangkat uji Anda.
  2. Tambahkan orang-orang yang menguji iklan Audience Network Anda ke akun Anda di Pengelola Bisnis.
  3. Pastikan Anda menginisialisasi contoh iklan dengan ID penempatan yang dibuat dari Pengelola Bisnis Anda. Buka Langkah-langkah untuk Memulai.
  4. Periksa apakah iklan produksi Audience Network telah berhasil diminta oleh aplikasi Anda. Gunakan Kode Kesalahan Audience Network dan Debugger Permintaan Audience Network untuk diagnosis.
  5. Periksa apakah iklan dapat dilihat dan jelas bagi pengguna aplikasi Anda.
  6. Periksa pengalaman pengguna integrasi iklan Anda menggunakan iklan uji. Pastikan snippet kode iklan uji dihapus sebelum meluncurkan ke toko aplikasi. Jika tidak, aplikasi produksi Anda hanya akan menampilkan iklan uji.