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

เลือกแพลตฟอร์ม: Android (เบต้า) Android iOS Unity Flutter

คู่มือนี้จะแสดงวิธีใช้ GMA Next-Gen SDK เพื่อโหลดและแสดงโฆษณา Display จาก Mintegral โดยใช้ สื่อกลาง AdMob ซึ่งครอบคลุมทั้งการผสานรวมแบบลำดับขั้นและการเสนอราคา โดยจะครอบคลุมวิธีเพิ่ม Mintegral ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Mintegral SDK และอะแดปเตอร์เข้ากับแอป Android

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

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

ข้อกำหนด

• Android API ระดับ 24 ขึ้นไป

• [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ Mintegral Adapter 16.5.91.1 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)

• GMA Next-Gen SDK เวอร์ชันล่าสุด

• ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

ไปที่แท็บการตั้งค่าแอป แล้วจดคีย์แอป ไว้

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

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

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

จดรหัสแอป ของแอปพลิเคชันไว้

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

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

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

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

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

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

อัปเดต app-ads.txt

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

หากต้องการใช้ app-ads.txt สำหรับ Mintegral โปรดดู How app-Ads.txt Can Help Fight Ad Fraud

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

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

คุณต้องเพิ่ม Mintegral ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่ต้องการแก้ไขอยู่แล้ว ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปที่ เพิ่ม Mintegral เป็นแหล่งที่มาของโฆษณา

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

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

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

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่ม Mintegral เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

ในการ์ดการเสนอราคา ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา จากนั้นเลือก Mintegral

คลิก วิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์ แล้ว ตั้งค่าการเป็นพาร์ทเนอร์การเสนอราคา กับ Mintegral



คลิกรับทราบและยอมรับ แล้วคลิกต่อไป



หากมีการแมปสำหรับ Mintegral อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป



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

การแสดงวิดีโอตามลำดับขั้น

ในการ์ดการแสดงวิดีโอตามลำดับขั้น ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

เลือก Mintegral จากนั้นป้อนค่า eCPM สำหรับ Mintegral แล้วคลิกต่อไป



หากมีการแมปสำหรับ Mintegral อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป

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

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

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

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

การผสานรวมกับ Android Studio (แนะนำ)

ในไฟล์ settings.gradle.kts ระดับโปรเจ็กต์ ให้เพิ่มที่เก็บต่อไปนี้

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

ในไฟล์ Gradle ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการติดตั้งใช้งานต่อไปนี้

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mintegral:17.0.91.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mintegral:17.0.91.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

1. หากต้องการรวม Mintegral SDK ให้ไปที่ Mintegral SDK สำหรับ Android

2. ไปที่ อาร์ติแฟกต์อะแดปเตอร์ Mintegral ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ Mintegral แล้วเพิ่มลงในโปรเจ็กต์

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

Mintegral SDK มีเมธอด setConsentStatus เพื่อส่งข้อมูลความยินยอมไปยัง Mintegral SDK

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Mintegral SDK คุณต้องตั้งค่าตัวเลือกเหล่านี้ก่อนที่จะ เริ่มต้น GMA Next-Gen SDK เพื่อให้แน่ใจว่าระบบจะส่งต่อตัวเลือกไปยัง Mintegral SDK อย่างถูกต้อง

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบด้านความเป็นส่วนตัวของ Mintegral

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

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

Mintegral SDK มีเมธอด setDoNotTrackStatus เพื่อส่งข้อมูลความยินยอมไปยัง Mintegral SDK

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Mintegral SDK หากต้องการเรียกใช้เมธอดนี้ ให้เรียกใช้ หลังจาก เริ่มต้น GMA Next-Gen SDK แต่ก่อนที่จะขอโฆษณาผ่าน GMA Next-Gen SDK

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบด้านความเป็นส่วนตัวของ Mintegral

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

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

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

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

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

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

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

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

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

เพิ่ม Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณา CCPA

ทำตามขั้นตอนในการตั้งค่า CCPA เพื่อเพิ่ม Mintegral ลงในรายชื่อพาร์ทเนอร์โฆษณา CCPA ใน UI ของ AdMob

โฆษณาเนทีฟ

การแสดงโฆษณา

อะแดปเตอร์ Mintegral จะแสดงโฆษณาเนทีฟเป็น NativeAd ออบเจ็กต์ และจะป้อนข้อมูลในช่องต่อไปนี้ สำหรับ สำหรับ NativeAd

¹ อะแดปเตอร์ Mintegral ไม่ได้ ให้สิทธิ์เข้าถึงชิ้นงานรูปภาพหลักสำหรับโฆษณาเนทีฟโดยตรง แต่จะป้อนข้อมูลวิดีโอหรือรูปภาพลงใน MediaView แทน

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

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

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

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