คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก InMobi โดยใช้สื่อกลาง โดยครอบคลุมทั้งการผสานรวม Waterfall และการเสนอราคา โดยจะพูดถึงวิธีเพิ่ม InMobi ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม InMobi SDK และอะแดปเตอร์ลงในแอป Unity
การผสานรวมที่รองรับและรูปแบบโฆษณา
การผสานรวม | |
---|---|
การเสนอราคา | 1 |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
1 การผสานรวมการเสนอราคายังอยู่ในรุ่นเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 19 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 10.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK ดูรายละเอียดในเริ่มต้นใช้งาน
- ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน InMobi UI
ลงชื่อสมัครใช้บัญชี InMobi
การเสนอราคา
เลือกใช้ SSP ของ InMobi กับการเสนอราคาแบบเปิดของ Google แล้วป้อนรหัสผู้เผยแพร่โฆษณาของ Google
น้ำตก
ไม่ต้องดำเนินการเพิ่มเติมสำหรับการผสานรวม Waterfall
เข้าสู่ระบบบัญชี InMobi เมื่อยืนยันแล้ว
เพิ่มแอป
หากต้องการเพิ่มแอปไปยังแดชบอร์ดของ InMobi ให้คลิกพื้นที่โฆษณา > การตั้งค่า พื้นที่โฆษณา
คลิกเพิ่มพื้นที่โฆษณา แล้วเลือกแชแนลแอปบนอุปกรณ์เคลื่อนที่จากเมนูแบบเลื่อนลง
เริ่มพิมพ์ URL ของ App Store ที่เผยแพร่แล้วในแถบค้นหา แล้วเลือกแอปจากผลการค้นหาอัตโนมัติ คลิกต่อไป
หากแอปยังไม่ได้เผยแพร่ ให้คลิกลิงก์ด้วยตนเองแล้วป้อนรายละเอียดที่จำเป็น คลิกต่อไป
ตรวจสอบการตั้งค่าการปฏิบัติตามข้อกำหนดแอปและเว็บไซต์ แล้วคลิกบันทึกและสร้างตำแหน่ง
ตำแหน่ง
หลังจากตั้งค่าพื้นที่โฆษณาแล้ว ระบบจะเปลี่ยนเส้นทางคุณไปยังเวิร์กโฟลว์การสร้างตำแหน่ง
เลือกประเภทหน่วยโฆษณา จากนั้นป้อนชื่อตำแหน่ง เลือกปิดสำหรับการเสนอราคาระดับผู้ชม และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ คลิกสร้างตำแหน่งเมื่อทำเสร็จแล้ว
เมื่อสร้างตำแหน่งแล้ว รายละเอียดของตำแหน่งจะแสดงขึ้นมา จดรหัสตำแหน่งโฆษณาไว้ ซึ่งจะใช้ในการตั้งค่าAd Manager หน่วยโฆษณา
รหัสบัญชี
รหัสบัญชี InMobi ของคุณจะอยู่ในส่วนการเงิน > การตั้งค่าการชำระเงิน > ข้อมูลการชำระเงิน
ค้นหาคีย์ API การรายงาน InMobi
ไปที่บัญชีของฉัน > การตั้งค่าบัญชี ไปที่แท็บ API Key แล้วคลิก Generate API Key
เลือกอีเมลของผู้ใช้ที่จำเป็นสำหรับคีย์ แล้วคลิกสร้างคีย์ API ระบบจะสร้างไฟล์ที่มีคีย์ API และชื่อผู้ใช้/ชื่อการเข้าสู่ระบบ
มีเพียงผู้ดูแลระบบผู้เผยแพร่โฆษณาของบัญชีเท่านั้นที่จะสร้างคีย์ API สำหรับผู้ใช้ทุกคนได้ หากลืมคีย์ API ที่สร้างไว้ก่อนหน้านี้ ให้รีเซ็ตคีย์ API โดยวางเมาส์เหนืออีเมลในแท็บคีย์ API
เปิดโหมดทดสอบ
เปิดใช้โหมดทดสอบสำหรับตำแหน่งโฆษณาในการแสดงผลจริงทั้งหมดหรืออุปกรณ์ทดสอบบางประเภทเท่านั้น
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ InMobi ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม InMobi ลงในรายชื่อพาร์ทเนอร์โฆษณาเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาและ GDPR
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม InMobi ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน Ad Manager
ขั้นตอนที่ 3: นำเข้า SDK และอะแดปเตอร์ InMobi
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ 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 สำหรับ InMobi เวอร์ชัน 2.1.0 เพิ่มเมธอด InMobi.UpdateGDPRConsent()
ที่ช่วยให้คุณส่งข้อมูลความยินยอมไปยัง InMobi โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง SDK ของ InMobi หากคุณเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้คุณดำเนินการก่อนที่จะขอโฆษณาด้วย 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);
ดูข้อมูลเพิ่มเติมเกี่ยวกับคีย์และค่าที่เป็นไปได้ซึ่ง InMobi ยอมรับในออบเจ็กต์ความยินยอมนี้ในรายละเอียดการใช้งาน GDPR ของ InMobi
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กําหนดให้ผู้ใช้มีสิทธิในการเลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยให้เลือกไม่ใช้ผ่านลิงก์ "ห้ามขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นชัดเจนในหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสำหรับการแสดงโฆษณา Google ได้ แต่ Google ใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางไม่ได้ คุณจึงต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้แน่ใจว่าปฏิบัติตามข้อกำหนดได้
ดูเอกสารเกี่ยวกับ CCPA ของ InMobi เพื่อดูหลักเกณฑ์เกี่ยวกับวิธีเปิดใช้การตั้งค่า CCPA สําหรับ InMobi
ขั้นตอนที่ 5: ใส่รหัสเพิ่มเติมที่จำเป็น
Android
ไม่ต้องใช้โค้ดเพิ่มเติมเพื่อผสานรวม InMobi
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ InMobi เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager และเปิดใช้โหมดทดสอบใน 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 | ข้อผิดพลาด SDK ของ InMobi ดูรายละเอียดเพิ่มเติมได้ที่รหัส |
100 | พารามิเตอร์เซิร์ฟเวอร์ InMobi ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
101 | เริ่มต้น InMobi SDK ไม่สำเร็จ |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ InMobi รองรับ |
103 | คำขอโฆษณาไม่ใช่คำขอโฆษณาเนทีฟแบบรวม |
104 | พยายามขอโฆษณา InMobi โดยไม่เริ่มต้น InMobi SDK ในทางทฤษฎีไม่ควรเกิดขึ้นเนื่องจากอะแดปเตอร์เริ่มต้น SDK ของ InMobi ก่อนที่จะขอโฆษณา InMobi |
105 | โฆษณาของ InMobi ยังไม่พร้อมแสดง |
106 | InMobi แสดงโฆษณาไม่สำเร็จ |
107 | InMobi แสดงโฆษณาเนทีฟที่ไม่มีเนื้อหาที่จำเป็น |
108 | ชิ้นงานรูปภาพโฆษณาเนทีฟของ InMobi มี URL ที่ผิดรูปแบบ |
109 | อะแดปเตอร์ดาวน์โหลดชิ้นงานรูปภาพโฆษณาเนทีฟของ InMobi ไม่สำเร็จ |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ InMobi ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
102 | อะแดปเตอร์ InMobi ไม่รองรับรูปแบบโฆษณาที่ขอ |
103 | โฆษณา InMobi โหลดสำหรับการกำหนดค่าเครือข่ายนี้แล้ว |
อื่นๆ | InMobi SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่ IMRequestStatus.h |
บันทึกการเปลี่ยนแปลงปลั๊กอินสื่อกลาง Unity ของ InMobi
เวอร์ชัน 4.4.1
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.6.2.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.6.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 4.4.0
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.6.0.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.6.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 4.3.3
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.5.8.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.5.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.2
เวอร์ชัน 4.3.0
- ย้ายเนื้อหาของอะแดปเตอร์ไปที่
GoogleMobileAds/Mediation/InMobi/
แล้ว - เนมสเปซของอะแดปเตอร์ที่มีการเปลี่ยนโครงสร้างภายในเพื่อใช้
GoogleMobileAds.Mediation.InMobi
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.5.4.1
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.5.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 4.2.2
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.1.2.1
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.1.2.1
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 4.2.1
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.1.2.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.1.2.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 4.2.0
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.1.1.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.1.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 4.1.0
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.0.9.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.1.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 4.0.4
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.0.7.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.0.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 4.0.3
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.0.5.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.0.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 4.0.2
- รองรับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.0.3.0
- รองรับอะแดปเตอร์ InMobi iOS เวอร์ชัน 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