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

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

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

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

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

ข้อกำหนด

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

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

• ล่าสุดจาก GMA Next-Gen SDK

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

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

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

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

เพิ่มแอป

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

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

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

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

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

ตำแหน่ง

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

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

รหัสบัญชี

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

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

อัปเดต 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

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม InMobi ในส่วนบริษัท

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

กำหนดค่าการเสนอราคาของ InMobi

กำหนดค่าการแมปหน่วยโฆษณา

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

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

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

การผสานรวม Android Studio (แนะนํา)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:inmobi:11.1.1.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.24.0-beta02'
    implementation 'com.google.ads.mediation:inmobi:11.1.1.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. ดาวน์โหลด InMobi Android SDK แล้วแตกไฟล์ InMobiSDK.aar ในโฟลเดอร์ libs แล้วเพิ่มลงในโปรเจ็กต์

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

3. นอกจากนี้ InMobi ยังกำหนดให้รวมการขึ้นต่อกันอื่นๆ ด้วย โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบของ InMobi

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

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

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

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

import com.inmobi.sdk.InMobiSdk
import com.google.ads.mediation.inmobi.InMobiConsent
// ...

val consentObject = JSONObject()
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true)
  consentObject.put("gdpr", "1")
} catch (exception: JSONException) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception)
}

InMobiConsent.updateGDPRConsent(consentObject)

import com.inmobi.sdk.InMobiSdk;
import com.google.ads.mediation.inmobi.InMobiConsent;
// ...

JSONObject consentObject = new JSONObject();
try {
  consentObject.put(InMobiSdk.IM_GDPR_CONSENT_AVAILABLE, true);
  consentObject.put("gdpr", "1");
} catch (JSONException exception) {
  Log.e(TAG, "Error creating GDPR consent JSON.", exception);
}

InMobiConsent.updateGDPRConsent(consentObject);

ดูข้อมูลเพิ่มเติมเกี่ยวกับคีย์และค่าที่เป็นไปได้ซึ่ง InMobi ยอมรับใน ออบเจ็กต์ความยินยอมนี้ได้ที่ รายละเอียดการใช้งาน GDPR ของ InMobi

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

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

ในเวอร์ชัน 10.5.7.1 อแดปเตอร์ InMobi ได้เพิ่มการรองรับการอ่านสตริงความเป็นส่วนตัวของสหรัฐอเมริกาของ IAB จาก ค่ากำหนดที่แชร์ ทําตามวิธีการใน เอกสารประกอบเกี่ยวกับกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา เพื่อตั้งค่าสตริงความเป็นส่วนตัวของสหรัฐอเมริกาใน ค่ากําหนดที่แชร์

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

ขั้นตอนที่ 5: ต้องใช้โค้ดเพิ่มเติม

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

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

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

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

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

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

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

สิทธิ์

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

พารามิเตอร์เฉพาะเครือข่าย

อแดปเตอร์ InMobi รองรับพารามิเตอร์คำขอเพิ่มเติมที่ส่งไปยังอแดปเตอร์เป็น Android Bundle ได้ อแดปเตอร์จะมองหาคีย์ต่อไปนี้ใน แพ็กเกจ

ต่อไปนี้เป็นตัวอย่างโค้ดวิธีตั้งค่าพารามิเตอร์คำขอโฆษณาเหล่านี้

val extras = Bundle()
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44)
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE)
val request = AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter::class.java, extras)
   .build()

Bundle extras = new Bundle();
extras.putString(InMobiNetworkKeys.AGE_GROUP, InMobiNetworkValues.BETWEEN_35_AND_44);
extras.putString(InMobiNetworkKeys.AREA_CODE, AREA_CODE_VALUE);
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
   .putAdSourceExtrasBundle(InMobiAdapter.class, extras)
   .build();

• แทนที่ AD_UNIT_ID ด้วยรหัสหน่วยโฆษณา

• แทนที่ AREA_CODE_VALUE ด้วยรหัสพื้นที่

การใช้โฆษณาเนทีฟ

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

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

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

การติดตามการแสดงผลและการคลิก

GMA Next-Gen SDK ใช้การเรียกกลับของ InMobi SDK สำหรับการติดตามการแสดงผลและ การคลิก ดังนั้นรายงานในแดชบอร์ดทั้ง 2 รายการควรตรงกันโดยมีความคลาดเคลื่อนน้อยมากหรือไม่มีเลย

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

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

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

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