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

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

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

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

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

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

• เป้าหมายการติดตั้งใช้งาน 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 สำหรับ SDK โฆษณาของ BIGO ให้ไปที่แท็บ 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

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

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

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

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

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

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

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

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

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

โฆษณาเนทีฟ

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

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

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

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

GADMediationAdapterBigo

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

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

เวอร์ชัน 6.1.0.0

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

• ได้รับการยืนยันว่าเข้ากันได้กับ 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แฟล็ก SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ไปยัง COPPA API ของ BIGO Ads SDK

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

• 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

• ยืนยันความเข้ากันได้กับ 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

• ได้รับการยืนยันว่าเข้ากันได้กับ 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