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

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

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

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

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

ข้อกำหนด

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

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

ลงชื่อสมัครใช้บัญชี 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: นำเข้า InMobi SDK และอะแดปเตอร์

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

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

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

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

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ 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 จะใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางไม่ได้ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่สามารถเข้าร่วมการขายข้อมูลส่วนบุคคลและทำตามคำแนะนำจากแต่ละเครือข่ายดังกล่าวเพื่อให้แน่ใจว่ามีการปฏิบัติตามข้อกำหนด

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

บันทึกการเปลี่ยนแปลงปลั๊กอินของสื่อกลาง InMobi Unity

เวอร์ชัน 4.6.1

เวอร์ชัน 4.6.0

เวอร์ชัน 4.5.1

เวอร์ชัน 4.5.0

เวอร์ชัน 4.4.1

เวอร์ชัน 4.4.0

เวอร์ชัน 4.3.3

เวอร์ชัน 4.3.0

เวอร์ชัน 4.2.2

เวอร์ชัน 4.2.1

เวอร์ชัน 4.2.0

เวอร์ชัน 4.1.0

เวอร์ชัน 4.0.4

เวอร์ชัน 4.0.3

เวอร์ชัน 4.0.2

เวอร์ชัน 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