คู่มือนี้แสดงวิธีใช้ 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 Mobile เวอร์ชันล่าสุดสำหรับ Chartboost
จากลิงก์ดาวน์โหลดใน
Changelog และดึงข้อมูล
GoogleMobileAdsChartboostMediation.unitypackage
จากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ >
แพ็กเกจที่กำหนดเอง แล้วค้นหา GoogleMobileAdsChartboostMediation.unitypackage
ที่คุณดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิก
นำเข้า
จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ Google Play > รีโซลเวอร์ Android >
บังคับให้แก้ไข ไลบรารีตัวแปลค่าบริการ Unity Play จะทำงาน
การแก้ไขทรัพยากร Dependency ใหม่ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ไปยัง
ไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน Chartboost SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้ความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่าง และ ความยินยอมที่ได้รับจาก ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับ การใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นไปตาม ข้อกำหนดด้าน ePrivacy และการคุ้มครองข้อมูลทั่วไปของสหภาพยุโรป กฎระเบียบ (GDPR) เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัว และ ให้ข้อมูลเกี่ยวกับการใช้งานของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถ ส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ปลั๊กอินสื่อกลางโฆษณา Google Mobile สำหรับ Chartboost เวอร์ชัน 3.1.0 มี
Chartboost.AddDataUseConsent()
วิธี โค้ดตัวอย่างต่อไปนี้จะกำหนดการใช้ข้อมูล
ให้ความยินยอมแก่ NonBehavioral
หากคุณเลือกที่จะเรียกใช้วิธีนี้ ขอแนะนำให้
ที่ต้องดําเนินการก่อนขอโฆษณาโดยใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
สหรัฐอเมริกา กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐ ต้องให้ผู้ใช้ได้รับ เพื่อเลือกไม่ใช้ "การลดราคา" ของ "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ข้อกำหนดดังกล่าว) โดยการเลือกไม่ใช้ที่นำเสนอผ่านโฆษณาว่า "อย่าขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัด ข้อมูล" ลิงก์ในหน้า "การขาย" หน้าแรกของพรรคการเมือง สหรัฐอเมริกา สถานะความเป็นส่วนตัว คู่มือการปฏิบัติตามกฎหมายช่วยให้คุณ การประมวลผลข้อมูลแบบจำกัด สําหรับการแสดงโฆษณาของ Google แต่ Google ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด
ปลั๊กอินสื่อกลางโฆษณา Google Mobile สำหรับ 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
เวอร์ชันถัดไป
- เปลี่ยนชื่อ
DummyClient
เป็นPlaceholderClient
แล้ว
เวอร์ชัน 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