Bidding with In-House Mediation

การผสานการทำงานการประมูลระหว่างเซิร์ฟเวอร์

สื่อกลางโฆษณาภายในองค์กรยังไม่พร้อมให้บริการต่อสาธารณะ

ขณะนี้การประมูลภายในองค์กรด้วย Audience Network เป็นเวอร์ชั่นเบต้าแบบปิดและยังไม่พร้อมให้บริการต่อสาธารณะ เราจะแจ้งข้อมูลอัพเดตเพิ่มเติมหากมีการเปลี่ยนแปลง

ในระหว่างนี้ คุณจะสามารถเข้าถึงการประมูลของ Audience Network ผ่านแพลตฟอร์มสื่อกลางโฆษณาที่เราเป็นพาร์ทเนอร์ด้วยได้

Facebook Audience Network มีการประมูลเรียลไทม์แบบเปิด (ORTB) ที่รองรับทั้งการผสานการทำงานกับไคลเอ็นต์โดยตรงและการผสานการทำงานระหว่างเซิร์ฟเวอร์ คู่มือนี้จะอธิบายวิธีการผสานการทำงานการประมูลจากเซิร์ฟเวอร์การประมูลราคา

ในการผสานการทำงานระหว่างเซิร์ฟเวอร์ เซิร์ฟเวอร์การประมูลราคาจะเรียกใช้ตำแหน่งข้อมูลการประมูลของ Facebook Audience Network และบริษัทรวบรวมโฆษณารายอื่นๆ ทั้งหมดเพื่อรับการตอบกลับราคาประมูล จากนั้น เซิร์ฟเวอร์การประมูลราคาจะทำการประมูลราคาและเลือกราคาประมูลที่ชนะ เซิร์ฟเวอร์การประมูลราคานี้อาจเป็นเซิร์ฟเวอร์ภายในองค์กรที่เรียกใช้ตรรกะการประมูลราคาที่คุณสร้างขึ้น หรืออาจเป็นเซิร์ฟเวอร์จากภายนอกที่ผสานการทำงานกับการประมูลแอพของ Audience Network ซึ่งจะช่วยให้คุณสามารถใช้ทรัพยากรของเซิร์ฟเวอร์และเครือข่ายที่พร้อมใช้งานเพื่อเรียกใช้ตำแหน่งข้อมูลการประมูลของบริษัทรวบรวมโฆษณาได้ นอกจากนี้ยังช่วยให้คุณสามารถเปลี่ยนแปลงการผสานการทำงานของตำแหน่งข้อมูลเหล่านี้ได้โดยไม่ต้องมีการอัพเดตไคลเอ็นต์

ข้อกำหนดเบื้องต้น

ก่อนที่คุณจะเริ่ม โปรดอ่านภาพรวมการประมูลของ Audience Network และหลักปฏิบัติที่ดีที่สุดสำหรับการผสานการทำงานการประมูล

Android

iOS

การเตรียมการ

คุณต้องปฏิบัติตามขั้นตอนต่อไปนี้เพื่อเตรียมการสำหรับการประมูลระหว่างเซิร์ฟเวอร์ภายในองค์กร:

การลงทะเบียนธุรกิจของคุณ

ผู้เผยแพร่โฆษณาแต่ละรายจำเป็นต้องสร้าง ID ธุรกิจของ Audience Network ซึ่งเราจะเพิ่มลงในรายการที่อนุญาตสำหรับการประมูลให้ และคุณจะสามารถสร้างทรัพย์สินได้หลายรายการที่ใช้ตำแหน่งข้อมูลการประมูลภายใต้ ID ธุรกิจนี้

  • ไปที่เอกสาร Facebook Audience Network และคลิกปุ่มเริ่มเลยเพื่อสร้าง ID ธุรกิจใหม่ หรือใช้ ID ธุรกิจเดิมของคุณ
  • คุณสามารถสร้างทรัพย์สินภายใต้ ID ธุรกิจเดียวกันได้ แต่คุณจะต้องลงทะเบียนก่อน โปรดดูรายละเอียดเพิ่มเติมที่ตัวจัดการการสร้างรายได้
  • แจ้ง ID ธุรกิจให้เราทราบ (ID นี้จะเป็น ID ผู้เผยแพร่ของคุณ)
  • คุณสามารถจัดการสิทธิ์การเข้าถึงของผู้ใช้สำหรับธุรกิจ/แอพของคุณได้

การสร้างแอพรักษาความปลอดภัยบน Facebook

