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

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

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

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

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

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

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

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

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

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

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

สร้างแอป

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

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

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

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

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

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

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

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

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ SDK โฆษณา BIGO ใน UI ของ Ad Manager

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม SDK โฆษณา BIGO ในบริษัท

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

กำหนดค่าการเสนอราคา SDK โฆษณา BIGO

กำหนดค่าการแมปหน่วยโฆษณา

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

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

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

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 Ads เกี่ยวกับ GDPR

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

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

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

BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)

[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];

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

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

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

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

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

GADMediationAdapterBigo

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

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง iOS ของ BIGO Ads

เวอร์ชัน 6.1.0.0

• ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 6.1.0

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 6.0.0.1

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

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 6.0.0.0

• ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 6.0.0

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 5.3.0.0

• ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 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 แล้ว
• อัปเดตทรัพยากร Dependency ของ 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 ของ BIGO Ads SDK

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 5.1.2.0

• ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.1.2

สร้างขึ้นและทดสอบด้วย:

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

เวอร์ชัน 5.1.1.0

• ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 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

• ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 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