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

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

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

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

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

ข้อกำหนด

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

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

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

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

เพิ่มแอป

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

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

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

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

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

ตำแหน่ง

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

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

รหัสบัญชี

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

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

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

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

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

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

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

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

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

การผสานรวมผ่าน 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: เพิ่มโค้ดเพิ่มเติมที่จําเป็น

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

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

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

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

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

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

<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" />

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก InMobi ผู้เผยแพร่โฆษณาจะตรวจสอบข้อผิดพลาดพื้นฐานจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

GADMAdapterInMobi
GADMediationAdapterInMobi

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

บันทึกการเปลี่ยนแปลงของ 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