คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Chartboost โดยใช้สื่อกลางที่ครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีการเพิ่ม Chartboost ในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Chartboost SDK และอะแดปเตอร์เข้ากับแอป Unity
การผสานรวมที่รองรับและรูปแบบโฆษณา
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ Chartboost มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- Unity 4 ขึ้นไป
- SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK โปรดดูรายละเอียดในเริ่มต้นใช้งาน
- ทำตามคู่มือเริ่มต้นใช้งานสื่อกลาง
ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน Chartboost UI
ลงชื่อสมัครใช้บัญชี Chartboost และเข้าสู่ระบบเมื่อบัญชีได้รับการยืนยันแล้ว จากนั้นไปที่แท็บการจัดการแอป
คลิกปุ่มเพิ่มแอปใหม่เพื่อสร้างแอป
กรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ แล้วคลิกปุ่มเพิ่มแอปเพื่อดำเนินการแอปให้เสร็จ
หลังจากสร้างแอปแล้ว ระบบจะนําคุณไปยังแดชบอร์ดของแอป จดรหัสแอปและลายเซ็นแอปของแอป
Android
iOS
Ad Manager ต้องใช้รหัสผู้ใช้และลายเซ็นผู้ใช้ของ Chartboost เพื่อตั้งค่า Ad Manager รหัสหน่วยโฆษณา คุณค้นหาพารามิเตอร์เหล่านี้ได้โดยคลิกสื่อกลาง Chartboost ใน UI ของ Chartboost
ไปที่แท็บทรัพยากร > โปรแกรมสำรวจ API แล้วจดบันทึกรหัสผู้ใช้และลายเซ็นผู้ใช้ในส่วนการตรวจสอบสิทธิ์
เปิดโหมดทดสอบ
คุณเปิดใช้โหมดทดสอบในแอปได้โดยไปที่แท็บการจัดการแอปจาก UI ของ Chartboost เลือกแอปจากรายการแล้วคลิก แก้ไขการตั้งค่าแอป
Android
iOS
จากการตั้งค่าของแอป คุณสามารถเปิด/ปิดโหมดทดสอบในแอป
เมื่อเปิดใช้โหมดทดสอบแล้ว คุณจะขอโฆษณาโดยใช้รหัสหน่วยโฆษณาที่สร้างไว้ก่อนหน้านี้และรับโฆษณาทดสอบ Chartboost ได้
หลังจากที่คุณรับโฆษณาทดสอบของ Chartboost ได้แล้ว ระบบจะวางแอปของคุณในPublisher App Review ของ Chartboost เพื่อให้การสร้างรายได้บน Chartboost ทำงานได้ การตรวจสอบแอปของผู้เผยแพร่โฆษณาจะต้องได้รับการอนุมัติจาก Chartboost
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ Chartboost ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Chartboost ในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Chartboost ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน Ad Manager
ขั้นตอนที่ 3: นำเข้า Chartboost SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ Chartboost จากลิงก์ดาวน์โหลดใน
Changelog และแยก
GoogleMobileAdsChartboostMediation.unitypackage
ออกจากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsChartboostMediation.unitypackage
ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการ Google Play ของ Unity จะดำเนินการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร 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: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager และเปิดใช้โหมดทดสอบใน 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 ที่กำหนดค่าไว้ใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
104 | โฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลของ Chartboost ไม่พร้อมแสดง |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
101 | พารามิเตอร์เซิร์ฟเวอร์ Chartboost ที่กำหนดค่าไว้ใน Ad Manager 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 Mediation
เวอร์ชัน 4.5.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 9.6.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.6.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 4.4.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 9.5.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.5.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.3
เวอร์ชัน 4.3.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 9.4.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.4.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.0
เวอร์ชัน 4.2.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 9.3.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.3.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.2.0
เวอร์ชัน 4.1.1
- ย้ายเนื้อหาของอะแดปเตอร์ไปที่
GoogleMobileAds/Mediation/Chartboost/
แล้ว - เนมสเปซของอะแดปเตอร์ที่มีการเปลี่ยนโครงสร้างภายในเพื่อใช้
GoogleMobileAds.Mediation.Chartboost
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 9.2.1.1
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.2.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 4.1.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 9.2.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.2.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.1
เวอร์ชัน 4.0.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 9.1.1.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.1.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 3.5.1
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.4.3.1
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.5.0.2
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 3.5.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.4.2.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.5.0.2
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 3.4.1
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.3.1.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.5.0.2
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 3.4.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.3.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.5.0.1.0
เวอร์ชัน 3.3.1
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.2.1.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.4.1.1
เวอร์ชัน 3.3.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.2.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.4.0.0
เวอร์ชัน 3.2.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.1.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.3.1.0
เวอร์ชัน 3.1.0
- นำเมธอด
RestrictDataCollection()
ออกจากคลาสChartboost
แล้ว - เพิ่มเมธอดตัวช่วย
AddDataUseConsent()
ในการส่งข้อมูล GDPR และ CCPA ไปยัง Chartboost - รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.1.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.2.0.0
เวอร์ชัน 3.0.1
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.0.3.1
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.1.0.1
เวอร์ชัน 3.0.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 8.0.2.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.1.0.0
เวอร์ชัน 2.0.1
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 7.5.0.1
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.0.4.0
เวอร์ชัน 2.0.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 7.5.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 8.0.1.1
เวอร์ชัน 1.3.0
- อัปเดตปลั๊กอินเพื่อรองรับ API ที่มีการให้รางวัลใหม่
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 7.3.1.1
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 7.5.0.0
เวอร์ชัน 1.2.0
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 7.3.0.0
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 7.3.0.0
เวอร์ชัน 1.1.1
- รองรับอะแดปเตอร์ Chartboost Android เวอร์ชัน 7.2.0.1
- รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 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