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

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

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

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

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

² รองรับเฉพาะการแสดงโฆษณาสื่อกลางตามลำดับขั้น (Waterfall Mediation)

ข้อกำหนด

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

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

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

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

เพิ่มแอป

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

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

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

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

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

ตำแหน่ง

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

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

การเสนอราคา

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

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

น้ำตก

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

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

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

รหัสบัญชี

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

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

การเสนอราคา

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

น้ำตก

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

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

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

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

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

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

ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณา InMobi ใน Ad Manager UI

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

Android

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

iOS

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

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

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

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

หมายเหตุ: การผสานรวม InMobi และ Google Mobile Ads SDK เวอร์ชันที่เข้ากันได้ไม่สำเร็จอาจทําให้เกิดปัญหาการสร้าง

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

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

dependencies:
  gma_mediation_inmobi: ^1.0.0

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

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

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

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

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

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สําหรับ InMobi ไม่รองรับการส่งข้อมูลความยินยอมไปยัง SDK ของ InMobi

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

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สําหรับ InMobi ไม่รองรับการส่งข้อมูลความยินยอมไปยัง SDK ของ InMobi

ขั้นตอนที่ 5: เพิ่มโค้ดเพิ่มเติมที่จําเป็น

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมในการผสานรวม InMobi

iOS

การผสานรวม SKAdNetwork

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ AdMob และ AdMob Media Group ก่อนเผยแพร่แอป

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

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก AdMob ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา InMobi (การเสนอราคา) และ InMobi (การแสดงโฆษณาสื่อกลางตามลำดับขั้น)

ขั้นตอนที่ไม่บังคับ

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 ที่กําหนดค่าใน 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 Flutter Mediation Adapter

เวอร์ชันถัดไป

• สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.2.0

1.1.0

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

1.0.0

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