คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก InMobi โดยใช้สื่อกลาง ซึ่งครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา ซึ่งครอบคลุมถึงวิธีเพิ่ม InMobi ไปยัง การกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม InMobi SDK และ อะแดปเตอร์ลงใน Unity แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
การผสานรวม | |
---|---|
การเสนอราคา | 1 |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
1 การผสานรวมการเสนอราคาปิดอยู่ เบต้า ให้ติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Unity 4 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 10.0 ขึ้นไป
- โปรเจ็กต์ที่ Unity กำลังทำงานซึ่งกำหนดค่าด้วย Google SDK โฆษณาในอุปกรณ์เคลื่อนที่ โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ InMobi
ขั้นตอนที่ 2: ตั้งค่าความต้องการ InMobi ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม InMobi ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ขั้นตอนที่ 3: นำเข้า InMobi SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสำหรับ InMobi
จากลิงก์ดาวน์โหลดใน
Changelog และดึงข้อมูล
GoogleMobileAdsInMobiMediation.unitypackage
จากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > กำหนดเอง
แพ็กเกจ แล้วเลือกไฟล์ GoogleMobileAdsInMobiMediation.unitypackage
ที่คุณ
ดาวน์โหลดแล้ว ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play > รีโซลเวอร์ Android > แรง
แก้ปัญหา ไลบรารีตัวแปลค่าบริการ Unity Play จะดำเนินการ Dependency
แก้ไขตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยัง
ไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวบน InMobi SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้ความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่าง และ ความยินยอมที่ได้รับจาก ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับ การใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นไปตาม ข้อกำหนดด้าน ePrivacy และการคุ้มครองข้อมูลทั่วไปของสหภาพยุโรป กฎระเบียบ (GDPR) เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัว และ ให้ข้อมูลเกี่ยวกับการใช้งานของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถ ส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ปลั๊กอินสื่อกลางโฆษณา Google Mobile สำหรับ InMobi เวอร์ชัน 2.1.0 ได้เพิ่ม
เมธอด InMobi.UpdateGDPRConsent()
ที่ช่วยให้คุณส่งต่อข้อมูลความยินยอมไปยัง
InMobi โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง
InMobi SDK หากคุณเลือกที่จะเรียกใช้วิธีนี้ เราขอแนะนำให้คุณทำก่อน
ในการขอโฆษณาด้วย SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google
using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...
Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");
InMobi.UpdateGDPRConsent(consentObject);
ดูการนำ GDPR ของ InMobi ไปใช้ รายละเอียด สำหรับข้อมูลเพิ่มเติมเกี่ยวกับคีย์และค่าที่เป็นไปได้ที่ InMobi ยอมรับ ออบเจ็กต์คำยินยอมนี้
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
สหรัฐอเมริกา กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐ ต้องให้ผู้ใช้ได้รับ เพื่อเลือกไม่ใช้ "การลดราคา" ของ "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ข้อกำหนดดังกล่าว) โดยการเลือกไม่ใช้ที่นำเสนอผ่านโฆษณาว่า "อย่าขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัด ข้อมูล" ลิงก์ใน "การขาย" หน้าแรกของพรรคการเมือง สหรัฐอเมริกา สถานะความเป็นส่วนตัว คู่มือการปฏิบัติตามกฎหมายช่วยให้คุณ การประมวลผลข้อมูลแบบจำกัด สําหรับการแสดงโฆษณาของ Google แต่ Google ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด
ดู InMobi เอกสารประกอบเกี่ยวกับ CCPA เพื่อดูหลักเกณฑ์เกี่ยวกับวิธีเปิดใช้การตั้งค่า CCPA สำหรับ InMobi
ขั้นตอนที่ 5: ใส่รหัสเพิ่มเติมที่จำเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมใดๆ เพื่อผสานรวม InMobi
iOS
การผสานรวม SKAdNetwork
ติดตาม InMobi
เอกสารประกอบ
เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน InMobi UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก InMobi ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ InMobi (Bidding) and InMobi (Waterfall) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
Android
สิทธิ์
เพื่อประสิทธิภาพที่ดีที่สุด InMobi แนะนำให้เพิ่มตัวเลือกต่อไปนี้
สิทธิ์ในไฟล์ AndroidManifest.xml
ของแอป
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
คุณสามารถเลือกเพิ่มสิทธิ์เหล่านี้ลงใน
Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
ไฟล์
iOS
ไม่จําเป็นต้องดําเนินการใดๆ เพิ่มเติมสําหรับการผสานรวม iOS
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก InMobi ผู้เผยแพร่โฆษณาสามารถตรวจสอบ
ข้อผิดพลาดสำคัญจากการตอบกลับโฆษณาโดยใช้
ResponseInfo
ภายใต้
ชั้นเรียนต่อไปนี้
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
ต่อไปนี้เป็นรหัสและข้อความประกอบที่อะแดปเตอร์ InMobi ส่งไปเมื่อ โฆษณาไม่โหลด:
Android
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-99 | ข้อผิดพลาดของ InMobi SDK ดูรหัส เพื่อดูรายละเอียดเพิ่มเติม |
100 | พารามิเตอร์เซิร์ฟเวอร์ InMobi ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
101 | เริ่มต้น InMobi SDK ไม่สำเร็จ |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ InMobi รองรับ |
103 | คำขอโฆษณาไม่ใช่คำขอโฆษณาเนทีฟแบบรวม |
104 | พยายามขอโฆษณา InMobi โดยไม่เริ่มต้น InMobi SDK ช่วงเวลานี้ ในทางทฤษฎีไม่ควรเกิดขึ้นเนื่องจากอะแดปเตอร์เริ่มต้น InMobi SDK ก่อนที่จะขอโฆษณา InMobi |
105 | โฆษณาของ InMobi ยังไม่พร้อมแสดง |
106 | InMobi แสดงโฆษณาไม่สำเร็จ |
107 | InMobi แสดงผลโฆษณาเนทีฟที่ขาดเนื้อหาที่จำเป็น |
108 | ชิ้นงานรูปภาพโฆษณาเนทีฟของ InMobi มี URL ที่ผิดรูปแบบ |
109 | อะแดปเตอร์ดาวน์โหลดชิ้นงานรูปภาพโฆษณาเนทีฟของ InMobi ไม่สำเร็จ |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ InMobi ที่กำหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
102 | อะแดปเตอร์ InMobi ไม่สนับสนุนรูปแบบโฆษณาที่ขอ |
103 | โหลดโฆษณา InMobi สำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
อื่นๆ | InMobi SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่ IMRequestStatus.h |
บันทึกการเปลี่ยนแปลงปลั๊กอินของสื่อกลาง InMobi Unity
เวอร์ชัน 4.6.3
- เปลี่ยนชื่อ
DummyClient
เป็นPlaceholderClient
แล้ว - รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.7.5.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.7.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.2.0
เวอร์ชัน 4.6.2
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.7.4.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.7.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.1
เวอร์ชัน 4.6.1
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.7.4.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.7.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 4.6.0
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.7.3.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.7.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 4.5.1
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.6.7.1
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.7.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 4.5.0
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.6.7.1
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.7.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 4.4.1
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.6.2.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.6.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 4.4.0
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.6.0.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.6.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 4.3.3
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.5.8.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.5.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.2
เวอร์ชัน 4.3.0
- ย้ายเนื้อหาของอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/InMobi/
แล้ว - เนมสเปซของอะแดปเตอร์ที่ปรับเปลี่ยนรูปแบบเพื่อใช้
GoogleMobileAds.Mediation.InMobi
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.5.4.1
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.5.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 4.2.2
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.1.2.1
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.1.2.1
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 4.2.1
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.1.2.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.1.2.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 4.2.0
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.1.1.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.1.1.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 4.1.0
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.0.9.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.1.0.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 4.0.4
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.0.7.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.0.7.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 4.0.3
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.0.5.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.0.5.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 4.0.2
- รองรับอะแดปเตอร์ Android InMobi เวอร์ชัน 10.0.3.0
- รองรับอะแดปเตอร์ iOS ของ InMobi เวอร์ชัน 10.0.2.1
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 4.0.1
เวอร์ชัน 4.0.0
เวอร์ชัน 3.2.0
เวอร์ชัน 3.1.2
เวอร์ชัน 3.1.1
เวอร์ชัน 3.1.0
เวอร์ชัน 3.0.3
เวอร์ชัน 3.0.2
เวอร์ชัน 3.0.1
เวอร์ชัน 3.0.0
เวอร์ชัน 2.4.0
เวอร์ชัน 2.3.0
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.2.9.0
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.3.2.0
เวอร์ชัน 2.2.2
- อัปเดตปลั๊กอินให้รองรับ มีการให้รางวัล API ใหม่
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.2.7.0
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.2.7.0
เวอร์ชัน 2.2.1
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.2.2.0
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.2.4.0
เวอร์ชัน 2.2.0
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.2.1.0
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.2.0.0
เวอร์ชัน 2.1.2
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.1.1.1
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.1.2.0
เวอร์ชัน 2.1.1
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.1.1.1
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.1.1.2
เวอร์ชัน 2.1.0
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.1.0.0
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.1.1.1
- เพิ่มเมธอด
InMobi.UpdateGDPRConsent()
แล้ว
เวอร์ชัน 2.0.0
- รองรับอะแดปเตอร์ Android เวอร์ชัน 7.0.4.0
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 7.1.1.0
เวอร์ชัน 1.0.0
- เปิดตัวครั้งแรก
- รองรับอะแดปเตอร์ Android เวอร์ชัน 6.2.4.0
- รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.2.1.0