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

คู่มือนี้แสดงวิธีใช้ 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 และเข้าสู่ระบบเมื่อบัญชีได้รับการยืนยันแล้ว จากนั้นไปที่แท็บการจัดการแอป

แดชบอร์ดแอป Chartboost

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

การจัดการแอป

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

แบบฟอร์มแอปใหม่

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

Android

การตั้งค่าแอป

iOS

การตั้งค่าแอป

AdMob ต้องใช้รหัสผู้ใช้และลายเซ็นผู้ใช้ของ Chartboost เพื่อตั้งค่า AdMob รหัสหน่วยโฆษณา คุณค้นหาพารามิเตอร์เหล่านี้ได้โดยคลิกสื่อกลาง Chartboost ใน UI ของ Chartboost

แดชบอร์ดสื่อกลาง Chartboost

ไปที่แท็บทรัพยากร > โปรแกรมสำรวจ API แล้วจดบันทึกรหัสผู้ใช้และลายเซ็นผู้ใช้ในส่วนการตรวจสอบสิทธิ์

โปรแกรมสำรวจ Chartboost API

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

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

Android

แก้ไขการตั้งค่าแอป

iOS

แก้ไขการตั้งค่าแอป

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

โหมดทดสอบ Chartboost

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

ภายใต้ความยินยอมของผู้ใช้ 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

เวอร์ชัน 4.6.0

เวอร์ชัน 4.5.0

เวอร์ชัน 4.4.0

เวอร์ชัน 4.3.0

เวอร์ชัน 4.2.0

เวอร์ชัน 4.1.1

เวอร์ชัน 4.1.0

เวอร์ชัน 4.0.0

เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.0

เวอร์ชัน 3.4.1

เวอร์ชัน 3.4.0

เวอร์ชัน 3.3.1

เวอร์ชัน 3.3.0

เวอร์ชัน 3.2.0

เวอร์ชัน 3.1.0

เวอร์ชัน 3.0.1

เวอร์ชัน 3.0.0

เวอร์ชัน 2.0.1

เวอร์ชัน 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