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

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

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

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

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

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

  • 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 ของ Liftoff Monetize

ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Liftoff Monetize

เพิ่มแอปของคุณลงในแดชบอร์ด Liftoff Monetize โดยคลิกปุ่มเพิ่มแอปพลิเคชัน

กรอกรายละเอียดที่จำเป็นทั้งหมดในแบบฟอร์ม

Android

iOS

เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแดชบอร์ดแอปพลิเคชัน Liftoff Monetize

Android

iOS

จดบันทึกรหัสแอป

Android

iOS

เพิ่มตําแหน่งโฆษณาใหม่

หากต้องการสร้างตําแหน่งโฆษณาใหม่เพื่อใช้กับสื่อกลาง AdMob ให้ไปที่ แดชบอร์ดตําแหน่ง Liftoff Monetize คลิกปุ่มเพิ่มตําแหน่งโฆษณา แล้วเลือกแอปจากรายการแบบเลื่อนลง

รายละเอียดการเพิ่มตําแหน่งโฆษณาใหม่มีดังนี้

การเปิดแอป

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

เลือกแบนเนอร์ ป้อนชื่อตําแหน่งโฆษณา และกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอป เป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้า เพื่อสร้างตําแหน่งโฆษณา

แบนเนอร์ขนาด 300x250

เลือก MREC ป้อนชื่อตําแหน่งโฆษณา แล้วกรอกข้อมูลในแบบฟอร์มส่วนที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอป เป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้า เพื่อสร้างตําแหน่งโฆษณา

โฆษณาคั่นระหว่างหน้า

เลือกโฆษณาคั่นระหว่างหน้า ป้อนชื่อตำแหน่งโฆษณา และกรอกข้อมูลที่เหลือ ในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์ การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

ได้รับรางวัลแล้ว

เลือกมีรางวัล ป้อนชื่อตําแหน่งโฆษณา แล้วกรอกข้อมูลที่เหลือใน แบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอป เป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้า เพื่อสร้างตําแหน่งโฆษณา

โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

