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

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

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

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

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

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

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

• เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป

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

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

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

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

สร้างแอป

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

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

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

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

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

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

จดรหัสช่อง

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

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

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

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

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

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

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

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

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

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

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

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

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

CocoaPods

• เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

  pod 'GoogleMobileAdsMediationBigo'
  

• จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้

  pod install --repo-update

ขั้นตอนที่ 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

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

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

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

ติดตั้งใช้งาน SKAdNetwork

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

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

GADMediationAdapterBigo

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

บันทึกการเปลี่ยนแปลงของตัวกลาง iOS ของโฆษณา BIGO

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

• แมปคำขอแบนเนอร์แบบปรับขนาดได้กับขนาดแบนเนอร์มาตรฐานที่รองรับซึ่งใกล้เคียงที่สุด

เวอร์ชัน 6.0.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ SDK โฆษณา BIGO เวอร์ชัน 6.0.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 13.9.0
• SDK โฆษณา BIGO เวอร์ชัน 6.0.0

เวอร์ชัน 5.3.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ SDK โฆษณา BIGO เวอร์ชัน 5.3.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 13.6.0
• SDK โฆษณา BIGO เวอร์ชัน 5.3.0

เวอร์ชัน 5.2.1.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ BIGO Ads SDK เวอร์ชัน 5.2.1 ได้
• อัปเดตการอ้างอิง Google Mobile Ads SDK ขั้นต่ำเป็น 13.3.0 เพื่อใช้ Privacy API ใหม่

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

• Google Mobile Ads SDK เวอร์ชัน 13.4.0
• SDK โฆษณา BIGO เวอร์ชัน 5.2.1

เวอร์ชัน 5.2.0.0

• ได้รับการยืนยันว่าเข้ากันได้กับ SDK โฆษณา BIGO เวอร์ชัน 5.2.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.4.0
• SDK โฆษณา BIGO เวอร์ชัน 5.2.0

เวอร์ชัน 5.1.2.1

• ตอนนี้อแดปเตอร์จะส่งต่อageRestrictedTreatmentแฟล็ก Google Mobile Ads SDK ไปยัง COPPA API ของ SDK โฆษณา BIGO แล้ว

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

• Google Mobile Ads SDK เวอร์ชัน 13.3.0
• SDK โฆษณา BIGO เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.2.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ SDK โฆษณา BIGO เวอร์ชัน 5.1.2 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 13.2.0
• SDK โฆษณา BIGO เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.1.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ SDK โฆษณา BIGO เวอร์ชัน 5.1.1 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 13.2.0
• SDK โฆษณา BIGO เวอร์ชัน 5.1.1

เวอร์ชัน 5.1.0.1

• อัปเดตอแดปเตอร์เพื่อป้องกันไม่ให้คำขอโฆษณาล้มเหลวเมื่อโหลดโฆษณาแบนเนอร์ที่มีขนาดโฆษณาที่ไม่รองรับ

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

• Google Mobile Ads SDK เวอร์ชัน 13.1.0
• SDK โฆษณา BIGO เวอร์ชัน 5.1.0

เวอร์ชัน 5.1.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ SDK โฆษณา BIGO เวอร์ชัน 5.1.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 13.1.0
• SDK โฆษณา BIGO เวอร์ชัน 5.1.0

เวอร์ชัน 5.0.6.2

• อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.0.0
• SDK โฆษณา BIGO เวอร์ชัน 5.0.6

เวอร์ชัน 5.0.6.1

• อัปเดตเวอร์ชัน iOS ขั้นต่ำของ CocoaPods เป็น 13.0

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

• Google Mobile Ads SDK เวอร์ชัน 13.0.0
• SDK โฆษณา BIGO เวอร์ชัน 5.0.6

เวอร์ชัน 5.0.6.0

• การเผยแพร่ครั้งแรก
• เพิ่มการรองรับการเสนอราคาสำหรับรูปแบบโฆษณาเปิดแอป แบนเนอร์ (รวมถึง MREC) คั่นระหว่างหน้า ที่มีการให้รางวัล และเนทีฟ
• ได้รับการยืนยันว่าใช้งานร่วมกับ BIGO Ads SDK เวอร์ชัน 5.0.6 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 12.14.0
• SDK โฆษณา BIGO เวอร์ชัน 5.0.6