Tawaran Server ke Server

Di bagian Server ke Server:

• Integrasi
• Pengaturan Server Lelang
• Pengaturan Klien Android
• Pengaturan Klien iOS
• Pengujian
• Pemecahan Masalah

Di halaman ini:

Facebook Audience Network mendukung tawaran di aplikasi seluler serta situs web seluler. Integrasi tawaran aplikasi seluler dapat dari klien seluler ke server kami atau dari server Anda ke server kami. Ringkasan ini akan mencakup konsep umum tawaran aplikasi.

• Pendahuluan
• Arsitektur Integrasi
• Permintaan/Tanggapan ORTB dan Format Iklan yang Didukung
• Notifikasi Menang/Kalah/Dapat Ditagihkan/Waktu Habis
• Pembayaran, Lelang, Visibilitas, dan Latensi

Pendahuluan

Apa itu Tawaran Aplikasi

Tawaran Aplikasi merupakan salah satu cara bagi penerbit untuk melakukan lelang imparsial dan terbuka atas stok iklannya, dengan menawarkan setiap kesempatan iklan bagi beberapa sumber permintaan secara realtime. Setiap sumber permintaan memiliki kesempatan untuk bersaing dan memenangkan setiap impresi, jika nilainya tertinggi.

Mengapa Harus Tawaran Aplikasi?

• Lelang realtime adalah kesempatan untuk mengoptimalkan setiap permintaan iklan.
• Memberikan visibilitas terkait nilai yang sebenarnya dari stok iklan Anda.
• Mudah dipelihara dan memerlukan lebih sedikit sumber daya operasi iklan.

Arsitektur Integrasi

Tawaran aplikasi ditawarkan melalui endpoint yang menerapkan protokol Tawaran Realtime Terbuka / Open Real-Time Bidding (ORTB) untuk memberikan tawaran pada kesempatan impresi individu. Audience Network SDK diperlukan dalam tawaran aplikasi untuk melakukan tindakan berikut:

• Mendapatkan buyeruid (disebut bidderToken di Audience Network SDK). Token ini adalah kolom wajib dalam permintaan tawaran, dan bersifat unik baik per pengguna maupun per aplikasi; token tidak valid untuk pengguna atau aplikasi lain.
• Memuat tanggapan tawaran dan menampilkan iklan jika penawar memenangkan lelang.
• Merekam impresi dan klik.

Langkah Penting dalam Alur Tawaran

1. Mendapatkan token penawar. Audience Network membutuhkan string buram ini untuk menanggapi permintaan tawaran.
2. Mengirim permintaan penawaran dan mendapatkan tanggapan tawaran. Ini adalah interaksi utama dengan endpoint tawaran. Dalam langkah ini, Anda mengirim permintaan untuk tawaran ORTB dan kemudian menerima tanggapan tawaran yang valid atau kesalahan.
3. Menjalankan lelang. Jalankan lelang dan pilih pemenang dari antara tanggapan tawaran. Sebagian besar lelang membandingkan tawaran realtime dengan estimasi CPM dari sumber permintaan lain (seperti CPM rata-rata historis); ini dilakukan karena beberapa sumber permintaan tidak mendukung tawaran realtime. Lelang dapat dijalankan oleh salah satu dari berikut ini:
   • Server internal yang menjalankan logika lelang khusus Anda sendiri
   • Server lelang pihak ketiga
   • Klien di perangkat pengguna
4. Ambil kembali iklan dengan tanggapan tawaran. Jika Audience Network memenangkan lelang, muat iklan dengan melewati kolom adm dari tanggapan tawaran ke Audience Network SDK pada perangkat pengguna. Perhatikan bahwa kolom adm tidak berisi iklan sebenarnya, tetapi hanya berisi informasi yang mengizinkan SDK untuk mengambil iklan dari server Audience Network.

Jenis Integrasi

Saat menjalankan lelang (langkah ke-3 di alur tawaran di atas), hal itu dapat di-host di Sisi Klien atau Sisi Server. Di bawah ini adalah 3 jenis integrasi yang berbeda:

