คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Chartboost โดยใช้สื่อกลางที่ครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม Chartboost ลงในการกําหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Chartboost SDK และอะแดปเตอร์เข้ากับแอป Unity
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสำหรับ Chartboost มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- API ของ Android ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งมีการกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดได้ที่ เริ่มต้นใช้งาน
- ทําตามคู่มือเริ่มต้นใช้งานสื่อกลาง
ขั้นตอนที่ 1: กำหนดค่าใน Chartboost UI
ลงชื่อสมัครใช้บัญชี Chartboost และเข้าสู่ระบบเมื่อบัญชีได้รับการยืนยันแล้ว จากนั้นไปที่แท็บการจัดการแอป
คลิกปุ่มเพิ่มแอปใหม่เพื่อสร้างแอป
กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ แล้วคลิกปุ่มเพิ่มแอปเพื่อดำเนินการแอปให้เสร็จ
หลังจากสร้างแอปแล้ว ระบบจะนําคุณไปยังแดชบอร์ดของแอป จดรหัสแอปและลายเซ็นแอปของแอป
Android
iOS
AdMob ต้องใช้รหัสผู้ใช้และลายเซ็นผู้ใช้ของ Chartboost เพื่อตั้งค่า AdMob รหัสหน่วยโฆษณา คุณค้นหาพารามิเตอร์เหล่านี้ได้โดยคลิกสื่อกลาง Chartboost ใน UI ของ Chartboost
ไปที่แท็บทรัพยากร > โปรแกรมสำรวจ API แล้วจดบันทึกรหัสผู้ใช้และลายเซ็นผู้ใช้ในส่วนการตรวจสอบสิทธิ์
เปิดโหมดทดสอบ
คุณเปิดใช้โหมดทดสอบในแอปได้โดยไปที่แท็บการจัดการแอปจาก UI ของ Chartboost เลือกแอปจากรายการแล้วคลิก แก้ไขการตั้งค่าแอป
Android
iOS
จากการตั้งค่าของแอป คุณสามารถเปิด/ปิดโหมดทดสอบในแอป
เมื่อเปิดใช้โหมดทดสอบแล้ว คุณจะขอโฆษณาโดยใช้รหัสหน่วยโฆษณาที่สร้างไว้ก่อนหน้านี้และรับโฆษณาทดสอบ Chartboost ได้
หลังจากที่คุณรับโฆษณาทดสอบของ Chartboost ได้แล้ว ระบบจะวางแอปของคุณในPublisher App Review ของ Chartboost เพื่อให้การสร้างรายได้บน Chartboost ทำงานได้ การตรวจสอบแอปของผู้เผยแพร่โฆษณาจะต้องได้รับการอนุมัติจาก Chartboost
ขั้นตอนที่ 2: ตั้งค่าความต้องการ Chartboost ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Chartboost ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Chartboost ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน AdMob
ขั้นตอนที่ 3: นำเข้า Chartboost SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Chartboost เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน Changelog แล้วดึงข้อมูล GoogleMobileAdsChartboostMediation.unitypackage
จากไฟล์ ZIP
ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ >
แพ็กเกจที่กำหนดเอง แล้วหาไฟล์ GoogleMobileAdsChartboostMediation.unitypackage
ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android >
บังคับแก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะแก้ปัญหาการขึ้นต่อกันใหม่ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน Chartboost SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่างและได้รับความยินยอมจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับการใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัวและให้ข้อมูลเกี่ยวกับการใช้ของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Chartboost เวอร์ชัน 3.1.0 มีเมธอด Chartboost.AddDataUseConsent()
โค้ดตัวอย่างต่อไปนี้จะกำหนดความยินยอมในการใช้ข้อมูลให้ NonBehavioral
หากคุณเลือกที่จะเรียกใช้วิธีนี้ ขอแนะนำให้คุณดำเนินการก่อนที่จะขอโฆษณาโดยใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ์เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยมีการเลือกไม่รับผ่านลิงก์ "ห้ามขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัดเจนในหน้าแรกของฝ่าย "ขาย" คู่มือการปฏิบัติตามกฎหมายว่าด้วยความเป็นส่วนตัวระดับรัฐของสหรัฐอเมริกาให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสำหรับการแสดงโฆษณา Google ได้ แต่ Google จะใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางไม่ได้ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลางที่สามารถเข้าร่วมการขายข้อมูลส่วนบุคคลและทำตามคำแนะนำจากแต่ละเครือข่ายดังกล่าวเพื่อให้แน่ใจว่ามีการปฏิบัติตามข้อกำหนด
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ Chartboost เวอร์ชัน 3.1.0 มีเมธอด Chartboost.AddDataUseConsent()
โค้ดตัวอย่างต่อไปนี้จะกำหนดความยินยอมในการใช้ข้อมูลให้ OptInSale
หากคุณเลือกที่จะเรียกใช้วิธีนี้ ขอแนะนำให้คุณดำเนินการก่อนที่จะขอโฆษณาโดยใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
ขั้นตอนที่ 5: เพิ่มโค้ดที่จําเป็น
Android
ไม่ต้องมีโค้ดเพิ่มเติมสำหรับการผสานรวม Chartboost
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ Chartboost เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน Chartboost UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Chartboost ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Chartboost (Waterfall) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
Android
สิทธิ์
เพื่อประสิทธิภาพที่ดีที่สุด Chartboost แนะนำให้เพิ่มสิทธิ์ที่ไม่บังคับต่อไปนี้ลงในไฟล์ AndroidManifest.xml
ของแอป
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
ไม่จําเป็นต้องดําเนินการใดๆ เพิ่มเติมสําหรับการผสานรวม iOS
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Chartboost ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดเบื้องหลังจากการตอบกลับโฆษณาได้โดยใช้ ResponseInfo
ภายใต้คลาสต่อไปนี้
Android
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
ต่อไปนี้เป็นโค้ดและข้อความประกอบที่อะแดปเตอร์ Chartboost ใส่เมื่อโฆษณาโหลดไม่สำเร็จ
Android
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-99 | Chartboost SDK แสดงข้อผิดพลาด |
101 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Chartboost รองรับ |
102 | Chartboost โหลดโฆษณาได้เพียงครั้งละ 1 รายการต่อสถานที่ |
103 | พารามิเตอร์เซิร์ฟเวอร์ Chartboost ที่กำหนดค่าไว้ใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
104 | โฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลของ Chartboost ไม่พร้อมแสดง |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ Chartboost ที่กำหนดค่าไว้ใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
102 | Chartboost SDK แสดงผลข้อผิดพลาดในการเริ่มต้น |
103 | โฆษณา Chartboost ไม่ได้แคช ณ เวลาที่แสดง |
104 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Chartboost รองรับ |
105 | เวอร์ชันระบบปฏิบัติการของอุปกรณ์ต่ำกว่าเวอร์ชันระบบปฏิบัติการขั้นต่ำที่รองรับของ Chartboost SDK |
200-299 | ข้อผิดพลาดของแคช Chartboost SDK ดูรายละเอียดเพิ่มเติมในรหัส |
300-399 | Chartboost SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในรหัส |
400-499 | ข้อผิดพลาดในการคลิก Chartboost SDK ดูรายละเอียดเพิ่มเติมในรหัส |
บันทึกการเปลี่ยนแปลงปลั๊กอินของสื่อกลาง Chartboost Unity
เวอร์ชัน 4.6.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.7.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.7.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 4.5.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.6.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.6.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 4.4.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.5.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.5.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.3
เวอร์ชัน 4.3.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.4.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.4.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.0
เวอร์ชัน 4.2.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.3.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.3.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.2.0
เวอร์ชัน 4.1.1
- ย้ายเนื้อหาของอะแดปเตอร์ไปยัง
GoogleMobileAds/Mediation/Chartboost/
แล้ว - เนมสเปซของอะแดปเตอร์ที่ปรับเปลี่ยนรูปแบบเพื่อใช้
GoogleMobileAds.Mediation.Chartboost
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.2.1.1
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.2.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 4.1.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.2.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.2.0.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.1
เวอร์ชัน 4.0.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 9.1.1.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 9.1.0.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 3.5.1
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.4.3.1
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.5.0.2
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 3.5.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.4.2.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.5.0.2
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 3.4.1
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.3.1.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.5.0.2
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 3.4.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.3.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.5.0.1.0
เวอร์ชัน 3.3.1
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.2.1.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.4.1.1
เวอร์ชัน 3.3.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.2.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.4.0.0
เวอร์ชัน 3.2.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.1.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.3.1.0
เวอร์ชัน 3.1.0
- นำเมธอด
RestrictDataCollection()
ออกจากคลาสChartboost
แล้ว - เพิ่มเมธอดตัวช่วยของ
AddDataUseConsent()
สำหรับส่งข้อมูล GDPR และ CCPA ไปยัง Chartboost - รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.1.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.2.0.0
เวอร์ชัน 3.0.1
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.0.3.1
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.1.0.1
เวอร์ชัน 3.0.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 8.0.2.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.1.0.0
เวอร์ชัน 2.0.1
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 7.5.0.1
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.0.4.0
เวอร์ชัน 2.0.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 7.5.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 8.0.1.1
เวอร์ชัน 1.3.0
- อัปเดตปลั๊กอินให้รองรับ มีการให้รางวัล API ใหม่
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 7.3.1.1
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 7.5.0.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 7.3.0.0
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 7.3.0.0
เวอร์ชัน 1.1.1
- รองรับอะแดปเตอร์ Android Chartboost เวอร์ชัน 7.2.0.1
- รองรับอะแดปเตอร์ iOS Chartboost เวอร์ชัน 7.2.0.1
เวอร์ชัน 1.1.0
- รองรับ Chartboost Android SDK เวอร์ชัน 7.2.0
- รองรับ Chartboost iOS SDK เวอร์ชัน 7.2.0
- เพิ่มเมธอด
Chartboost.RestrictDataCollection()
เพื่อเปิดใช้ข้อจำกัดการรวบรวมข้อมูล GDPR สำหรับ Chartboost SDK แล้ว
เวอร์ชัน 1.0.0
- เปิดตัวครั้งแรก
- รองรับ Chartboost Android SDK เวอร์ชัน 7.0.1
- รองรับ Chartboost iOS SDK เวอร์ชัน 7.1.2