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

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

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

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

สื่อกลาง Ad Manager สำหรับ BIGO Ads SDK มีความสามารถต่อไปนี้

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

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

ข้อกำหนด

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

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

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

สร้างแอป

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

เพิ่มแอป

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

รายละเอียด OpenUPM

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

รีจิสทรีของ Unity

เลือกแพ็กเกจ สื่อกลาง Bigo สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางของ Google Mobile Ads สำหรับ BIGO Ads SDK เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน บันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsBigoMediation.unitypackage จากไฟล์ ZIP

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

นำเข้าจาก Unity

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

บังคับแก้ไข

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

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

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

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

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

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

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งแฟล็กความยินยอมไปยัง BIGO Ads 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 Ads SDK คุณสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับของโฆษณาโดยใช้ ResponseInfo ในคลาสต่อไปนี้

Android

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

iOS

GADMediationAdapterBigo

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

Android

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

iOS

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

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

เวอร์ชัน 1.0.0