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

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

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

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

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

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

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

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

• Google Mobile Ads SDK for React Native เวอร์ชันล่าสุด
• เฟรมเวิร์ก React Native เวอร์ชัน 0.85.0 ขึ้นไป
• วิธีติดตั้งใช้งานใน Android
  • Android API ระดับ 24 ขึ้นไป
• วิธีติดตั้งใช้งานใน iOS
  • เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
• โปรเจ็กต์ React Native ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads SDK for React Native ดูรายละเอียดได้ที่ตั้งค่า Google Mobile Ads SDK for React Native
  • ตรวจสอบว่าคุณได้ดาวน์โหลดและแตกโฟลเดอร์ adapters จากโฟลเดอร์ gma-sdk-react-native แล้ว หากไม่มีโฟลเดอร์ adapters ให้ทำตามขั้นตอนที่ 1, 2 และ 3 ในหัวข้อติดตั้ง Google Mobile Ads SDK for React Native
• ตั้งค่าสื่อกลาง AdMob

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

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

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

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

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

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

Android

iOS

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

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

อัปเดต app-ads.txt

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

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

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

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

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

สำคัญ: ตรวจสอบว่าคุณมีสิทธิ์การจัดการบัญชีเพื่อกำหนดค่าความยินยอมของ EU และ GDPR, กฎระเบียบของรัฐในสหรัฐอเมริกา และ User Messaging Platform ให้เสร็จสมบูรณ์ โปรดดูรายละเอียดที่หัวข้อจัดการสิทธิ์ของผู้ใช้ในการเข้าถึงบัญชีของคุณ

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

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

หมายเหตุ: การไม่ผสานรวม Chartboost และ Google Mobile Ads SDK for React Native เวอร์ชันที่เข้ากันได้อาจทำให้เกิดปัญหาในการสร้าง

ติดตั้งGoogle Mobile Ads SDK for React Nativeอะแดปเตอร์สื่อกลางสำหรับ Chartboost ในไดเรกทอรีรากของโปรเจ็กต์ ดำเนินการต่อไปนี้ให้เสร็จสมบูรณ์

1. คัดลอกไฟล์ tar ของอะแดปเตอร์ Google Mobile Ads SDK for React Native จากไดเรกทอรี gma-sdk-react-native/adapters/chartboost/ ไปยังไดเรกทอรี local_packages/ ของโปรเจ็กต์ หากไม่มีโฟลเดอร์ adapters โปรดดูข้อกำหนดเบื้องต้น

   mkdir -p local_packages
   cp EXTRACT_DIR/gma-sdk-react-native/adapters/chartboost/gma-mediation-chartboost-0.1.0.tgz local_packages/
   

   แทนที่ EXTRACT_DIR ด้วยเส้นทางไปยังไดเรกทอรีที่คุณแตกไฟล์เก็บถาวร

2. ติดตั้งแพ็กเกจอะแดปเตอร์โดยใช้เครื่องมือจัดการแพ็กเกจที่ต้องการ ดังนี้

   npm

   npm install ./local_packages/gma-mediation-chartboost-0.1.0.tgz
   

   ไหมพรม

   yarn add ./local_packages/gma-mediation-chartboost-0.1.0.tgz
   

3. หากคุณกำลังสร้างสำหรับ Android ให้เพิ่มที่เก็บต่อไปนี้ลงในไฟล์ build.gradle ในไดเรกทอรี android ของโปรเจ็กต์

   repositories {
       google()
       mavenCentral()
       maven {
           url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
       }
   }
   

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

อะแดปเตอร์ Chartboost React Native เวอร์ชัน 0.1.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จาก UMP SDK และแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับข้อกำหนดความยินยอมเพิ่มเติมของ Google ไปยัง Chartboost SDK ดูข้อมูลเพิ่มเติมได้ที่เมธอดความเป็นส่วนตัวของ SDK สำหรับ Android และ iOS

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

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

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

import {
  ChartboostCCPAConsent,
  ChartboostMediation,
} from '@google/gma-mediation-chartboost';
// ...

ChartboostMediation.addCCPADataUseConsent(ChartboostCCPAConsent.OPT_IN_SALE);

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

iOS

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

เวอร์ชัน 0.1.0

• การเผยแพร่ครั้งแรก

• รองรับ Chartboost Android Adapter เวอร์ชัน 9.12.0.0
• รองรับอะแดปเตอร์ Chartboost iOS เวอร์ชัน 9.12.0.1