เลือกได้รับรางวัล ป้อนชื่อตำแหน่งโฆษณา เปิดใช้ข้ามได้และ กรอกข้อมูลในแบบฟอร์มที่เหลือ [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไป ที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

เนทีฟ

เลือกเนทีฟ ป้อนชื่อตําแหน่งโฆษณา และกรอกข้อมูลที่เหลือใน แบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอป เป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้า เพื่อสร้างตําแหน่งโฆษณา

จดรหัสอ้างอิงไว้ แล้วคลิกตกลง

การเปิดแอป

แบนเนอร์ขนาด 300x250

โฆษณาคั่นระหว่างหน้า

ได้รับรางวัลแล้ว

โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

เนทีฟ

ค้นหาคีย์ Reporting API

การเสนอราคา

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

นอกจากรหัสแอปและรหัสอ้างอิงแล้ว คุณยังต้องใช้คีย์ Reporting API ของ Liftoff Monetize เพื่อตั้งค่ารหัสหน่วยโฆษณา AdMob ด้วย ไปที่แดชบอร์ดรายงาน Liftoff Monetize แล้วคลิกปุ่มคีย์ Reporting API เพื่อดูคีย์ Reporting API

อัปเดต app-ads.txt

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

หากต้องการใช้ app-ads.txt สำหรับ Liftoff Monetize ให้ดาวน์โหลดและเพิ่มรายการ app-ads.txt ของ Liftoff Monetize ลงในไฟล์ app-ads.txt ที่มีอยู่ ดูข้อมูลเพิ่มเติมได้ที่ app-ads.txt

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

หากต้องการเปิดใช้โฆษณาทดสอบ ให้ไปที่แดชบอร์ด Liftoff Monetize แล้วไปที่แอปพลิเคชัน

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

    npm

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

    ไหมพรม

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

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

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

อะแดปเตอร์ Liftoff Monetize React Native เวอร์ชัน N/A ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง Liftoff Monetize SDK ดูข้อมูลเพิ่มเติมได้ที่วิธีการติดตั้งใช้งานที่แนะนำตาม GDPR สำหรับ Android และ iOS

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

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

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยังอะแดปเตอร์ Liftoff Monetize ด้วยตนเอง

import { LiftoffMonetizeMediation } from '@google/gma-mediation-liftoffmonetize';
// ...

LiftoffMonetizeMediation.setCCPAStatus({ optedIn: true });

ดูวิธีการติดตั้งใช้งานที่แนะนำสำหรับ CCPA ใน Android และ iOS เพื่อดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในเมธอด

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

อย่าลืมลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob และเปิดใช้โหมดทดสอบใน UI ของ Liftoff Monetize

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

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

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Liftoff Monetize ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่สำคัญจากการตอบกลับโฆษณาโดยใช้ ResponseInfo ในคลาสต่อไปนี้

Android

รูปแบบ ชื่อประเภท
โฆษณาเปิดแอป (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
โฆษณาเปิดแอป (การแสดงวิดีโอตามลำดับขั้น) com.google.ads.mediation.vungle.VungleMediationAdapter
แบนเนอร์ (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
แบนเนอร์ (การแสดงวิดีโอตามลำดับขั้น) com.vungle.mediation.VungleInterstitialAdapter
โฆษณาคั่นระหว่างหน้า (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
โฆษณาคั่นระหว่างหน้า (การแสดงวิดีโอตามลำดับขั้น) com.vungle.mediation.VungleInterstitialAdapter
ที่มีการให้รางวัล (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) com.vungle.mediation.VungleAdapter
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

รูปแบบ ชื่อประเภท
โฆษณาเปิดแอป (การเสนอราคา) GADMediationAdapterVungle
โฆษณาเปิดแอป (การแสดงวิดีโอตามลำดับขั้น) GADMediationAdapterVungle
แบนเนอร์ (การเสนอราคา) GADMediationAdapterVungle
แบนเนอร์ (การแสดงวิดีโอตามลำดับขั้น) GADMAdapterVungleInterstitial
โฆษณาคั่นระหว่างหน้า (การเสนอราคา) GADMediationAdapterVungle
โฆษณาคั่นระหว่างหน้า (การแสดงวิดีโอตามลำดับขั้น) GADMAdapterVungleInterstitial
ที่มีการให้รางวัล (การเสนอราคา) GADMediationAdapterVungle
มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) GADMAdapterVungleRewardBasedVideoAd
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) GADMediationAdapterVungle
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การแสดงวิดีโอตามลำดับขั้น) GADMediationAdapterVungle

รหัสและข้อความที่แสดงโดยอะแดปเตอร์ Liftoff Monetize เมื่อโหลดโฆษณาไม่สำเร็จมีดังนี้

Android

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น รหัสแอปหรือรหัสตำแหน่งโฆษณา)
102 ขนาดแบนเนอร์ที่ขอไม่ตรงกับขนาดโฆษณา Liftoff Monetize ที่ถูกต้อง
103 Liftoff Monetize ต้องมีบริบท Activity เพื่อขอ โฆษณา
104 Vungle SDK ไม่สามารถโหลดโฆษณาหลายรายการสำหรับรหัสตำแหน่งโฆษณาเดียวกัน
105 เริ่มต้นใช้งาน Vungle SDK ไม่สำเร็จ
106 Vungle SDK แสดงผล Callback การโหลดที่สําเร็จ แต่ Banners.getBanner() หรือ Vungle.getNativeAd() แสดงผลเป็น Null
107 Vungle SDK ยังไม่พร้อมเล่นโฆษณา
108 Vungle SDK แสดงผลโทเค็นการเสนอราคาที่ไม่ถูกต้อง

iOS

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น รหัสแอปหรือรหัสตำแหน่งโฆษณา)
102 มีการโหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว Vungle SDK ไม่สามารถโหลดโฆษณารายการที่ 2 สำหรับรหัสตำแหน่งโฆษณาเดียวกันได้
103 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ Liftoff Monetize รองรับ
104 Vungle SDK แสดงผลโฆษณาแบนเนอร์ไม่ได้
105 Vungle SDK รองรับการโหลดโฆษณาแบนเนอร์ครั้งละ 1 รายการเท่านั้น ไม่ว่าจะเป็นรหัสตำแหน่งโฆษณาใดก็ตาม
106 Vungle SDK ส่ง Callback ที่ระบุว่าโฆษณาเล่นไม่ได้
107 Vungle SDK ยังไม่พร้อมเล่นโฆษณา

สําหรับข้อผิดพลาดที่มาจาก Vungle SDK โปรดดูรหัสข้อผิดพลาด: Vungle SDK สําหรับ iOS และ Android

เวอร์ชัน 0.1.0

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