Bidding with In-House Mediation

Integrasi Tawaran Server-ke-Server

Mediasi internal tidak tersedia untuk umum

Tawaran internal dengan Audience Network saat ini dalam Beta Tertutup dan tidak tersedia untuk umum. Kami akan memberikan pembaruan lebih lanjut jika ini berubah.

Sebagai alternatif, Anda dapat mengakses Tawaran Audience Network melalui salah satu platform mediasi yang menjadi partner kami.

Facebook Audience Network memiliki penawar Open Real-Time Bidding (ORTB) yang mendukung integrasi klien langsung dan integrasi server-ke-server. Panduan ini menjelaskan cara mengintegrasikan penawaran dari server lelang.

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

Prasyarat

Sebelum memulai, bacalah Ringkasan Tawaran Audience Network dan Praktik Terbaik Integrasi Tawaran.

Android

iOS

Persiapan

Langkah-langkah berikut diperlukan untuk mempersiapkan penawaran server-ke-server internal:

Mendaftarkan Bisnis Anda

Setiap penerbit perlu membuat ID Bisnis Audience Network, yang akan kami tambahkan ke daftar diizinkan untuk tawaran. Di bawah ID Bisnis ini, Anda dapat membuat beberapa properti yang memanfaatkan endpoint tawaran.

  • Buka dokumentasi Facebook Audience Network dan klik tombol Mulai Sekarang untuk membuat ID Bisnis baru, atau gunakan ID Bisnis Anda yang sudah ada.
  • Anda dapat membuat properti dengan ID Bisnis yang sama tetapi Anda harus mendaftarkannya; lihat Pengelola Monetisasi untuk detail selengkapnya.
  • Beri tahu kami ID Bisnis Anda (ini adalah ID penerbit Anda).
  • Anda dapat mengelola akses pengguna ke bisnis/aplikasi Anda.

Membuat Aplikasi Keamanan Facebook

Semua penerbit internal sisi server harus membuat aplikasi keamanan Facebook di https://developers.facebook.com. Setelah aplikasi dibuat, Anda perlu mendapatkan ID Aplikasi dan Rahasia Aplikasi untuk aplikasi keamanan tersebut. Rahasia Aplikasi akan digunakan di setiap permintaan untuk membuat token autentikasi untuk memvalidasi pembuat permintaan.

Pastikan Anda menggunakan Hash yang benar (ditetapkan di bawah) dan jika hash dimulai dengan 0, maka tidak akan hilang.

Untuk membuat aplikasi keamanan dan menautkannya ke bisnis Anda:

  1. Login ke https://developers.facebook.com.
  2. Di menu Aplikasi Saya, klik Buat Aplikasi.
  3. Pilih Bisnis., lalu klik Berikutnya.
  4. Berikan nama untuk aplikasi dengan awalan "AN_SECURITY_APP", lalu klik Buat ID Aplikasi.
  5. Di menu kiri, pilih Pengaturan →Dasar.
  6. Di kolom Rahasia Aplikasi, klik Tampilkan. Tulis ID Aplikasi dan Rahasia Aplikasi Anda.
  7. Buka https://business.facebook.com dan pilih bisnis Anda.
  8. Di menu kiri, klik Pengaturan Bisnis.
  9. Di menu kiri halaman Pengaturan Bisnis, pilih Akun → Aplikasi.
  10. Di panel Aplikasi, klik Tambahkan → Tambahkan Aplikasi.
  11. Masukkan ID Aplikasi dari aplikasi keamanan Anda, lalu klik Tambahkan Aplikasi. AN_SECURITY_APP Anda sekarang seharusnya ada di bawah bisnis Anda.

authentication_id spesifik permintaan dibuat dengan algoritme HMAC-SHA256. Algoritme ini menggunakan input berikut:

  • ID Permintaan sebagai pesan
  • Rahasia Aplikasi sebagai kunci
      authentication_id = HMAC_SHA256(request_id, app_secret)

ID yang dibuat lalu ditambahkan ke ekstensi permintaan tawaran OpenRTB level atas di kolom authentication_id. Contoh: jika ID permintaannya adalah "9r90wurjqw" dan rahasia aplikasinya adalah "12345asdfg", authentication_id dibuat seperti ini:

      authentication_id = HMAC_SHA256(9r90wurjqw, 12345asdfg) = 39bbe40bc68899a9356085ca8c81

Token ini akan disertakan dalam setiap permintaan bersama dengan ID Aplikasi dari aplikasi keamanan.

      {
      "id": "9r90wurjqw",
      ...
      "ext": {
      "authentication_id": "39bbe40bc68899a9356085ca8c81d3021cfa124f2a2b3c68c88f95fb4cde40a4",
      "security_app_id": "AN_SECURITY_APP_MY_SECURITY_APP_ID" 
      ...
      }
      }

Berikan Token Identitas Anda ke Penawar

Penawar kami mengharapkan token identitas di kolom user.buyeruid dari permintaan ORTB. Token ini dibuat dengan cara berbeda untuk platform berbeda.

Android

Di utas latar belakang, panggil com.facebook.ads.BidderTokenProvider.getBidderToken() dari Android Audience Network SDK. Token harus diminta untuk setiap permintaan tawaran. Juga teruskan IDFA di kolom device.ifa ke AdvertisingIdClient.getAdvertisingIdInfo(context).getId().

iOS

Panggil [FBAdSettings bidderToken] dari iOS Audience Network SDK. Token harus diminta untuk setiap permintaan tawaran. Juga teruskan IDFA di kolom device.ifa dengan [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString].

Langkah Berikutnya