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

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

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

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

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

ข้อกำหนด

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

ขั้นตอนที่ 1: กำหนดค่าใน Chartboost UI

ลงชื่อสมัครใช้บัญชี Chartboost และ เข้าสู่ระบบเมื่อบัญชีของคุณได้รับการยืนยัน จากนั้นไปที่แท็บการจัดการแอป

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

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

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

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

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

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

Android

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

iOS

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

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

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

ไปที่แหล่งข้อมูล > โปรแกรมสำรวจ API และจดบันทึก User ID และ User Signature จะอยู่ในส่วนการตรวจสอบสิทธิ์

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

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

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

Android

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

iOS

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

จากการตั้งค่าของแอป คุณจะสลับโหมดทดสอบในแอปได้

โหมดทดสอบ Chartboost

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

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

ขั้นตอนที่ 2: ตั้งค่าความต้องการ Chartboost ใน Ad Manager UI

กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android

iOS

โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

เพิ่ม Chartboost ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และรัฐในสหรัฐอเมริกา

ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Chartboost ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน Ad Manager

ขั้นตอนที่ 3: นำเข้า Chartboost SDK และอะแดปเตอร์

OpenUPM-CLI

หากคุณมี OpenUPM-CLI ติดตั้งแล้ว คุณสามารถติดตั้งชาร์ตบูสต์โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ปลั๊กอินสื่อกลางสำหรับ Unity ไปยังโปรเจ็กต์โดยเรียกใช้คำสั่งต่อไปนี้ จากไดเรกทอรีรากของโปรเจ็กต์:

openupm add com.google.ads.mobile.mediation.chartboost

OpenUPM

ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิด การตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตด้วยตัวเลือก รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิด ตัวจัดการแพ็กเกจ Unity และ เลือก My Registries จากเมนูแบบเลื่อนลง

รีจิสทรี Unity

เลือกแพ็กเกจสื่อกลาง Chartboost ของ Google Mobile Ads และ ให้คลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ Chartboost จากลิงก์ดาวน์โหลดใน เวลา บันทึกการเปลี่ยนแปลง และดึงข้อมูล GoogleMobileAdsChartboostMediation.unitypackage จากรหัสไปรษณีย์

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

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > ตัวแก้ไขบริการ 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: ทดสอบการใช้งาน

เปิดใช้โฆษณาทดสอบ

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ 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

เวอร์ชันถัดไป

  • เปลี่ยนชื่อ DummyClient เป็น PlaceholderClient แล้ว

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