ผสานรวม BIGO Ads SDK กับสื่อกลาง

คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก SDK โฆษณา BIGO โดยใช้สื่อกลาง AdMob ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม BIGO Ads SDK ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม BIGO Ads SDK และอะแดปเตอร์เข้ากับแอป iOS

การผสานรวมและรูปแบบโฆษณาที่รองรับ

อะแดปเตอร์สื่อกลางสำหรับ SDK โฆษณาของ BIGO มีความสามารถต่อไปนี้

การผสานรวม
การเสนอราคา
การแสดงวิดีโอตามลำดับขั้น
รูปแบบ
โฆษณาเปิดแอป
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล
เนทีฟ

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

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

  • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป

ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ SDK โฆษณา BIGO

เข้าสู่ระบบแดชบอร์ด BIGO Ads

สร้างแอป

ไปที่แท็บพื้นที่โฆษณา แล้วเลือกปุ่ม + เพิ่มในตารางแอปและเว็บไซต์

เพิ่มแอป

กรอกข้อมูลที่เหลือในแบบฟอร์ม แล้วคลิกส่ง

แบบฟอร์มแอปใหม่

จดบันทึกรหัสแอปพลิเคชัน

รหัสแอปพลิเคชัน

สร้างช่องโฆษณา

เมื่อใบสมัครของคุณได้รับการตรวจสอบแล้ว ให้ไปที่ตารางช่องโฆษณา แล้วเลือกปุ่ม + เพิ่ม

เพิ่มช่องโฆษณา

เลือกการเสนอราคาบนเซิร์ฟเวอร์สำหรับประเภทการประมูล กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ แล้วคลิกส่ง

แบบฟอร์มช่องโฆษณาใหม่

จดบันทึกรหัสช่อง

รหัสช่องโฆษณา

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับแอป

หากต้องการติดตั้งใช้งาน app-ads.txt สำหรับ BIGO Ads SDK ให้ไปที่แท็บ APP-ads.txt จากแดชบอร์ด แล้วทำตามวิธีการที่อยู่ในแท็บ

App Ads Txt

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ SDK โฆษณา BIGO ใน UI ของ AdMob

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

คุณต้องเพิ่ม BIGO Ads SDK ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่ต้องการแก้ไขอยู่แล้ว ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่หัวข้อเพิ่ม SDK โฆษณาของ BIGO Ads เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

ตั้งชื่อกลุ่มสื่อกลางและเลือกสถานที่ตั้งเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นพร้อมหน่วยโฆษณาที่คุณเลือก

เพิ่ม SDK โฆษณา BIGO เป็นแหล่งที่มาของโฆษณา


ในส่วนแหล่งที่มาของโฆษณา ให้ค้นหาการ์ดการเสนอราคา แล้วเลือกเพิ่มแหล่งที่มาของโฆษณา จากนั้นเลือก BIGO Ads SDK

คลิกวิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์และสร้างการเป็นพาร์ทเนอร์เพื่อการเสนอราคากับ BIGO Ads SDK



คลิกรับทราบและยอมรับ แล้วคลิกต่อไป



หากมีการแมปสำหรับ SDK โฆษณา BIGO อยู่แล้ว คุณก็เลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป



ถัดไป ให้ป้อนรหัสช่องที่ได้จากส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น



เพิ่ม BIGO TECHNOLOGY PTE LTD ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

ทำตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Empathy Technology Pte.Ltd. (BIGO Ads) ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรป และเพิ่ม ** BIGOAds** ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob

ขั้นตอนที่ 3: นำเข้า SDK โฆษณาและอะแดปเตอร์ BIGO Ads

CocoaPods

  • เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

    pod 'GoogleMobileAdsMediationBigo'
    
  • เรียกใช้คำสั่งต่อไปนี้จากบรรทัดคำสั่ง

    pod install --repo-update

ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน SDK โฆษณา BIGO

ในการปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ และได้รับความยินยอมในการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นในเครื่องในกรณีที่กฎหมายกำหนด รวมถึงการรวบรวม การแชร์ และการใช้ข้อมูลส่วนตัวสำหรับการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain)

อะแดปเตอร์ BIGO Ads SDK สำหรับ iOS เวอร์ชัน 5.0.6.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง BIGO Ads SDK ดูข้อมูลเพิ่มเติมได้ที่คู่มือการผสานรวม SDK โฆษณาของ BIGO Ads เกี่ยวกับ GDPR

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกากำหนดให้ผู้ใช้มีสิทธิ์เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกการเลือกไม่รับผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาให้ความสามารถในการเปิดใช้การประมวลผลข้อมูลแบบจำกัดสำหรับการแสดงโฆษณา Google แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง (Mediation Chain) ของคุณได้ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง (Mediation Chain) ที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และปฏิบัติตามคำแนะนำจากเครือข่ายแต่ละเครือข่ายเพื่อให้เป็นไปตามข้อกำหนด

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งแฟล็กความยินยอมไปยัง BIGO SDK โฆษณา เรียกใช้เมธอดนี้ก่อนขอโฆษณาผ่าน Google Mobile Ads SDK

Swift

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

Objective-C

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

ดูข้อมูลเพิ่มเติมได้ในคู่มือการผสานรวม SDK โฆษณาของ BIGO Ads เกี่ยวกับ CCPA

ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น

ใช้ SKAdNetwork

