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

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

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

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

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

ข้อกำหนด

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

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

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

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

เพิ่มแอป

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

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

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

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

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

ตำแหน่ง

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

การเสนอราคา

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

น้ำตก

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

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

รหัสบัญชี

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

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

การเสนอราคา

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

น้ำตก

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

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

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

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับ InMobi ให้เพิ่มข้อมูลโค้ดที่ปรับให้เหมาะกับคุณ

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_inmobi: ^

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก InMobi ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา 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 ดูรายละเอียดเพิ่มเติมได้ที่โค้ด
100 พารามิเตอร์เซิร์ฟเวอร์ InMobi ที่กำหนดค่าไว้ใน UI ของ AdMob ขาดหายไป/ไม่ถูกต้อง
101 เริ่มต้น SDK ของ InMobi ไม่สำเร็จ
102 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ InMobi รองรับ
103 คำขอโฆษณาไม่ใช่คำขอโฆษณาเนทีฟแบบรวม
104 พยายามขอโฆษณา InMobi โดยไม่ได้เริ่มต้น SDK ของ InMobi ในทางทฤษฎีแล้ว ไม่ควรเกิดกรณีนี้ขึ้นเนื่องจากอแดปเตอร์จะเริ่มต้น InMobi SDK ก่อนที่จะขอโฆษณา InMobi
105 โฆษณาของ InMobi ยังไม่พร้อมแสดง
106 InMobi แสดงโฆษณาไม่สำเร็จ
107 InMobi แสดงโฆษณาเนทีฟที่ไม่มีชิ้นงานที่จำเป็น
108 ชิ้นงานรูปภาพโฆษณาเนทีฟของ InMobi มี URL ที่มีรูปแบบไม่ถูกต้อง
109 อแดปเตอร์ดาวน์โหลดชิ้นงานรูปภาพโฆษณาเนทีฟของ InMobi ไม่สำเร็จ

iOS

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

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

เวอร์ชัน 1.1.1

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0