Server ke Server: Pemecahan Masalah Integrasi Penawaran

Ketika Anda telah menyelesaikan integrasi penawaran server-ke-server, Anda harus menyelesaikan pengujian integrasi penawaran aplikasi pada perangkat fisik dengan iklan produksi. Jika Anda menghadapi kesalahan http atau 'tidak ada tawaran', sesi ini akan membantu Anda memecahkan masalah penerapan Anda.

Prasyarat

• Pastikan Anda telah menyelesaikan tutorial Android untuk Iklan Native, Iklan Banner Native, Iklan Interstisial, Iklan Banner, Iklan Video Berhadiah.
• Pastikan Anda telah menyelesaikan tutorial iOS untuk Iklan Native, Iklan Banner Native, Iklan Interstisial, Iklan Banner, Iklan Video Berhadiah.
• Pastikan Anda telah membaca Gambaran Umum Penawaran Aplikasi Seluler Audience Network dan Praktik Terbaik Integrasi Penawaran Aplikasi Seluler.
• Pastikan Anda telah menyelesaikan Integrasi Penawaran Server ke Server, Pengaturan Server Lelang, Pengaturan Klien Android, Pengaturan Klien iOS.
• Pastikan Anda telah menjalani Pengujian Integrasi Penawaran Aplikasi.

Bagian

Gunakan cURL untuk Debug Permintaan Penawaran

Kode Kesalahan HTTP dan Resolusi dalam Permintaan Penawaran

Memecahkan Masalah Tidak Ada Tawaran

Gunakan cURL untuk Debug Permintaan Penawaran

Untuk debug permintaan penawaran, Anda dapat memanfaatkan perintah cURL, yang memungkinkan Anda mengirim permintaan penawaran dan menerima respons penawaran di terminal Anda.

Langkah 1. JSON Payload untuk Iklan Interstisial dalam permintaan penawaran

• Ganti YOUR_PLACEMENT_ID dengan ID penempatan Anda
• Ganti YOUR_BUSINESS_ID dengan ID bisnis Anda
• Ganti YOUR_DEVICE_ID dengan ID perangkat Anda
• Ganti YOUR_BIDDER_TOKEN dengan Token Penawar Anda yang dihasilkan dari Audience Network SDK
• Ganti YOUR_PLATFORM_ID dengan ID Platform mitra mediasi (ID Aplikasi FB).
• Jika Anda ingin menguji dengan format iklan yang berbeda, silakan merujuk ke Format Iklan yang Didukung.
• Simpan JSON payload di bawah ini sebagai bid_request.json

{
"id": "vwxfKskkMobzQQ1e7M70",
"imp": [
{
"id": "FB Ad Impression",
"tagid": "YOUR_PLACEMENT_ID",
"instl": 1,
"banner": {
"h": 0,
"w": 0,
"linearity": 0
}
}
],
"app": {
"publisher": {
"id": "YOUR_BUSINESS_ID"
}
},
"device": {
"ua": "Dalvik\/2.1.0 (Linux; U; Android 8.1.0; Android SDK built for x86 Build\/OSM1.180201.000)",
"ifa": "YOUR_DEVICE_ID",
"dnt": 0,
"ip": "125.123.255.123"
},
"user": {
"buyeruid": "YOUR_BIDDER_TOKEN"
},
"regs": {
"coppa": 0
},
"at": 1,
"tmax": 500,
"test": 1,
"ext": {
"platformid": "YOUR_PLATFORM_ID"
}
}

Langkah 2. Kirim permintaan penawaran dengan perintah cURL

• Buka Terminal Anda
• Arahkan ke direktori tempat Anda menyimpan bid_request.json Anda dengan cd ~/{FILE_PATH}

curl -X POST -H "Content-Type: application/json" -d @bid_request.json https://an.facebook.com/placementbid.ortb

Langkah 3. Periksa tanggapan penawaran jika permintaan penawaran itu valid

{
"id": "Auction ID",
"seatbid": [
{
"bid": [
{
"id": "Bid Response ID",
"impid": "FB Ad Impression",
"price": 99.99,
"adm": "{\"type\":\"ID\",\"bid_id\":\"BID ID\",\"placement_id\":\"Placement ID\",\"resolved_placement_id\":\"Resolved Placement ID\",\"sdk_version\":\"SDK Version\",\"device_id\":\"Device ID\",\"template\":102,\"payload\":null}",
"nurl": "https://www.facebook.com/audiencenetwork/nurl/?partner=partner_id&app=app_id&placement=placement_id&auction=auction_id&impression=impression_id&request=request_id&bid=bid_id&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}",
"lurl": "https://www.facebook.com/audiencenetwork/nurl/?partner=partner_id&app=app_id&placement=placement_id&auction=auction_id&impression=impression_id&request=request_id&bid=bid_id&ortb_loss_code=${AUCTION_LOSS}&clearing_price=${AUCTION_PRICE}"
}
]
}
],
"bidid": "Bid ID",
"cur": "USD"
}

Langkah 4. Lihat x-fb-an-errors di header tanggapan HTTP jika Anda tidak mendapatkan tanggapan penawaran di atas.

Perintah cURL untuk menampilkan header tanggapan HTTP.

url -X POST -H "Content-Type: application/json" -v @bid_request.json https://an.facebook.com/placementbid.ortb

...
> Content-Type: application/json
>
* Connection state changed (MAX_CONCURRENT_STREAMS updated)!
< HTTP/2 400
< x-fb-an-request-id: fb_an_request_id
...
< x-fb-an-errors: Value cannot be null: value given: null
...

Silakan merujuk ke Deskripsi Kesalahan HTTP dan Resolusi dalam Permintaan Penawaran untuk memperbaiki permintaan penawaran Anda.

Deskripsi Kesalahan HTTP dan Resolusi dalam Permintaan Penawaran

Saat menguji penerapan tawaran, Anda mungkin mengalami salah satu dari beberapa kemungkinan kode kesalahan saat membuat permintaan penawaran. Kode kesalahan dan resolusi ini dijelaskan di bawah ini.

400 Tanggapan: Invalid Parameter Errors

400 Tanggapan: Unauthorized Errors

204 Tanggapan: Empty Error Message

Memecahkan Masalah Tidak Ada Tawaran

• Pastikan Anda mengambil gambar dan mencatat header HTTP x-fb-an-errors untuk membantu Anda memahami penyebab kesalahan.
• Pastikan aplikasi Facebook diinstal pada perangkat tempat aplikasi Anda berjalan dan Anda masuk ke Facebook dengan akun pengguna asli Anda. Akun pengguna Facebook palsu atau pengujian merupakan pelanggaran terhadap kebijakan Facebook dan akan dinonaktifkan.
• Pastikan Anda mendapatkan token penawar dari Audience Network SDK dengan memanggil com.facebook.ads.BidderTokenProvider.getBidderToken() di Android dan [FBAdSettings bidderToken] di iOS dan mengirim string yang dikembalikan ke kolom buyeruid permintaan penawaran.
• Pastikan Anda mengirimkan id perangkat yang benar di kolom ifa di permintaan penawaran (Android -- AdvertisingIdClient.getAdvertisingIdInfo(context).getId(), iOS -- [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString]).
• Pastikan do-not-track(dnt) tidak diaktifkan di perangkat Anda, dan lolos dnt: 0 (do-not-track) di permintaan penawaran.