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

เลือกแพลตฟอร์ม: Android iOS Unity Android (เดิม)

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

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

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

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

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

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

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

• เวอร์ชัน Google Mobile Ads SDK (Legacy) ล่าสุด

• ตั้งค่าสื่อกลาง AdMob

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

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

สร้างแอป

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

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

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

สำคัญ: เมื่อสร้างแอปพลิเคชันใหม่แล้ว ระบบจะเปลี่ยนสถานะเป็นอยู่ระหว่างตรวจสอบ ใบสมัครต้องได้รับการตรวจสอบก่อนจึงจะดำเนินการ

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

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

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

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

จดรหัสช่อง

อัปเดต app-ads.txt

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

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

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

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

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

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

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

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

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

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

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

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

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

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



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



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



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

สำคัญ: รหัสแอปพลิเคชันต้อง เชื่อมโยงกับแอปเป้าหมายตามที่ระบุใน UI ของ BIGO Ads SDK

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

สำคัญ: ตรวจสอบว่าคุณมีสิทธิ์การจัดการบัญชีเพื่อทำการกำหนดค่า ความยินยอมของ EU และ GDPR, กฎระเบียบของรัฐในสหรัฐอเมริกา และแพลตฟอร์มการรับส่งข้อความของผู้ใช้ให้เสร็จสมบูรณ์ โปรดดูรายละเอียดที่หัวข้อจัดการสิทธิ์ของผู้ใช้ในการเข้าถึงบัญชี

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

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

หมายเหตุ: การผสานรวม BIGO Ads SDK และ Google Mobile Ads SDK เวอร์ชันที่เข้ากันไม่ได้อาจทำให้เกิดปัญหาในการบิลด์

การผสานรวม Android Studio (แนะนํา)

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

Kotlin

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

ดึงดูด

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

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

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

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

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

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

Java

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

Kotlin

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

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

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

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

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ BIGO Ads SDK ก่อนเผยแพร่แอป

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

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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

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

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

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

เวอร์ชัน 6.1.0.0

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

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.5.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• SDK โฆษณา Bigo เวอร์ชัน 6.1.0

เวอร์ชัน 6.0.1.0

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

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• Bigo Ads SDK เวอร์ชัน 6.0.1

เวอร์ชัน 6.0.0.1

• ปักหมุดการอ้างอิง Kotlin ของอแดปเตอร์เป็น 1.9.0 (เวอร์ชัน Kotlin ขั้นต่ำที่ GMA NextGen SDK รองรับ)

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• Bigo Ads SDK เวอร์ชัน 6.0.0

เวอร์ชัน 6.0.0.0

• ได้รับการยืนยันว่าเข้ากันได้กับ Bigo Ads SDK 6.0.0

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.3.1
• Bigo Ads SDK เวอร์ชัน 6.0.0

เวอร์ชัน 5.10.1.0

• ความเข้ากันได้ที่ได้รับการยืนยันกับ Bigo Ads SDK 5.10.1

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
• Bigo Ads SDK เวอร์ชัน 5.10.1

เวอร์ชัน 5.9.0.1

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

สร้างขึ้นและทดสอบกับ

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

เวอร์ชัน 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
• Bigo Ads SDK เวอร์ชัน 5.7.0

เวอร์ชัน 5.5.2.0

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

สร้างขึ้นและทดสอบกับ

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