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

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

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

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

อะแดปเตอร์สื่อกลาง Ad Manager สำหรับ Mintegral มีความสามารถดังต่อไปนี้

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

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

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

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

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

    ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Mintegral

    ค้นหาคีย์แอป

    ไปที่แท็บ APP Setting แล้วจดบันทึก APP Key

    เพิ่มแอปพลิเคชันใหม่

    จากแท็บการตั้งค่าแอป ให้คลิกปุ่มเพิ่มแอป

    เลือกแพลตฟอร์ม แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม จากนั้นคลิกบันทึก

    Android

    iOS

    จดบันทึกรหัสแอปของแอปพลิเคชัน

    Android

    iOS

    สร้างตำแหน่งโฆษณา

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

    Android

    iOS

    ป้อนชื่อตำแหน่งโฆษณาและรูปแบบโฆษณา

    เลือกการเสนอราคาส่วนหัวเป็นประเภทการเสนอราคา กรอกข้อมูลที่เหลือในแบบฟอร์ม แล้วคลิกบันทึก

    เมื่อสร้างตำแหน่งโฆษณาแล้ว ให้จดบันทึกรหัสตำแหน่งโฆษณาไว้

    Android

    iOS

    คลิกเมนูแบบเลื่อนลงหน่วยโฆษณา 1 หน่วย แล้วจดบันทึกรหัสหน่วยโฆษณา

    Android

    iOS

    ค้นหาคีย์ Reporting API ของ Mintegral

    การเสนอราคา

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

    น้ำตก

    คุณจะต้องใช้คีย์ API การรายงานของ Mintegral เพื่อตั้งค่ารหัสหน่วยโฆษณา Ad Manager ไปที่บัญชี > เครื่องมือ API จดบันทึก Skey และ Secret

    อัปเดต app-ads.txt

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

    หากต้องการใช้ app-ads.txt สำหรับ Mintegral โปรดดูวิธีที่ app-ads.txt ช่วยต่อสู้กับการประพฤติมิชอบเกี่ยวกับโฆษณา

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

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

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

    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 Mintegral Mediation แล้วคลิกติดตั้ง

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

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

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

    นำเข้าจาก Unity

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

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

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

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

    อะแดปเตอร์ Mintegral Unity เวอร์ชัน 2.2.3 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง SDK ของ Mintegral ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับประกาศการปฏิบัติตามข้อกำหนดด้านความเป็นส่วนตัวของ SDK สำหรับ Android และ iOS ของ Mintegral

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

    Android

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

    iOS

    การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

    หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Mintegral คุณสามารถตรวจสอบข้อผิดพลาดที่สำคัญจากการตอบกลับของโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้

    Android

    com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

    iOS

    GADMediationAdapterMintegral

    ต่อไปนี้คือรหัสและข้อความที่แสดงโดยอะแดปเตอร์ Mintegral เมื่อโหลดโฆษณาไม่สำเร็จ

    Android

    รหัสข้อผิดพลาด โดเมน เหตุผล
    100 com.mbridge.msdk Mintegral SDK แสดงผล Callback ที่ไม่สําเร็จ
    101 com.google.ads.mediation.mintegral พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตำแหน่งโฆษณา)
    102 com.google.ads.mediation.mintegral ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Mintegral รองรับ
    103 com.google.ads.mediation.mintegral ไม่มีการเสนอราคาตอบหรือการเสนอราคาตอบไม่ถูกต้อง
    104 com.google.ads.mediation.mintegral SDK ของ Mintegral แสดงข้อผิดพลาดที่ระบุว่าไม่สามารถแสดงโฆษณาได้
    105 com.mbridge.msdk เริ่มต้น Mintegral SDK ไม่สำเร็จ
    106 com.google.ads.mediation.mintegral โหลดโฆษณาสำหรับช่อง Mintegral แล้ว แต่ยังไม่ได้แสดง

    iOS

    รหัสข้อผิดพลาด โดเมน เหตุผล
    101 com.google.mediation.mintegral พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสแอปหรือรหัสตำแหน่งโฆษณา)
    102 com.google.mediation.mintegral SDK ของ Mintegral แสดงข้อผิดพลาดที่ระบุว่าไม่สามารถแสดงโฆษณาได้
    103 com.google.mediation.mintegral Mintegral SDK แสดงโฆษณาไม่สำเร็จ
    104 com.google.mediation.mintegral ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Mintegral รองรับ

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

    เวอร์ชัน 2.2.6

    เวอร์ชัน 2.2.5

    เวอร์ชัน 2.2.4

    เวอร์ชัน 2.2.3

    เวอร์ชัน 2.2.2

    เวอร์ชัน 2.2.1

    เวอร์ชัน 2.2.0

    เวอร์ชัน 2.1.0

    เวอร์ชัน 2.0.6

    เวอร์ชัน 2.0.5

    เวอร์ชัน 2.0.4

    เวอร์ชัน 2.0.3

    เวอร์ชัน 2.0.2

    เวอร์ชัน 2.0.1

    เวอร์ชัน 2.0.0

    เวอร์ชัน 1.9.8

    เวอร์ชัน 1.9.7

    เวอร์ชัน 1.9.6

    เวอร์ชัน 1.9.5

    เวอร์ชัน 1.9.4

    เวอร์ชัน 1.9.3

    เวอร์ชัน 1.9.2

    เวอร์ชัน 1.9.1

    เวอร์ชัน 1.9.0

    เวอร์ชัน 1.8.4

    เวอร์ชัน 1.8.3

    เวอร์ชัน 1.8.2

    เวอร์ชัน 1.8.1

    เวอร์ชัน 1.8.0

    เวอร์ชัน 1.7.0

    เวอร์ชัน 1.6.5

    เวอร์ชัน 1.6.4

    เวอร์ชัน 1.6.3

    เวอร์ชัน 1.6.2

    เวอร์ชัน 1.6.1

    เวอร์ชัน 1.6.0

    เวอร์ชัน 1.5.0

    เวอร์ชัน 1.4.0

    เวอร์ชัน 1.3.0

    เวอร์ชัน 1.2.1

    เวอร์ชัน 1.2.0

    เวอร์ชัน 1.1.0

    เวอร์ชัน 1.0.0