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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

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

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

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

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

    เพิ่มแอป

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

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

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

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

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

    ตำแหน่ง

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

    การเสนอราคา

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

    น้ำตก

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

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

    รหัสบัญชี

    รหัสบัญชี 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 สำหรับ Ad Manager

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

    หากติดตั้ง OpenUPM-CLI ไว้ คุณสามารถติดตั้งปลั๊กอินสื่อกลาง InMobi ของ Google Mobile Ads สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีรากของโปรเจ็กต์

    openupm add com.google.ads.mobile.mediation.inmobi

    OpenUPM

    ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

    ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้

    • ชื่อ: OpenUPM
    • URL: https://package.openupm.com
    • ขอบเขต: com.google

    รายละเอียด OpenUPM

    จากนั้นไปที่ Window > Package Manager เพื่อเปิด Unity Package Manager แล้วเลือกMy Registries จากเมนูแบบเลื่อนลง

    Unity Registry

    เลือกแพ็กเกจ Google Mobile Ads InMobi Mediation แล้วคลิกติดตั้ง

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ InMobi เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsInMobiMediation.unitypackage จากไฟล์ ZIP

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

    นำเข้าจาก Unity

    จากนั้นเลือก Assets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ไขทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

    บังคับให้แก้ไข

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

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

    ตั้งแต่ปลั๊กอินสื่อกลาง Unity ของ InMobi เวอร์ชัน 4.6.4 เป็นต้นไป InMobi จะอ่านความยินยอมตาม GDPR ที่กำหนดโดยแพลตฟอร์มการจัดการความยินยอมซึ่งรองรับข้อกำหนดความยินยอมเพิ่มเติมของ Google โดยอัตโนมัติ ซึ่งรวมถึง UMP SDK ด้วย ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ InMobi เกี่ยวกับการเริ่มต้น SDK สำหรับ Android และ iOS

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

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

    ดูเอกสารประกอบเกี่ยวกับ CCPA ของ InMobi เพื่อดูหลักเกณฑ์เกี่ยวกับวิธีเปิดใช้การตั้งค่า CCPA สำหรับ InMobi

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

    Android

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

    iOS

    การผสานรวม SKAdNetwork

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

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

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

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

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

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

    iOS

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

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

    เวอร์ชัน 5.4.0 (อยู่ระหว่างดำเนินการ)

    เวอร์ชัน 5.3.3

    เวอร์ชัน 5.3.2

    เวอร์ชัน 5.3.1

    เวอร์ชัน 5.3.0

    เวอร์ชัน 5.2.0

    เวอร์ชัน 5.1.0

    เวอร์ชัน 5.0.2

    เวอร์ชัน 5.0.1

    เวอร์ชัน 5.0.0

    เวอร์ชัน 4.7.7

    เวอร์ชัน 4.7.6

    เวอร์ชัน 4.7.5

    เวอร์ชัน 4.7.4

    เวอร์ชัน 4.7.3

    เวอร์ชัน 4.7.2

    เวอร์ชัน 4.7.1

    เวอร์ชัน 4.7.0

    เวอร์ชัน 4.6.7

    เวอร์ชัน 4.6.6

    เวอร์ชัน 4.6.5

    เวอร์ชัน 4.6.4

    เวอร์ชัน 4.6.3

    เวอร์ชัน 4.6.2

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

    • อัปเดตปลั๊กอินเพื่อรองรับ Rewarded API ใหม่
    • รองรับอะแดปเตอร์ Android เวอร์ชัน 7.2.7.0
    • รองรับ iOS Adapter เวอร์ชัน 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 Adapter เวอร์ชัน 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