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

เลือกแพลตฟอร์ม: Android ใหม่ Android iOS Unity

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

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

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

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

1 การผสานรวมการเสนอราคาอยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง

ข้อกำหนด

  • ระดับ API 23 ขึ้นไป ของ Android

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

เข้าสู่ระบบแดชบอร์ดโฆษณา BIGO

สร้างแอป

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

เพิ่มแอป

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

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

จดรหัสแอปพลิเคชันของคุณ

รหัสแอปพลิเคชัน ตามขั้นตอนถัดไปได้

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

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

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

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

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

จดรหัสสล็อต

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

อัปเดต app-ads.txt

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

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

App Ads Txt

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ SDK ของ BIGO Ads ใน UI ของ Ad Manager

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม BIGO Ads SDK ในบริษัท

การเสนอราคา

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา

เลือก BIGO Ads SDK เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง

คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อเสร็จแล้ว

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

การเสนอราคา

ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

การเสนอราคา

ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ ค้นหา BIGO TECHNOLOGY PTE LTD แล้วเปิดเปิดใช้การผสานรวมแอป

คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

การเสนอราคา

ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่า เริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับ SDK Bidding

คลิกบันทึก

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

กำหนดค่าการเสนอราคา SDK ของโฆษณา BIGO

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

คลิกผู้เสนอราคารายใหม่

เลือก BIGO Ads SDK เป็นผู้เสนอราคา

คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้

คลิกเสร็จสิ้น

น้ำตก

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก

กำหนดค่าการแมปหน่วยโฆษณา

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

เลือกบริษัทสำหรับ BIGO Ads SDK

ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่

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

สุดท้าย ให้คลิกบันทึก

น้ำตก

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

เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน

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

ป้อน ที่ได้รับในส่วนก่อนหน้าและค่า CPM เริ่มต้น คลิก บันทึก

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

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

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

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency ในการติดตั้งใช้งานต่อไปนี้

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.3.0")
    implementation("com.google.ads.mediation:bigo:5.9.0.0")
}

ดึงดูด

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.3.0'
    implementation 'com.google.ads.mediation:bigo:5.9.0.0'
}

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

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

BIGO Ads SDK จะอ่านความยินยอมตาม GDPR ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ใน คู่มือการผสานรวม SDK ของโฆษณา BIGO ใน GDPR

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

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

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

Java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);

Kotlin

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)

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

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

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม BIGO Ads SDK

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

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

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

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

รหัสข้อผิดพลาด โดเมน เหตุผล
101 com.google.mediation.bigoadapter ไม่มีหรือไม่มี Bigo Slot Id
1000-1100 ส่งโดย BIGO Ads SDK SDK โฆษณาของ BIGO แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ใน เอกสารประกอบของ SDK โฆษณาของ BIGO

บันทึกการเปลี่ยนแปลงของ Bigo Android Mediation Adapter

เวอร์ชันถัดไป

  • แมป AgeRestrictedTreatment กับ COPPA API ของ Bigo

เวอร์ชัน 5.9.0.0

  • ยืนยันความเข้ากันได้กับ Bigo Ads SDK 5.9.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 25.2.0
  • Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.0.1
  • Bigo Ads SDK เวอร์ชัน 5.9.0

เวอร์ชัน 5.8.0.0

  • เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK
  • ได้รับการยืนยันว่าเข้ากันได้กับ Bigo Ads SDK 5.8.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 25.1.0
  • Bigo Ads SDK เวอร์ชัน 5.8.0

เวอร์ชัน 5.7.1.0

  • ยืนยันความเข้ากันได้กับ Bigo Ads SDK 5.7.1

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 25.0.0
  • Bigo Ads SDK เวอร์ชัน 5.7.1

เวอร์ชัน 5.7.0.0

  • เพิ่มการรองรับการส่งต่อพารามิเตอร์ tagForUnderAgeOfConsent Google Mobile Ads SDK ไปยัง Bigo Ads SDK
  • ยืนยันความเข้ากันได้กับ Bigo Ads SDK 5.7.0

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 24.9.0
  • SDK ของ Bigo Ads เวอร์ชัน 5.7.0

เวอร์ชัน 5.5.2.0

  • เพิ่มการรองรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า โฆษณาที่มีการให้รางวัล และโฆษณาเนทีฟ
  • ยืนยันความเข้ากันได้กับ Bigo Ads SDK 5.5.2

สร้างและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 24.9.0
  • SDK ของ Bigo Ads เวอร์ชัน 5.5.2