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

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

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

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

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

² ใช้ได้กับสื่อกลาง Waterfall เท่านั้น

ข้อกำหนด

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

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

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

การเสนอราคา

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

น้ำตก

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

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

เพิ่มแอป

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

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

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

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

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

ตำแหน่ง

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

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

การเสนอราคา

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

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

น้ำตก

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

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

หมายเหตุ: รหัสตำแหน่งโฆษณา InMobi จะแสดงอยู่ใต้ชื่อตำแหน่งโฆษณา

รหัสบัญชี

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

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

การเสนอราคา

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

น้ำตก

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

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

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

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

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

หมายเหตุ: โหมดทดสอบจะปิดอยู่โดยค่าเริ่มต้นสำหรับทุกตำแหน่ง อย่างไรก็ตาม คุณเปิดใช้โหมดทดสอบสำหรับตำแหน่งในทุกอินสแตนซ์ของแอปหรือเฉพาะอุปกรณ์ที่คุณระบุก็ได้

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

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

Android

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

iOS

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

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

สำคัญ: ยืนยันว่าคุณมีสิทธิ์การจัดการบัญชีเพื่อกำหนดค่าสำหรับคำยินยอมในสหภาพยุโรปและ GDPR, CPRA และ User Messaging Platform ให้เสร็จสมบูรณ์ โปรดดูรายละเอียดที่จัดการสิทธิ์ของผู้ใช้ในการเข้าถึงบัญชีของคุณ

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

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

หมายเหตุ: การไม่ผสานรวมเวอร์ชัน InMobi และ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ที่ใช้ร่วมกันได้อาจก่อให้เกิดปัญหาในการสร้าง

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วยInMobi SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_inmobi: ^1.0.0

การผสานรวมด้วยตนเอง

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ InMobi ดึงข้อมูลไฟล์ที่ดาวน์โหลด และเพิ่มโฟลเดอร์ปลั๊กอินที่ดึงมา (และเนื้อหาในไฟล์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_inmobi:
    path: path/to/local/package

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

ความยินยอมของสหภาพยุโรปและ GDPR

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ InMobi ไม่สนับสนุนการส่งข้อมูลความยินยอมไปยัง InMobi SDK

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

กฎหมายว่าด้วยความเป็นส่วนตัวระดับรัฐของสหรัฐอเมริกา กําหนดให้ผู้ใช้มีสิทธิในการเลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยให้เลือกไม่ใช้ผ่านลิงก์ "ห้ามขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นชัดเจนในหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสำหรับการแสดงโฆษณา Google ได้ แต่ Google ใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางไม่ได้ คุณจึงต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้แน่ใจว่าปฏิบัติตามข้อกำหนดได้

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ InMobi ไม่สนับสนุนการส่งข้อมูลความยินยอมไปยัง InMobi SDK

ขั้นตอนที่ 5: ใส่รหัสเพิ่มเติมที่จำเป็น

Android

ไม่ต้องใช้โค้ดเพิ่มเติมเพื่อผสานรวม InMobi

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ InMobi เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 6: ทดสอบการใช้งาน

เปิดใช้โฆษณาทดสอบ

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน InMobi UI

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ InMobi ก่อนเปิดตัวแอป

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

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

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Flutter ของ InMobi

1.0.0

• การเผยแพร่ครั้งแรก
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ InMobi Android เวอร์ชัน 10.6.7.1
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ InMobi iOS เวอร์ชัน 10.7.2.0
• สร้างและทดสอบด้วยปลั๊กอิน Google Mobile Ads Flutter เวอร์ชัน 5.1.0