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

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

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

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

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

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

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

ข้อกำหนด

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

• ล่าสุดGMA Next-Gen SDK

• ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

เข้าสู่ระบบแดชบอร์ด 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 จาก แดชบอร์ด แล้วทำตาม วิธีการในแท็บ

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

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

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

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

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

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

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

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

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

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

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

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



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



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



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

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

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

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

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

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

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

การผสานรวมกับ Android Studio (แนะนำ)

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1")
    implementation("com.google.ads.mediation:bigo:5.9.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.1.1'
    implementation 'com.google.ads.mediation:bigo:5.9.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

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

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

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

Java

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

Kotlin

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

ดูข้อมูลเพิ่มเติมได้ในคู่มือการผสานรวม CCPA ของ BIGO Ads SDK

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

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

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

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

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

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

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

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

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Bigo สำหรับ Android

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

• แมป 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
• 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