ผู้เผยแพร่ภายในฝั่งเซิร์ฟเวอร์ทั้งหมดจำเป็นต้องสร้างแอพรักษาความปลอดภัยบน Facebook ผ่านทาง https://developers.facebook.com เมื่อสร้างแอพเรียบร้อยแล้ว คุณจะได้รับ ID ของแอพและข้อมูลลับของแอพที่เป็นของแอพรักษาความปลอดภัยนั้น โดยคุณจะต้องใช้ข้อมูลลับของแอพในทุกๆ คำขอเพื่อสร้างโทเค็นการยืนยันตัวตนที่ใช้ในการตรวจสอบผู้สร้างคำขอ

ตรวจสอบให้แน่ใจว่าคุณใช้แฮชที่ถูกต้อง (ระบุด้านล่างนี้) และหากแฮชขึ้นต้นด้วย 0 แฮชก็จะไม่หายไป

ปฏิบัติตามขั้นตอนต่อไปนี้หากต้องการสร้างแอพรักษาความปลอดภัยและเชื่อมโยงแอพเข้ากับธุรกิจ:

  1. เข้าสู่ระบบที่ https://developers.facebook.com
  2. คลิก "สร้างแอพ" ในเมนูแอพของฉัน
  3. เลือก "ธุรกิจ" จากนั้นคลิก "ถัดไป"
  4. ระบุชื่อแอพโดยขึ้นต้นด้วย "AN_SECURITY_APP" จากนั้นคลิกสร้าง ID แอพ
  5. เลือกการตั้งค่า → พื้นฐานที่เมนูด้านซ้าย
  6. ในช่องข้อมูลลับของแอพ ให้คลิกแสดง จด ID ของแอพและข้อมูลลับของแอพคุณเอาไว้
  7. ไปที่ https://business.facebook.com แล้วเลือกธุรกิจของคุณ
  8. คลิกการตั้งค่าธุรกิจที่เมนูด้านซ้าย
  9. เลือกบัญชี → แอพที่เมนูด้านซ้ายของหน้าการตั้งค่าธุรกิจ
  10. คลิกเพิ่ม → เพิ่มแอพในหน้าต่างแอพ
  11. ป้อน ID ของแอพที่เป็นของแอพรักษาความปลอดภัยของคุณ จากนั้นคลิกเพิ่มแอพ ขณะนี้ AN_SECURITY_APP ของคุณควรอยู่ภายใต้ธุรกิจของคุณแล้ว

ระบบจะสร้าง authentication_id เฉพาะของคำขอด้วยอัลกอริทึม HMAC-SHA256 โดยอัลกอริทึมดังกล่าวจะใช้อินพุตต่อไปนี้:

  • ID ของคำขอที่ทำหน้าที่เป็นข้อความ
  • ข้อมูลลับของแอพที่ทำหน้าที่เป็นคีย์
      authentication_id = HMAC_SHA256(request_id, app_secret)

จากนั้น ID ที่สร้างขึ้นจะถูกเพิ่มไปยังส่วนขยายของคำขอประมูล OpenRTB ที่ระดับบนสุดในช่อง authentication_id ตัวอย่างเช่น หาก ID ของคำขอคือ "9r90wurjqw" และข้อมูลลับของแอพคือ "12345asdfg" ระบบจะสร้าง authentication_id ดังนี้:

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

โทเค็นนี้จะรวมอยู่ในทุกๆ คำขอพร้อมกับ ID ของแอพที่เป็นของแอพรักษาความปลอดภัย

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

การส่งโทเค็นข้อมูลระบุตัวตนของคุณไปยังผู้ประมูล

ผู้ประมูลของเราคาดว่าจะได้รับโทเค็นข้อมูลระบุตัวตนในช่อง user.buyeruid ของคำขอ ORTB ระบบจะสร้างโทเค็นนี้ในรูปแบบต่างๆ สำหรับแพลตฟอร์มที่แตกต่างกัน

Android

เรียกใช้ com.facebook.ads.BidderTokenProvider.getBidderToken() จาก Audience Network SDK ของ Android ในเธรดเบื้องหลัง ในการส่งคำขอประมูลทุกครั้ง คุณจำเป็นต้องส่งคำขอโทเค็น พร้อมทั้งส่ง IDFA ในช่อง device.ifa ไปยัง AdvertisingIdClient.getAdvertisingIdInfo(context).getId() ด้วย

iOS

เรียกใช้ [FBAdSettings bidderToken] จาก Audience Network SDK ของ iOS ในการส่งคำขอประมูลทุกครั้ง คุณจำเป็นต้องส่งคำขอโทเค็น พร้อมทั้งส่ง IDFA ในช่อง device.ifa ด้วย [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString]

ขั้นตอนถัดไป