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

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

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

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

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

¹ การผสานรวมการเสนอราคาอยู่ในรุ่นเบต้าแบบเปิด

ข้อกำหนด

Google Mobile Ads SDK เวอร์ชันล่าสุด
Unity 4 ขึ้นไป
[สําหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สําหรับ InMobi 4.5.0 ขึ้นไป (แนะนําให้ใช้เวอร์ชันล่าสุด)
วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 21 ขึ้นไป
วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 10.0 ขึ้นไป
โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกําหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดได้ที่หัวข้อเริ่มต้นใช้งาน
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน

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

ลงชื่อสมัครใช้บัญชี InMobi เมื่อสร้างบัญชี ให้เลือกไม่ใช้ตัวเลือกใช้ SSP ของ InMobi กับการเสนอราคาแบบเปิดของ Google

เมื่อบัญชีได้รับการยืนยันแล้ว ให้เข้าสู่ระบบ

เพิ่มแอป

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

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

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

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

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

ตำแหน่ง

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

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

เมื่อสร้างตําแหน่งแล้ว รายละเอียดของตําแหน่งจะแสดงขึ้น จดบันทึกรหัสตําแหน่งโฆษณาที่จะใช้ตั้งค่าหน่วยโฆษณา Ad Manager

รหัสบัญชี

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

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

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

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

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

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

เปิดใช้โหมดทดสอบสําหรับตําแหน่งของคุณในการแสดงผลจริงทั้งหมดหรืออุปกรณ์ทดสอบบางเครื่องเท่านั้น

ขั้นตอนที่ 2: ตั้งค่าดีมานด์จาก InMobi ใน UI ของ Ad Manager

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

Android

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

iOS

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

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

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

ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ InMobi

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลาง InMobi ของ Google Mobile Ads สําหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรีรูทของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.inmobi

OpenUPM

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บรีจิสทรีที่มีขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่มีขอบเขตพร้อมรายละเอียดต่อไปนี้

ชื่อ: OpenUPM
URL: https://package.openupm.com
ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกที่เก็บของฉันจากเมนูแบบเลื่อนลง

รีจิสทรีของ Unity

เลือกแพ็กเกจ Google Mobile Ads InMobi Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google บนมือถือเวอร์ชันล่าสุดสําหรับ InMobi จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsInMobiMediation.unitypackage จากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นําเข้าแพ็กเกจ > แพ็กเกจที่กําหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsInMobiMediation.unitypackage ที่ดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > เครื่องมือจัดการทรัพยากรภายนอก > เครื่องมือแก้ไขของ Android > บังคับแก้ไข ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกจะทำการแก้ไข Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับแก้ไข

ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน InMobi SDK

ความยินยอมของผู้ใช้ EU และ GDPR

ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างแก่ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) และต้องได้รับความยินยอมจากผู้ใช้เกี่ยวกับการใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่อาจรวบรวม รับ หรือใช้ข้อมูลส่วนตัว และให้ข้อมูลเกี่ยวกับการใช้ของแต่ละเครือข่าย ปัจจุบัน Google ไม่สามารถส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สําหรับ InMobi เวอร์ชัน 2.1.0 เพิ่มเมธอด InMobi.UpdateGDPRConsent() ที่ช่วยให้คุณส่งข้อมูลความยินยอมไปยัง InMobi ได้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง InMobi SDK หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้คุณเรียกใช้ก่อนส่งคําขอโฆษณาด้วย Google Mobile Ads SDK

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 และเปิดใช้โหมดทดสอบใน UI ของ InMobi แล้ว

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก AdMob ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา InMobi (การเสนอราคา) และ 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 ดูรายละเอียดเพิ่มเติมที่ code
100	พารามิเตอร์เซิร์ฟเวอร์ InMobi ที่กําหนดค่าใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
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 ที่กําหนดค่าใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
102	อะแดปเตอร์ InMobi ไม่รองรับรูปแบบโฆษณาที่ขอ
103	โหลดโฆษณา InMobi สําหรับการกําหนดค่าเครือข่ายนี้แล้ว
อื่นๆ	InMobi SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่ `IMRequestStatus.h`