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

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

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

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

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

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

ข้อกำหนด

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

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

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

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

ลงชื่อสมัครใช้บัญชี Chartboost แล้ว เข้าสู่ระบบเมื่อบัญชีได้รับการยืนยัน จากนั้นไปที่แท็บการจัดการแอป

คลิกปุ่มเพิ่มแอปใหม่ เพื่อสร้างแอป

กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ แล้วคลิกปุ่มเพิ่มแอป เพื่อสร้างแอปให้เสร็จสมบูรณ์

หลังจากสร้างแอปแล้ว ระบบจะนำคุณไปยังแดชบอร์ดของแอป จดบันทึกรหัสแอป และลายเซ็นแอป ของแอป

หมายเหตุ: คุณสามารถไปที่แดชบอร์ดของแอปได้โดยไปที่แท็บ การจัดการแอป ที่แสดงก่อนหน้านี้ แล้วเลือกแอป

Ad Manager กำหนดให้ใช้ User ID และ User Signature ของ Chartboost เพื่อตั้งค่ารหัสหน่วยโฆษณา Ad Manager คุณดูพารามิเตอร์เหล่านี้ได้โดยคลิกสื่อกลาง Chartboost ใน UI ของ Chartboost

ไปที่แท็บแหล่งข้อมูล > API Explorer แล้วจดบันทึก User ID และ User Signature ที่อยู่ในส่วนการตรวจสอบสิทธิ์

อัปเดต app-ads.txt

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

หากต้องการใช้ app-ads.txt สำหรับ Chartboost โปรดดู app-ads.txt

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

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

คุณสามารถสลับโหมดทดสอบ ในแอปได้จากการตั้งค่าของแอป

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

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

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

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

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

ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่

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

จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน

หากมีพาร์ทเนอร์ผลตอบแทน สำหรับ Chartboost อยู่แล้ว คุณสามารถเลือกพาร์ทเนอร์รายนั้นได้ หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่

เลือก Chartboost เป็น เครือข่ายโฆษณา ป้อนชื่อ ที่ไม่ซ้ำกัน และเปิดใช้สื่อกลาง

เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อน รหัสผู้ใช้ และ User Signature ที่ได้รับในส่วนก่อนหน้า

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

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

หมายเหตุ: Ad Manager สามารถประมาณ CPM สำหรับตำแหน่งโฆษณาสูงสุด 3 ตำแหน่งในแอป Chartboost ส่วนตำแหน่งอื่นๆ ทั้งหมดจะแสดงด้วย CPM แบบผสม

ใน UI ของ Chartboost คุณจะดูตำแหน่งโฆษณาได้ในหน้าการตั้งค่าพื้นฐาน โดยคลิกการตั้งค่าขั้นสูง ดูรายละเอียดเพิ่มเติมได้ในคู่มือ ตำแหน่งที่มีชื่อ ของ Chartboost

เมื่อเสร็จแล้ว ให้คลิกบันทึก ที่ด้านล่างของหน้า

หมายเหตุ: การเก็บรวบรวมข้อมูลอัตโนมัติต้องใช้เวลารวบรวมข้อมูล 2-3 วันก่อนที่จะคำนวณค่า CPM แบบไดนามิกสำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ เมื่อคำนวณ eCPM ได้แล้ว ระบบจะอัปเดตข้อมูลให้คุณโดยอัตโนมัติ

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

สำคัญ: ตรวจสอบว่าคุณมีสิทธิ์การจัดการบัญชี เพื่อทำการกำหนดค่าความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR, กฎระเบียบของรัฐในสหรัฐอเมริกา และแพลตฟอร์มการแสดงข้อความแจ้งผู้ใช้ให้เสร็จสมบูรณ์ ดูรายละเอียดได้ที่หัวข้อ จัดการการเข้าถึงบัญชีของผู้ใช้

Chartboost

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

หมายเหตุ: การผสานรวม Chartboost และ GMA Next-Gen SDKเวอร์ชันที่ไม่เข้ากันอาจทำให้เกิดปัญหาในการสร้าง

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

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

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

Kotlin

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

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

Groovy

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

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

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

1. ดาวน์โหลดไฟล์ .aar ของ Chartboost SDK เวอร์ชันล่าสุดจาก Maven Central แล้วเพิ่มลงในโปรเจ็กต์

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

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

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

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

ใน SDK เวอร์ชัน 8.1.0 Chartboost ได้เพิ่มเมธอด addDataUseConsent() โค้ดตัวอย่างต่อไปนี้ตั้งค่าความยินยอมในการใช้ข้อมูลเป็น NON_BEHAVIORAL หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาผ่าน GMA Next-Gen SDK

Java

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในแต่ละเมธอดได้ที่บทความ GDPR ของ Chartboost และ เมธอดความเป็นส่วนตัวของ Android

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

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

ใน SDK เวอร์ชัน 8.1.0 Chartboost ได้เพิ่มเมธอด addDataUseConsent() โค้ดตัวอย่างต่อไปนี้ตั้งค่าความยินยอมในการใช้ข้อมูลเป็น OPT_IN_SALE หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาผ่าน GMA Next-Gen SDK

Java

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

Kotlin

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในแต่ละเมธอดได้ที่บทความ CCPA ของ Chartboost และ เมธอดความเป็นส่วนตัวของ Android

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

อัปเดตการเปลี่ยนแปลงการกำหนดค่ากิจกรรม

เพิ่มแอตทริบิวต์ต่อไปนี้ลงในแต่ละกิจกรรมในไฟล์ AndroidManifest.xml ที่แสดงโฆษณา Chartboost และรองรับการวางแนวที่แตกต่างกัน

android:configChanges="keyboardHidden|orientation|screenSize"

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

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

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

**สำคัญ:** ปิดใช้โหมดทดสอบสำหรับ Ad Manager และ Chartboost ก่อนเผยแพร่แอป

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

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

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

สิทธิ์

Chartboost แนะนำให้เพิ่มสิทธิ์ที่ไม่บังคับต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของแอปเพื่อให้ได้ประสิทธิภาพสูงสุด

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

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

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

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

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

รหัสข้อผิดพลาด	เหตุผล
0-99	Chartboost SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Chartboost documentation
101	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Chartboost รองรับ
102	Chartboost โหลดโฆษณาได้ครั้งละ 1 รายการต่อตำแหน่งเท่านั้น
103	พารามิเตอร์เซิร์ฟเวอร์ของ Chartboost ที่กำหนดค่าไว้ใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
104	โฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลของ Chartboost ยังไม่พร้อมที่จะแสดง