Menguji Penerapan Audience Network

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

Saat dijalankan pada simulator iOS atau Android, iklan uji dapat ditampilkan dengan mengaktifkan mode uji dan menentukan id dengan hash perangkat tersebut. Ini adalah langkah pertama yang tepat dalam melakukan uji penerapan. Kami juga menyarankan untuk melakukan pengujian pada perangkat nyata, menggunakan iklan nyata, dengan mengikuti pedoman di bawah ini.

1. Menguji dengan Iklan Nyata

2. Kode Kesalahan Permintaan Iklan Nyata

3. Menguji dengan Iklan Uji

Menguji permintaan dengan Debugger Permintaan Audience Network

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

Di bagian audience network di dasbor pengembang: https://developers.facebook.com/apps/<your_app_id>/audience-network/

Buka bagian "aplikasi" di sebelah kiri panel di "Audience Network" dan gulir turun untuk melihat "Debugger Permintaan Audience Network". Klik tombol Start dan alat ini akan mulai memantau permintaan dari aplikasi Anda oleh Anda sendiri.

Pada perangkat uji iOS atau Android Anda yang sebenarnya, iOS atau Android, navigasikan aplikasi Anda untuk memicu penempatan iklan audience network, dan permintaan iklan akan muncul di alat ini. 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 masuk 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 dipasang di perangkat uji Anda
  3. Pastikan Anda masuk ke Facebook di perangkat uji Anda dengan pengguna yang menjadi pengurus, pengembang, atau penguji di aplikasi Facebook Audience Network
  4. Jika menggunakan mediasi, pastikan lapisan mediasi mengirimkan permintaan ke Facebook Audience Network

Menguji Dengan Iklan Nyata

Menguji dengan iklan nyata menggunakan dua langkah proses. Langkah pertama adalah menambahkan penguji ke pengaturan aplikasi Anda agar mereka dapat melihat iklan nyata sebelum aplikasi disetujui. Langkah kedua adalah meminta penguji menggunakan aplikasi atau situs web seluler Anda saat sudah masuk ke Facebook. Berikut adalah detail tentang cara kerja langkah-langkah tersebut.

Menambahkan Penguji Ke Aplikasi Anda

Anda dapat menguji aplikasi atau situs web seluler Anda di perangkat nyata menggunakan iklan nyata 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 dasbor aplikasi Anda dan klik tab Peran di sebelah kiri.
  2. Di bagian Penguji, klik tombol Tambahkan Penguji. Pengguna juga dapat berada di peran Pengurus atau Pengembang. Kami menyarankan peran Penguji diberikan kepada pengguna yang ingin menguji aplikasi atau situs web, tetapi mereka tidak diizinkan untuk melihat pengaturan uji di Facebook.
  3. Ketikkan nama, fbid, atau nama pengguna orang yang ingin Anda tambahkan sebagai penguji dan klik kirim. Anda dapat memasukkan beberapa orang di sini.
  4. Sekarang Anda akan melihat orang yang Anda masukkan sebagai Penguji.

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 penguji menggunakan metode distribusi yang Anda pilih.
  2. Setiap penguji yang Anda tambahkan harus sudah memasang aplikasi Facebook di perangkat mereka dan masuk ke Facebook menggunakan id pengguna Facebook yang Anda tambahkan ke peran Penguji. Langkah ini diperlukan karena Facebook harus mengenali pengguna yang bersangkutan sebagai Penguji di aplikasi tersebut untuk mengembalikan sebuah iklan, apa pun status tinjauan aplikasinya.
  3. Sekarang penguji tersebut dapat meluncurkan aplikasi Anda dan melakukan langkah yang diperlukan untuk memicu penempatan yang ingin Anda uji. Mereka harus melihat iklan nyata.

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.

Kode Kesalahan Permintaan Iklan Nyata

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 masuk ke Aplikasi Facebook saat menguji pada aplikasi seluler Anda atau tidak masuk 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 masuk 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 memasang 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 (Spanduk, Interstisial, Native)
  • Aplikasi Anda harus berusaha membuat permintaan lainnya setelah 30 menit. Kami juga menyarankan untuk menyesuaikan Tingkat Muat Ulang atau Tingkat Permintaan.

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 Pengurus, Pengembang, 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 Diperbarui - harap unduh versi terbaru atau perbarui 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 SDK 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.

Menguji dengan Iklan Uji

Anda harus memastikan bahwa pengguna yang melakukan uji aplikasi Anda sudah ditambahkan ke sebuah peran di dasbor aplikasi di Facebook Anda. Ini adalah metode uji yang disarankan karena memungkinkan Anda melihat iklan nyata di perangkat nyata. Lihat bagian Pengujian Dengan Iklan Nyata untuk informasi selengkapnya tentang metode uji yang disarankan.

Akan tetapi, sebagaimana dicantumkan di bagian sebelumnya, Anda mungkin menyadari bahwa pengujian penampilan iklan nyata dengan penampilan UI aplikasi Anda tidak selalu mungkin. Selain itu, Anda tidak dapat menjamin bahwa iklan yang diterima oleh aplikasi Anda akan berupa iklan gambar, iklan video, atau iklan karosel. Meminta iklan nyata 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. Templat id penempatan untuk meminta iklan uji adalah TEST_AD_TYPE#YOUR_PLACEMENT_ID.

Tabel Jenis Iklan Uji

Jenis Iklan Uji Keterangan Format iklan yang didukung

IMG_16_9_APP_INSTALL

Iklan gambar 16x9 dengan opsi CTA pemasangan aplikasi

Spanduk, Interstitial, Native

IMG_16_9_LINK

Iklan gambar 16x9 dengan opsi CTA tautan

Spanduk, Interstitial, Native

VID_HD_16_9_46S_APP_INSTALL

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

Interstitial, Native

VID_HD_16_9_46S_LINK

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

Interstitial, Native

VID_HD_16_9_15S_APP_INSTALL

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

Interstitial, Native

VID_HD_16_9_15S_LINK

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

Interstitial, Native

VID_HD_9_16_39S_APP_INSTALL

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

Interstitial, Native

VID_HD_9_16_39S_LINK

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

Interstitial, Native

CAROUSEL_IMG_SQUARE_APP_INSTALL

iklan karosel dengan gambar kotak dan opsi CTA pemasangan aplikasi

Interstitial, Native

CAROUSEL_IMG_SQUARE_LINK

iklan karosel dengan gambar kotak dan opsi CTA tautan

Interstitial, Native

Contoh untuk meminta iklan uji dalam kode di perangkat iOS

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.

Misalnya, untuk meminta iklan uji video dengan rasio aspek 9:16 dan tombol CTA pemasangan 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 dapat menambahkan baris kode berikut sebelum memuat permintaan iklan:

#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.

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.

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 pemasangan 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 sebenarnya:

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 menyunting 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 pemasangan aplikasi.