หน้านี้ได้รับการแปลโดย Cloud Translation API

ผสานรวม InMobi กับสื่อกลาง

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

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

การผสานรวม
การเสนอราคา	¹
น้ำตก
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
เนทีฟ	²

¹ การผสานรวมการเสนอราคาปิดอยู่ เบต้า ให้ติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

ข้อกำหนด

SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
Unity 4 ขึ้นไป
เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
เพื่อทำให้ใช้งานได้บน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 10.0 ขึ้นไป
โปรเจ็กต์ที่ Unity กำลังทำงานซึ่งกำหนดค่าด้วย Google SDK โฆษณาในอุปกรณ์เคลื่อนที่ โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน

ขั้นตอนที่ 1: กำหนดค่าใน UI ของ InMobi

ลงชื่อสมัครใช้บัญชี InMobi

การเสนอราคา

เลือกใช้ SSP ของ InMobi กับการเสนอราคาแบบเปิดของ Google แล้วป้อนรหัสผู้เผยแพร่โฆษณาของ Google

น้ำตก

ไม่ต้องดำเนินการเพิ่มเติมสำหรับการผสานรวม Waterfall

เข้าสู่ระบบบัญชี InMobi เมื่อยืนยันแล้ว

เพิ่มแอป

หากต้องการเพิ่มแอปไปยังแดชบอร์ดของ InMobi ให้คลิกพื้นที่โฆษณา > การตั้งค่า พื้นที่โฆษณา

คลิกเพิ่มพื้นที่โฆษณา แล้วเลือกแชแนลแอปบนอุปกรณ์เคลื่อนที่จากเมนูแบบเลื่อนลง

เริ่มพิมพ์ URL ของ App Store ที่เผยแพร่แล้วในแถบค้นหา แล้วเลือกแอปจากผลการค้นหาอัตโนมัติ คลิกต่อไป

หากแอปยังไม่ได้เผยแพร่ ให้คลิกลิงก์ด้วยตนเองแล้วป้อนรายละเอียดที่จำเป็น คลิกต่อไป

ตรวจสอบการตั้งค่าการปฏิบัติตามข้อกำหนดแอปและเว็บไซต์ แล้วคลิกบันทึกและสร้างตำแหน่ง

ตำแหน่ง

หลังจากตั้งค่าพื้นที่โฆษณาแล้ว ระบบจะเปลี่ยนเส้นทางคุณไปยังเวิร์กโฟลว์การสร้างตำแหน่ง

การเสนอราคา

เลือกประเภทหน่วยโฆษณา ป้อนชื่อตำแหน่ง จากนั้นเลือกเปิดและการเสนอราคาแบบเปิดของ Google สำหรับการเสนอราคาตามกลุ่มเป้าหมายและพาร์ทเนอร์ตามลำดับ และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ เมื่อทำเสร็จแล้ว ให้คลิกสร้างตำแหน่ง

น้ำตก

เลือกประเภทหน่วยโฆษณา จากนั้นป้อนชื่อตำแหน่ง เลือกปิดสำหรับการเสนอราคาระดับผู้ชม และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ คลิกสร้างตำแหน่งเมื่อทำเสร็จแล้ว

เมื่อสร้างตำแหน่งแล้ว รายละเอียดของตำแหน่งจะแสดงขึ้นมา จดรหัสตำแหน่งโฆษณาไว้ ซึ่งจะใช้ในการตั้งค่าAdMob หน่วยโฆษณา

รหัสบัญชี

รหัสบัญชี InMobi ของคุณจะอยู่ในส่วนการเงิน > การตั้งค่าการชำระเงิน > ข้อมูลการชำระเงิน

ค้นหาคีย์ API การรายงาน InMobi

การเสนอราคา

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

ไปที่บัญชีของฉัน > การตั้งค่าบัญชี ไปที่แท็บคีย์ API แล้วคลิกสร้างคีย์ API

เลือกอีเมลของผู้ใช้ที่จำเป็นสำหรับคีย์ แล้วคลิกสร้างคีย์ API ระบบจะสร้างไฟล์ที่มีคีย์ API และชื่อผู้ใช้/ชื่อการเข้าสู่ระบบ

มีเพียงผู้ดูแลระบบผู้เผยแพร่โฆษณาของบัญชีเท่านั้นที่จะสร้างคีย์ API สำหรับผู้ใช้ทุกคนได้ หากลืมคีย์ API ที่สร้างไว้ก่อนหน้านี้ ให้รีเซ็ตคีย์ API โดยวางเมาส์เหนืออีเมลในแท็บคีย์ API

เปิดโหมดทดสอบ

เปิดใช้โหมดทดสอบสำหรับตำแหน่งโฆษณาในการแสดงผลจริงทั้งหมดหรืออุปกรณ์ทดสอบบางประเภทเท่านั้น

ขั้นตอนที่ 2: ตั้งค่าความต้องการ InMobi ใน AdMob UI

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android

iOS

โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

เพิ่ม InMobi ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม InMobi ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน AdMob

ขั้นตอนที่ 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.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