Arsitektur Integrasi Server-ke-Server

Pada integrasi server-ke-server, server lelang menjalankan endpoint penawaran Audience Network Facebook dan semua sumber permintaan lainnya untuk mendapatkan tanggapan penawaran. Lalu, server lelang menjalankan lelang dan memilih penawaran yang menang. Server lelang ini dapat berupa server sendiri yang menjalankan logika lelang yang Anda bangun atau dapat berupa server pihak ketiga yang terintegrasi dengan penawaran aplikasi Audience Network. Ini memungkinkan Anda memanfaatkan sumber daya server dan jaringan yang tersedia untuk menjalankan endpoint penawaran sumber permintaan. Ini memungkinkan Anda melakukan perubahan pada integrasi endpoint tersebut tanpa memerlukan pembaruan klien.

Integrasi Server Iklan Eksternal

Integrasi server iklan eksternal memungkinkan Anda menjembatani dunia mediasi air terjun hari ini dengan penawaran aplikasi. Integrasi ini berfungsi dengan melakukan integrasi server-ke-server dengan sumber permintaan yang mendukung penawaran aplikasi dan kemudian meneruskan pemenang lelang ke platform mediasi air terjun yang menjalankan air terjun dan memilih keseluruhan sumber permintaan yang menang. Integrasi ini dimaksudkan sebagai jembatan interim antara dunia mediasi air terjun dan penawaran aplikasi. Dengan integrasi jenis ini Anda tidak perlu menuliskan logika lelang sendiri.

Permintaan/Tanggapan ORTB dan Format Iklan yang Didukung

Permintaan ORTB

Endpoint tawaran kami mendukung bagian dari protokol OpenRTB v2.5.

Catatan: Silakan lihat contoh permintaan lengkap di Panduan Pengaturan Server Lelang

'id' => string, // platform's auction identifier,
'imp' => vec< // slots to bid on
shape(
'id' => string, // platform's identifier for this slot auction
// only for banner impression opportunities
'banner' => shape(
'w' => int, // width
'h' => int, // height
),
// only for native impression opportunities
'native' => shape(
'w' => int, // width 
'h' => int, // height 
),
// only for video impression opportunities
'video' => shape(
'w' => int, // width
'h' => int, // height
'linearity' => int, // 1 = instream, optional
'ext' => shape(
'videotype' => string, // 'rewarded' for Rewarded Video impression opportunities, optional
),
),
'tagid' => string, // Placement ID
'instl' => int, // interstitial flag, 1 = On, 0 = Off, optional
)
>,
// app details (in-app bidding only)
'app' => shape( 
'publisher' => shape(
'id' => string, // publisher app ID
),
),
'device' => shape(
'ua' => string, // device user-agent
'ifa' => string, // ID sanctioned for advertiser use
// Do not send ip or ipv6 if you are requesting bids from the client device.
// For server-side bid requests set ip or ipv6.
'ip' => string, // device IPv4
'ipv6' => string, // device IPv6
'dnt' => int, // "do not track", 1 = On, 0 = Off, optional
'lmt' => int, // "limit ad tracking", 1 = On, 0 = Off
),
'regs' => shape( // regulations object
'coppa' => int, // US FTC regulations for Children's Online Privacy Protection Act, 1 = On, 0 = Off, optional
),
'user' => shape(
'buyeruid' => string, // Audience Network Identity Token, mandatory
),
'ext' => shape(
'platformid' => string, // Mediation partner Platform ID or publisher FB app ID, mandatory
'authentication_id' => string // Authentication token to validate the originator of the request                     
),
'at' => int, // auction type: 1 = First Price, 2 = Second Price
'tmax' => int, // auction timeout in milliseconds
'test' => int, // 0 = normal, 1 = test-mode (we bid $99.99, but don't pay out), optional

Tanggapan ORTB

