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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

Ad Manager Mediation Adapter สำหรับ Chartboost มีความสามารถต่อไปนี้

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

  • Google Mobile Ads Unity Plugin เวอร์ชันล่าสุด
  • Unity Editor เวอร์ชัน 2019.4 ขึ้นไป
  • วิธีติดตั้งใช้งานใน Android
    • Android API ระดับ 24 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Unity Plugin ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads Unity Plugin
  • ตั้งค่าสื่อกลาง

    • ขั้นตอนที่ 1: ตั้งค่าใน UI ของ Chartboost

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

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

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

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

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

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

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

    Android

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

    iOS

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

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

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

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

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

    อัปเดต app-ads.txt

    ผู้ขายที่ได้รับอนุญาตสำหรับแอปหรือ app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับ Ad Manager

    หากต้องการใช้ app-ads.txt สำหรับ Chartboost โปรดดู app-ads.txt

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

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

    Android

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

    iOS

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

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

    โหมดทดสอบของ Chartboost

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

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

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

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

    Android

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

    iOS

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

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

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

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

    OpenUPM-CLI

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

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

    OpenUPM

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

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

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

    รายละเอียด OpenUPM

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

    Unity Registry

    เลือกแพ็กเกจ Google Mobile Ads Chartboost Mediation แล้วคลิกติดตั้ง

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Chartboost เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วแตกไฟล์ GoogleMobileAdsChartboostMediation.unitypackage จากไฟล์ ZIP

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

    นำเข้าจาก Unity

    จากนั้นเลือก Assets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

    บังคับแก้ไข

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

    หากต้องการปฏิบัติตาม นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องเปิดเผยข้อมูลบางอย่างต่อ ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร และสวิตเซอร์แลนด์ รวมถึงขอรับ ความยินยอมจากผู้ใช้สำหรับการใช้คุกกี้หรือพื้นที่เก็บข้อมูลอื่นๆ ในเครื่องตามที่กฎหมาย กำหนด และสำหรับการเก็บรวบรวม แชร์ และใช้ข้อมูลส่วนตัวเพื่อการปรับโฆษณา ตามโปรไฟล์ของผู้ใช้ นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป คุณมีหน้าที่ ตรวจสอบว่ามีการส่งต่อความยินยอมไปยังแหล่งที่มาของโฆษณาแต่ละแห่งใน เชนสื่อกลาง (Mediation Chain)

    กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

    กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิ เลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาให้ความสามารถในการเปิดใช้การประมวลผลข้อมูลแบบจำกัดสำหรับการแสดงโฆษณา Google แต่ Google ไม่สามารถใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง (Mediation Chain) ของคุณได้ ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง (Mediation Chain) ที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และปฏิบัติตามคำแนะนำจากเครือข่ายแต่ละเครือข่ายเพื่อให้เป็นไปตามข้อกำหนด

    โค้ดตัวอย่างต่อไปนี้ตั้งค่าความยินยอมให้ใช้ข้อมูลเป็น OptInSale หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาโดยใช้ Google Mobile Ads Unity Plugin

    using GoogleMobileAds.Api.Mediation.Chartboost;
// ...

Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);

    ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น

    Android

    ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Chartboost

    iOS

    การผสานรวม SKAdNetwork

    ทำตามเอกสารประกอบของ Chartboost เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

    ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน

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

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

    ยืนยันโฆษณาทดสอบ

    หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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 ที่กำหนดค่าใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
    104 โฆษณาคั่นระหว่างหน้าหรือโฆษณาที่มีการให้รางวัลของ Chartboost ไม่พร้อมที่จะแสดง

    iOS

    รหัสข้อผิดพลาด เหตุผล
    101 พารามิเตอร์เซิร์ฟเวอร์ของ Chartboost ที่กำหนดค่าไว้ใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
    102 SDK ของ Chartboost แสดงข้อผิดพลาดในการเริ่มต้น
    103 ระบบไม่ได้แคชโฆษณา Chartboost ในเวลาที่แสดง
    104 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Chartboost รองรับ
    105 เวอร์ชันระบบปฏิบัติการของอุปกรณ์ต่ำกว่าเวอร์ชันระบบปฏิบัติการขั้นต่ำที่ Chartboost SDK รองรับ
    200-299 ข้อผิดพลาดของแคช SDK ของ Chartboost ดูรายละเอียดเพิ่มเติมได้ที่โค้ด
    300-399 SDK ของ Chartboost แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่โค้ด
    400-499 ข้อผิดพลาดในการคลิก SDK ของ Chartboost ดูรายละเอียดเพิ่มเติมได้ที่โค้ด

    บันทึกการเปลี่ยนแปลงของปลั๊กอินสื่อกลาง Chartboost Unity

    เวอร์ชัน 4.15.2 (กำลังดำเนินการ)

    เวอร์ชัน 4.15.1

    เวอร์ชัน 4.15.0

    เวอร์ชัน 4.14.0

    เวอร์ชัน 4.13.0

    เวอร์ชัน 4.12.1

    เวอร์ชัน 4.12.0

    เวอร์ชัน 4.11.3

    เวอร์ชัน 4.11.2

    เวอร์ชัน 4.11.1

    เวอร์ชัน 4.11.0

    เวอร์ชัน 4.10.3

    เวอร์ชัน 4.10.2

    เวอร์ชัน 4.10.1

    เวอร์ชัน 4.10.0

    เวอร์ชัน 4.9.3

    เวอร์ชัน 4.9.2

    เวอร์ชัน 4.9.1

    เวอร์ชัน 4.9.0

    เวอร์ชัน 4.8.0

    เวอร์ชัน 4.7.3

    เวอร์ชัน 4.7.2

    เวอร์ชัน 4.7.1

    เวอร์ชัน 4.7.0

    เวอร์ชัน 4.6.1

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

    • รองรับอะแดปเตอร์ Chartboost สำหรับ Android เวอร์ชัน 7.5.0.0
    • รองรับอะแดปเตอร์ iOS ของ Chartboost เวอร์ชัน 8.0.1.1

    เวอร์ชัน 1.3.0

    • อัปเดตปลั๊กอินเพื่อรองรับ Rewarded API ใหม่
    • รองรับอะแดปเตอร์ Android ของ Chartboost เวอร์ชัน 7.3.1.1
    • รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 7.5.0.0

    เวอร์ชัน 1.2.0

    • รองรับ Chartboost Android Adapter เวอร์ชัน 7.3.0.0
    • รองรับอแดปเตอร์ iOS ของ Chartboost เวอร์ชัน 7.3.0.0

    เวอร์ชัน 1.1.1

    • รองรับ Chartboost Android Adapter เวอร์ชัน 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