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

เลือกแพลตฟอร์ม: Android iOS Unity Android (เวอร์ชันเก่า)

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

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

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

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

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

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

  • เวอร์ชันล่าสุด Google Mobile Ads Unity Plugin
  • Unity Editor เวอร์ชัน 2019.4 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android ให้ตรวจสอบสิ่งต่อไปนี้
    • Android API ระดับ 24 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน iOS ให้ตรวจสอบสิ่งต่อไปนี้
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่ เริ่มต้นใช้งาน
  • ตั้งค่าสื่อกลาง

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

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

สร้างแอป

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

เพิ่มแอป

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

Android

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

iOS

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

อัปเดต 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: ตั้งค่าดีมานด์ของ BIGO Ads SDK โฆษณาใน UI ของ Ad Manager

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

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

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

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

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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI ไว้ คุณสามารถติดตั้งปลั๊กอินสื่อกลาง Google Mobile Ads BIGO Ads SDK โฆษณา สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรี รากของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.bigo

OpenUPM

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > Package Manager เพื่อเปิด การตั้งค่า Unity Package Manager

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตโดยใช้รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่ หน้าต่าง > Package Manager เพื่อเปิด Unity Package Manager แล้ว เลือก รีจิสทรีของฉัน จากเมนูแบบเลื่อนลง

Unity Registries

เลือกแพ็กเกจ Google Mobile Ads Bigo Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลด Google Mobile Ads Mediation Plugin เวอร์ชันล่าสุดสำหรับ BIGO Ads SDK จากลิงก์ดาวน์โหลดใน the บันทึกการเปลี่ยนแปลง แล้วแยก GoogleMobileAdsBigoMediation.unitypackageออกจากไฟล์ zip

ในโปรแกรมแก้ไขโปรเจ็กต์ Unity ให้เลือกชิ้นงาน > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsBigoMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว จากนั้นคลิกนำเข้า

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ปัญหาการพึ่งพาจากจุดเริ่มต้นและคัดลอกการพึ่งพาที่ประกาศไว้ลงในไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับแก้ไข

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

หากต้องการใช้การตั้งค่าความเป็นส่วนตัวสำหรับ BIGO Ads SDK และปฏิบัติตามกฎระเบียบด้านความเป็นส่วนตัวที่เกี่ยวข้อง โปรดอ่านส่วนต่อไปนี้

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

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

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

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

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

using GoogleMobileAds.Mediation.Bigo.Api;
// ...

Bigo.SetCcpaConsent(true);

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

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

Android

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

iOS

GADMediationAdapterBigo

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

Android

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

iOS

รหัสข้อผิดพลาด โดเมน เหตุผล
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 ส่งโดย BIGO Ads SDK BIGO Ads SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ BIGO Ads SDK

บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง BIGO Ads SDK โฆษณา Unity

เวอร์ชัน 3.1.0 (อยู่ระหว่างดำเนินการ)

เวอร์ชัน 3.0.0

เวอร์ชัน 2.0.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0