Tanggapan tawaran berlaku selama 30 menit. Anda dapat meminta iklan kapan saja dalam waktu 30 menit sejak menerima tanggapan tawaran. Semua impresi berdasarkan tawaran yang lebih dari 30 menit tidak akan dibayar.

Catatan: begitu Anda meminta iklan dengan tanggapan tawaran, iklan dapat di-cache pada klien tetapi harus ditampilkan dalam 60 menit sejak dimuat. Semua impresi berdasarkan iklan yang di-cache lebih dari 60 menit tidak akan dibayar.

1  
'id' => string // platform's request identifier
'seatbid' => vec<
    shape(
        'bid' => vec<
            shape(
                'id' => string, // Our identifier for this bid
                'impid' => string, // platform's identifier for this slot auction
                'price' => float, // Our bid price on CPM basis, in USD
                'adm' => string, // Our creative - see Rendering The Ad
                'nurl' => string, // URL to get if we win the impression
                'lurl' => string, // URL to get if we lose the impression
            )
        >,
    ),
>,
'bidid' => string, // Our identifier for this response
'cur' => string, // bid currency: USD

Notifikasi Menang/Kalah/Dapat Ditagihkan/Waktu Habis

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=${AUCTION_LOSS}&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/burl/?partner=${PARTNER_FBID}&app=${APP_FBID}&placement=${PLACEMENT_FBID}&auction=${AUCTION_ID}&impression=${IMPRESSION_ID}&request=${BID_REQUEST_ID}&bid=${BID_ID}&ortb_loss_code=0&clearing_price=${AUCTION_PRICE}"

"https://www.facebook.com/audiencenetwork/nurl/?partner=${PARTNER_FBID}&app=${APP_FBID}&auction=${AUCTION_ID}&ortb_loss_code=2"

Pembayaran, Lelang, Visibilitas, dan Latensi

Harga dan Pembayaran

Pembayaran dikutip dalam USD berdasarkan CPM (misalnya: 4,25 artinya kami akan membayar $4,25/1.000 impresi jika kami menang). Satuan yang sama harus digunakan untuk harga kliring dalam nurl, lurl. Pembayaran dilakukan langsung kepada penerbit.

Mekanika Lelang

Kami selalu menawar berdasarkan harga pertama, artinya kami membayar jumlah yang kami tawar dan kami menawar dengan asumsi kami akan membayar jumlah penuh. Ini berarti kami berada pada posisi yang kurang menguntungkan dalam lelang harga kedua, di mana penawar lain dapat mengajukan tawaran dengan asumsi mereka akan membayar kurang dari jumlah tawaran.

Visibilitas

Untuk impresi aplikasi, kami hanya membayar jika impresi dilihat, terlepas dari apakah kami adalah penawar tertinggi.

Latensi

• Untuk latensi minimum, minta satu tawaran per panggilan API (yaitu jika Anda melelang lima slot, lalu memanggil API lima kali, masing-masing untuk satu tawaran).
• Kami tidak memberikan endpoint khusus wilayah. Infrastruktur Facebook akan mengarahkan permintaan tawaran ke pusat data terdekat.
• Gunakan koneksi persisten HTTP/2.
• Isi kolom tmax ORTB dalam permintaan penawaran dengan waktu habis lelang, dan kami akan memilih strategi tawaran yang menyeimbangkan latensi dan kinerja. (Lihat contoh permintaan tawaran di atas untuk info selengkapnya tentang tmax)
• Untuk memenuhi target latensi, kami dapat menunda sedikit proses untuk me-render waktu (misalnya: tawaran yang lebih cepat mungkin artinya iklan yang di-render lebih lambat, dan tawaran yang lebih lambat menghasilkan iklan yang di-render lebih cepat).
• Kami berupaya aktif untuk meningkatkan latensi. Kami saat ini merekomendasikan waktu habis 800md untuk tawaran server-ke-server.

Lihat Juga

• Integrasi
• Pengaturan Server Lelang
• Pengaturan Klien Android
• Pengaturan Klien iOS
• Pengujian
• Pemecahan Masalah