ทำตามเอกสารประกอบของ SDK โฆษณา BIGO เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน

เปิดใช้โฆษณาทดสอบ

ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว

BIGO Ads มีรหัสแอปพลิเคชันและรหัสช่องโฆษณาทดสอบสำหรับ iOS เพื่อช่วยในการทดสอบและการผสานรวม

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก BIGO Ads SDK ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา BIGO Ads SDK (การเสนอราคา)

ขั้นตอนที่ไม่บังคับ

โฆษณาเนทีฟ

การแสดงโฆษณา

อะแดปเตอร์ SDK โฆษณา BIGO จะแสดงผลโฆษณาเนทีฟเป็นออบเจ็กต์ GADNativeAd โดยจะป้อนข้อมูลในช่องต่อไปนี้สำหรับ GADNativeAd

ช่อง ชิ้นงานที่รวมอยู่เสมอโดยอะแดปเตอร์ SDK โฆษณา BIGO
บรรทัดแรก
รูปภาพ
เนื้อความ
ไอคอน
คำกระตุ้นให้ดำเนินการ
การให้ดาว
ร้านค้า
ราคา
ผู้ลงโฆษณา

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก BIGO Ads SDK คุณสามารถตรวจสอบข้อผิดพลาดที่เกี่ยวข้องจากการตอบกลับโฆษณาโดยใช้ GADResponseInfo.adNetworkInfoArray ในคลาสต่อไปนี้

GADMediationAdapterBigo

ต่อไปนี้คือรหัสและข้อความที่แสดงโดยอะแดปเตอร์ SDK โฆษณา BIGO เมื่อโหลดโฆษณาไม่สำเร็จ

รหัสข้อผิดพลาด โดเมน เหตุผล
101 com.google.mediation.bigoadapter การกำหนดค่าเซิร์ฟเวอร์ไม่มีรหัสแอปพลิเคชันที่จำเป็น
102 com.google.mediation.bigoadapter การกำหนดค่าโฆษณาไม่ถูกต้อง
103 com.google.mediation.bigoadapter การนำเสนอโฆษณาล้มเหลว
104 com.google.mediation.bigoadapter ขนาดแบนเนอร์ที่ไม่รองรับ
105 com.google.mediation.bigoadapter Bigo โหลดโฆษณาแบนเนอร์สำเร็จ แต่ไม่มีการดูโฆษณา
1000-1100 ส่งโดย SDK โฆษณา BIGO SDK โฆษณา BIGO แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ BIGO Ads SDK

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง iOS ของ BIGO Ads

เวอร์ชัน 6.1.0.0

  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 6.1.0

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.10.0
  • SDK โฆษณา BIGO เวอร์ชัน 6.1.0

เวอร์ชัน 6.0.0.1

  • ตอนนี้อะแดปเตอร์จะแมปคำขอแบนเนอร์แบบปรับขนาดได้กับขนาดแบนเนอร์มาตรฐานที่รองรับซึ่งใกล้เคียงที่สุด

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.10.0
  • SDK โฆษณา BIGO เวอร์ชัน 6.0.0

เวอร์ชัน 6.0.0.0

  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 6.0.0

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.9.0
  • SDK โฆษณา BIGO เวอร์ชัน 6.0.0

เวอร์ชัน 5.3.0.0

  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.3.0

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.6.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.3.0

เวอร์ชัน 5.2.1.0

  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.2.1 แล้ว
  • อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK ขั้นต่ำเป็น 13.3.0 เพื่อใช้ Privacy API ใหม่

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.4.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.2.1

เวอร์ชัน 5.2.0.0

  • ยืนยันความเข้ากันได้กับ SDK โฆษณา BIGO เวอร์ชัน 5.2.0 แล้ว

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.4.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.2.0

เวอร์ชัน 5.1.2.1

  • ตอนนี้อะแดปเตอร์จะส่งต่อแฟล็ก ageRestrictedTreatment Google Mobile Ads SDK ไปยัง COPPA API ของ BIGO Ads SDK

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.3.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.2.0

  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.1.2

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.2.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.1.0

  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.1.1

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.2.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.1.1

เวอร์ชัน 5.1.0.1

  • อัปเดตอะแดปเตอร์เพื่อป้องกันไม่ให้คำขอโฆษณาล้มเหลวเมื่อโหลดโฆษณาแบนเนอร์ที่มีขนาดโฆษณาที่ไม่รองรับ

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.1.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.1.0

เวอร์ชัน 5.1.0.0

  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.1.0

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.1.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.1.0

เวอร์ชัน 5.0.6.2

  • อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.0.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.0.6

เวอร์ชัน 5.0.6.1

  • อัปเดตเวอร์ชัน iOS ขั้นต่ำของ CocoaPods เป็น 13.0

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 13.0.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.0.6

เวอร์ชัน 5.0.6.0

  • การเผยแพร่ครั้งแรก
  • เพิ่มการรองรับการเสนอราคาสําหรับรูปแบบโฆษณาเปิดแอป, แบนเนอร์ (รวมถึง MREC), โฆษณาคั่นระหว่างหน้า, โฆษณาที่มีการให้รางวัล และรูปแบบโฆษณาเนทีฟ
  • ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.0.6

สร้างขึ้นและผ่านการทดสอบด้วย:

  • Google Mobile Ads SDK เวอร์ชัน 12.14.0
  • SDK โฆษณา BIGO เวอร์ชัน 5.0.6