คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดง โฆษณาจาก BIGO Ads SDK โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม BIGO Ads SDK ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม BIGO Ads SDK และอะแดปเตอร์เข้ากับแอป iOS
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ BIGO Ads SDK มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | 1 |
| น้ำตก | |
| รูปแบบ | |
| โฆษณาเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
1 การผสานรวมการเสนอราคาอยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 13.3 ขึ้นไป
ล่าสุดจาก Google Mobile Ads SDK
ทําตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ BIGO Ads SDK
เข้าสู่ระบบแดชบอร์ดโฆษณา BIGO
สร้างแอป
ไปที่แท็บพื้นที่โฆษณา แล้วเลือกปุ่ม + เพิ่ม ในตารางแอปและเว็บไซต์
กรอกข้อมูลในส่วนที่เหลือของแบบฟอร์ม แล้วคลิกส่ง
จดรหัสแอปพลิเคชันของคุณ
ตามขั้นตอนถัดไปได้
สร้างช่องโฆษณา
เมื่อตรวจสอบใบสมัครแล้ว ให้ไปที่ตารางช่องโฆษณา แล้ว เลือกปุ่ม + เพิ่ม
เลือกการเสนอราคาฝั่งเซิร์ฟเวอร์สำหรับประเภทการประมูล กรอกข้อมูลที่เหลือใน แบบฟอร์ม แล้วคลิกส่ง
จดรหัสสล็อต
อัปเดต 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 Ads ใน UI ของ Ad Manager
ลงชื่อเข้าใช้บัญชี Ad Manager
เพิ่ม BIGO Ads SDK ในบริษัท
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา
เลือก BIGO Ads SDK เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน แล้วเปิดใช้สื่อกลาง
คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อเสร็จแล้ว
เปิดใช้การแชร์สัญญาณที่ปลอดภัย
การเสนอราคา
ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ
การเสนอราคา
ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ ค้นหา BIGO TECHNOLOGY PTE LTD แล้วเปิดเปิดใช้การผสานรวมแอป
คลิกบันทึก
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK
การเสนอราคา
ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่า เริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับ SDK Bidding
คลิกบันทึก
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
กำหนดค่าการเสนอราคา SDK ของโฆษณา BIGO
การเสนอราคา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK
คลิกผู้เสนอราคารายใหม่
เลือก BIGO Ads SDK เป็นผู้เสนอราคา
คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้
คลิกเสร็จสิ้น
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมแบบน้ำตก
กำหนดค่าการแมปหน่วยโฆษณา
การเสนอราคา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK
เลือกบริษัทสำหรับ BIGO Ads SDK
ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่
เลือกหน่วยโฆษณาที่เฉพาะเจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่เป็น ประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อน รหัสช่อง ที่ได้รับในส่วนก่อนหน้า
สุดท้าย ให้คลิกบันทึก
น้ำตก
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่ เลือกแอปพลิเคชันบนอุปกรณ์เคลื่อนที่
เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน
เลือกบริษัทที่คุณสร้างไว้สำหรับ BIGO Ads SDK ในส่วนก่อนหน้า เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม iOS เป็นแพลตฟอร์ม และใช้งานอยู่เป็นสถานะ
ป้อน ที่ได้รับในส่วนก่อนหน้าและค่า CPM เริ่มต้น คลิก บันทึก
เพิ่ม BIGO TECHNOLOGY PTE LTD ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบระดับรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม BIGO TECHNOLOGY PTE LTD ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ของ BIGO Ads
CocoaPods
เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์
pod 'GoogleMobileAdsMediationBigo'จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้
pod install --repo-update
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน BIGO Ads SDK
เพื่อปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมายกำหนด และสำหรับการเก็บรวบรวม การแชร์ และการใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณาตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain) Google ไม่สามารถส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
BIGO Ads SDK จะอ่านความยินยอมตาม GDPR ที่ตั้งค่าโดยแพลตฟอร์มการจัดการความยินยอมโดยอัตโนมัติ ซึ่งรวมถึง UMP SDK ดูข้อมูลเพิ่มเติมได้ใน คู่มือการผสานรวม SDK ของโฆษณา BIGO ใน GDPR
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัด สำหรับการแสดงโฆษณาของ Google ได้ แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางของคุณ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจเข้าร่วมในการขายข้อมูลส่วนตัว และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้ เป็นไปตามข้อกำหนด
โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งแฟล็กความยินยอมไปยัง BIGO Ads SDK เรียกใช้เมธอดนี้ก่อนขอโฆษณาผ่าน Google Mobile Ads SDK
Swift
BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)
Objective-C
[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการผสานรวม SDK ของโฆษณา BIGO ใน CCPA
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
ติดตั้งใช้งาน SKAdNetwork
ทำตามเอกสารประกอบของ BIGO Ads SDK
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
BIGO Ads มีรหัสแอปพลิเคชันและรหัสช่องโฆษณาทดสอบสำหรับ iOS เพื่อช่วยในการทดสอบและการผสานรวม
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก BIGO Ads SDK ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา BIGO Ads SDK (การเสนอราคา)
ขั้นตอนที่ไม่บังคับ
โฆษณาเนทีฟ
การแสดงโฆษณา
อแดปเตอร์ SDK ของโฆษณา BIGO จะแสดงโฆษณาเนทีฟเป็นออบเจ็กต์
GADNativeAd
โดยจะป้อนข้อมูลฟิลด์
ต่อไปนี้สำหรับGADNativeAd
| ช่อง | ชิ้นงานที่อะแดปเตอร์ SDK โฆษณา BIGO รวมไว้เสมอ |
|---|---|
| บรรทัดแรก | |
| รูปภาพ | |
| เนื้อความ | |
| ไอคอน | |
| คำกระตุ้นให้ดำเนินการ | |
| การให้ดาว | |
| ร้านค้า | |
| ราคา | |
| ผู้ลงโฆษณา |
รหัสข้อผิดพลาด
หากอแดปเตอร์ไม่ได้รับโฆษณาจาก BIGO Ads SDK คุณสามารถตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับของโฆษณาโดยใช้
GADResponseInfo.adNetworkInfoArray
ภายใต้คลาสต่อไปนี้
GADMediationAdapterBigo
ต่อไปนี้คือรหัสและข้อความที่มาพร้อมกันซึ่งอะแดปเตอร์ BIGO Ads SDK จะแสดง เมื่อโหลดโฆษณาไม่สำเร็จ
| รหัสข้อผิดพลาด | โดเมน | เหตุผล |
|---|---|---|
| 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 |
บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง iOS ของ BIGO Ads
เวอร์ชัน 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
- ได้รับการยืนยันว่าเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 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
- BIGO Ads SDK เวอร์ชัน 5.1.2
เวอร์ชัน 5.1.2.0
- ได้รับการยืนยันว่าเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.1.2
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.2.0
- BIGO Ads SDK เวอร์ชัน 5.1.2
เวอร์ชัน 5.1.1.0
- ยืนยันความเข้ากันได้กับ BIGO Ads SDK เวอร์ชัน 5.1.1
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.2.0
- BIGO Ads SDK เวอร์ชัน 5.1.1
เวอร์ชัน 5.1.0.1
- อัปเดตอแดปเตอร์เพื่อป้องกันไม่ให้คำขอโฆษณาล้มเหลวเมื่อโหลดโฆษณาแบนเนอร์ที่มีขนาดโฆษณาที่ไม่รองรับ
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.1.0
- BIGO Ads SDK เวอร์ชัน 5.1.0
เวอร์ชัน 5.1.0.0
- ได้รับการยืนยันว่าใช้งานร่วมกับ BIGO Ads SDK เวอร์ชัน 5.1.0 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.1.0
- BIGO Ads SDK เวอร์ชัน 5.1.0
เวอร์ชัน 5.0.6.2
- อัปเดตทรัพยากร Dependency ของ Google Mobile Ads SDK เป็นเวอร์ชัน 13.0.0
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.0.0
- BIGO Ads SDK เวอร์ชัน 5.0.6
เวอร์ชัน 5.0.6.1
- อัปเดตเวอร์ชัน iOS ขั้นต่ำของ CocoaPods เป็น
13.0
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 13.0.0
- BIGO Ads SDK เวอร์ชัน 5.0.6
เวอร์ชัน 5.0.6.0
- การเผยแพร่ครั้งแรก
- เพิ่มการรองรับการเสนอราคาสำหรับรูปแบบโฆษณาเปิดแอป แบนเนอร์ (รวมถึง MREC) คั่นระหว่างหน้า ที่มีการให้รางวัล และเนทีฟ
- ได้รับการยืนยันว่าใช้งานร่วมกับ BIGO Ads SDK เวอร์ชัน 5.0.6 ได้
สร้างและทดสอบด้วย
- Google Mobile Ads SDK เวอร์ชัน 12.14.0
- BIGO Ads SDK เวอร์ชัน 5.0.6