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

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

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

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

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

1 การผสานรวม Waterfall อยู่ในรุ่นเบต้าแบบจำกัดผู้ใช้งาน

Waterfall รองรับเฉพาะแบนเนอร์ขนาด 320x50 และ 728x90 การเสนอราคาไม่รองรับโฆษณาแบนเนอร์

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

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

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

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

หากต้องการตั้งค่าหน่วยโฆษณา AdMob คุณจะต้องมีคีย์ SDK และคีย์รายงานของ AppLovin หากต้องการค้นหา ให้ไปที่ UI ของ AppLovin > Account > Keys เพื่อดูค่าทั้ง 2 ค่า

หากวางแผนที่จะผสานรวมการเสนอราคาเท่านั้น คุณสามารถดำเนินการต่อเพื่อกำหนดการตั้งค่าสื่อกลาง

เลือกแอปสําหรับสื่อกลาง

การเสนอราคา

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

น้ำตก

ใน UI ของ AppLovin ให้เลือก Applications ในส่วน Monetization เพื่อไปยังแอปที่ลงทะเบียนไว้ เลือกแอปที่ต้องการใช้กับสื่อกลางจากรายการแอปที่มีอยู่

สร้างโซน

การเสนอราคา

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

น้ำตก

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

ป้อนชื่อ Zone ID เลือก Android เป็นแพลตฟอร์ม และเลือกประเภทโฆษณา

กำหนดค่าการกำหนดราคาสำหรับโซนโดยเลือก CPM คงที่หรือเพิ่มประสิทธิภาพโดย AppLovin คุณสามารถกำหนดค่า CPM เป็นรายประเทศสำหรับตัวเลือก CPM คงที่ จากนั้นคลิกบันทึก

Android

iOS

เมื่อสร้างโซนแล้ว คุณจะดูรหัสโซนได้ในคอลัมน์รหัสโซน

Android

iOS

อัปเดต app-ads.txt

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

หากต้องการใช้ app-ads.txt สำหรับ AppLovin ให้เพิ่ม AppLovin ลงในไฟล์ app-ads.txt

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

ทำตามวิธีการในคู่มือโหมดทดสอบ MAX ของ AppLovin เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบของ AppLovin

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

    npm

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

    ไหมพรม

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

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

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

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

ประกาศผู้ใช้ที่เป็นเด็ก

AppLovin ไม่รองรับการเริ่มต้นใช้งาน AppLovin SDK ที่เกี่ยวข้องกับเด็ก ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ AppLovin เกี่ยวกับ "ข้อห้ามเกี่ยวกับข้อมูลของเด็กหรือการใช้บริการสำหรับเด็กหรือแอปที่กำหนดเป้าหมายไปยังเด็กโดยเฉพาะ" สำหรับ Android หรือ iOS

ปลั๊กอินสื่อกลาง Google Mobile Ads React Native สำหรับ AppLovin จะปิดใช้สื่อกลางไปยัง AppLovin โดยอัตโนมัติสำหรับแอปที่ประกาศผู้ใช้ที่เป็นเด็กโดยใช้การตั้งค่าการดูแลตามอายุ

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

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ AppLovin มีเมธอด AppLovinMediation.setDoNotSell() โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง AppLovin SDK คุณต้องตั้งค่าตัวเลือกเหล่านี้ก่อนที่จะเริ่มต้น Google Mobile Ads SDK เพื่อให้แน่ใจว่าระบบจะส่งต่อตัวเลือกเหล่านี้ไปยัง AppLovin SDK อย่างถูกต้อง

import { AppLovinMediation } from '@google/gma-mediation-applovin';
// ...

AppLovinMediation.setDoNotSell(true);

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบด้านความเป็นส่วนตัวของ AppLovin

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

ขั้นตอนที่ไม่บังคับ

พารามิเตอร์เฉพาะเครือข่าย

อะแดปเตอร์ AppLovin รองรับการส่งออบเจ็กต์ AppLovinMediationExtras ไปยังคำขอโฆษณาเพื่อตั้งค่าพารามิเตอร์เฉพาะเครือข่าย โค้ดตัวอย่างต่อไปนี้แสดงวิธีปิดเสียงในโฆษณาวิดีโอโดยใช้พารามิเตอร์ isMuted

import { AdRequest } from '@google/mobile-ads';
import { AppLovinMediationExtras } from '@google/gma-mediation-applovin';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new AppLovinMediationExtras({
      isMuted: true, // Mute audio for AppLovin ads
    }),
  ],
};

การเพิ่มประสิทธิภาพ

การเพิ่มการเรียกไปยัง ในกิจกรรมการเปิดตัวจะช่วยให้ AppLovin สามารถติดตามเหตุการณ์ได้ ทันทีที่แอปเริ่มทำงาน

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

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

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Android

รหัสข้อผิดพลาด เหตุผล
-1009 ถึง -1, 204 AppLovin SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ AppLovin
101 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ AppLovin รองรับ
103 บริบทเป็นค่า Null
104 โทเค็นราคาเสนอของ AppLovin ว่างเปล่า
105 ขอโฆษณาหลายรายการสำหรับโซนเดียวกัน AppLovin โหลดโฆษณาได้ครั้งละ 1 รายการต่อโซนเท่านั้น
106 โฆษณาไม่พร้อมแสดง
108 อะแดปเตอร์ AppLovin ไม่รองรับรูปแบบโฆษณาที่ขอ
109 บริบทไม่ใช่อินสแตนซ์กิจกรรม
110 ไม่มีคีย์ SDK
112 ผู้ใช้เป็นเด็ก
113 ไม่มีรหัสหน่วยโฆษณา

iOS

รหัสข้อผิดพลาด เหตุผล
-1009 ถึง -1, 204 AppLovin SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่เอกสารประกอบของ AppLovin
101 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ AppLovin รองรับ
102 พารามิเตอร์เซิร์ฟเวอร์ AppLovin ที่กำหนดค่าใน UI ของ AdMob หายไป/ไม่ถูกต้อง
103 แสดงโฆษณา AppLovin ไม่สำเร็จ
104 ขอโฆษณาหลายรายการสำหรับโซนเดียวกัน AppLovin โหลดโฆษณาได้ครั้งละ 1 รายการต่อโซนเท่านั้น
105 ไม่พบคีย์ SDK ของ AppLovin
107 โทเค็นราคาเสนอว่างเปล่า
108 อะแดปเตอร์ AppLovin ไม่รองรับรูปแบบโฆษณาที่ขอ
110 AppLovin ส่ง Callback การโหลดที่สําเร็จ แต่โหลดโฆษณาเป็น 0 รายการ
111 เรียกข้อมูลอินสแตนซ์ของ AppLovin SDK ไม่ได้
112 ผู้ใช้เป็นเด็ก
113 ไม่ได้เริ่มต้นอินสแตนซ์ที่แชร์ของ AppLovin SDK
114 AppLovin SDK ไม่สามารถแสดงผลโทเค็นการเสนอราคา
115 ไม่มีรหัสหน่วยโฆษณา โหลดโฆษณาไม่ได้
116 โฆษณายังไม่พร้อมใช้งาน แสดงโฆษณาไม่ได้

เวอร์ชัน 0.1.0

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