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

คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก Chartboost โดยใช้สื่อกลางที่ครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีการเพิ่ม Chartboost ในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Chartboost SDK และอะแดปเตอร์เข้ากับแอป Unity

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

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

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

ข้อกำหนด

  • Unity 4 ขึ้นไป
  • SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
  • เพื่อทำให้ใช้งานได้ใน Android
    • Android API ระดับ 21 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK โปรดดูรายละเอียดในเริ่มต้นใช้งาน
  • ทำตามคู่มือเริ่มต้นใช้งานสื่อกลาง

ขั้นตอนที่ 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 เวอร์ชันล่าสุดสำหรับ Chartboost จากลิงก์ดาวน์โหลดใน Changelog และแยก GoogleMobileAdsChartboostMediation.unitypackage ออกจากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsChartboostMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า

จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการ Google Play ของ Unity จะดำเนินการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android ของแอป Unity

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

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

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

  • รองรับอะแดปเตอร์ 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