คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดง โฆษณาจาก BIGO Ads SDK โดยใช้สื่อกลาง AdMob ซึ่งครอบคลุมการผสานรวมการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม BIGO Ads SDK ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม BIGO Ads SDK และอะแดปเตอร์เข้ากับแอป iOS
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ BIGO Ads SDK มีความสามารถต่อไปนี้
| การผสานรวม | |
|---|---|
| การเสนอราคา | 1 |
| น้ำตก | |
| รูปแบบ | |
| โฆษณาเปิดแอป | |
| แบนเนอร์ | |
| โฆษณาคั่นระหว่างหน้า | |
| ได้รับรางวัลแล้ว | |
| โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล | |
| เนทีฟ | |
1 การผสานรวมการเสนอราคาอยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง
ข้อกำหนด
- เป้าหมายการติดตั้งใช้งาน iOS 13.0 ขึ้นไป
ล่าสุดจาก 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 สำหรับแอป
หากต้องการใช้ app-ads.txt สำหรับ BIGO Ads SDK ให้ไปที่แท็บ APP-ads.txt
จากแดชบอร์ด แล้วทำตาม
วิธีการในแท็บ
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ SDK ของ BIGO Ads ใน UI ของ AdMob
กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
คุณต้องเพิ่ม BIGO Ads SDK ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา
ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางอยู่แล้วที่ต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่ส่วนเพิ่ม BIGO Ads SDK เป็นแหล่งที่มาของโฆษณา
หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง
ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป
ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ตั้งที่จะกำหนดเป้าหมาย จากนั้นตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา
เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น
ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก
เพิ่ม BIGO Ads SDK เป็นแหล่งที่มาของโฆษณา
ในการ์ดการเสนอราคาในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่ม แหล่งที่มาของโฆษณา จากนั้นเลือก BIGO Ads SDK
คลิกวิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์และ ตั้งค่าการเป็นพาร์ทเนอร์การเสนอราคากับ BIGO Ads SDK
คลิกรับทราบและยอมรับ แล้วคลิกต่อไป
หากมีการแมปสำหรับ BIGO Ads SDK อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป
จากนั้นป้อน รหัสช่อง ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น
เพิ่ม BIGO TECHNOLOGY PTE LTD ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบระดับรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม BIGO TECHNOLOGY PTE LTD ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 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: ทดสอบการติดตั้งใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว
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