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

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

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

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

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

¹ โฆษณาแบนเนอร์ (ไม่รวมแบนเนอร์ MREC) ได้รับการสนับสนุนในสื่อกลางเท่านั้น การเสนอราคาไม่รองรับ โฆษณาแบนเนอร์ทุกประเภท

ข้อกำหนด

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

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

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

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

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

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

การเสนอราคา

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

น้ำตก

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

สร้างโซน

การเสนอราคา

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

น้ำตก

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

ป้อนชื่อ Zone ID, เลือก Android เป็น Platform และเลือกประเภทโฆษณา

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

Android

iOS

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

Android

iOS

หมายเหตุ: เราขอแนะนำให้คุณสร้างโซน AppLovin ที่สอดคล้องกับ AdMob หน่วยโฆษณาแต่ละหน่วยเพื่อ AdMob มีประสิทธิภาพมากขึ้น เพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาในสื่อกลาง

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

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

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

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

Android

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

iOS

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

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

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

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

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

หมายเหตุ: การไม่สามารถผสานรวมเวอร์ชัน AppLovin และ SDK โฆษณา Google Mobile ที่ใช้งานร่วมกันได้อาจทำให้เกิดปัญหาการสร้างได้

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วยAppLovin SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_applovin: ^1.0.0

การผสานรวมด้วยตนเอง

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ AppLovin ดึงข้อมูลไฟล์ที่ดาวน์โหลด และเพิ่มโฟลเดอร์ปลั๊กอินที่ดึงมา (และเนื้อหาในไฟล์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

ความยินยอมของสหภาพยุโรปและ GDPR

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

AppLovin รองรับการอ่านสตริงความยินยอมจากค่ากำหนดที่แชร์และตั้งค่าสถานะความยินยอมตามนั้น

หาก ไม่ได้ใช้ CMP ที่เขียนสตริงความยินยอมลงในค่ากำหนดที่ใช้ร่วมกัน คุณจะใช้เมธอด GmaMediationApplovin.setHasUserConsent() และ GmaMediationApplovin.setIsAgeRestrictedUser() ได้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูล ความยินยอมไปยัง AppLovin SDK คุณต้องตั้งค่าตัวเลือกเหล่านี้ก่อนเริ่มใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อให้ระบบส่งต่อไปยัง AppLovin SDK ได้อย่างถูกต้อง

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

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

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

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

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

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ AppLovin ก่อนเปิดตัวแอป

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

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

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

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

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

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

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

การเพิ่มการโทรไปยัง GmaMediationApplovin.initializeSdk('sdkKey') ในกิจกรรมการเปิดตัวทำให้ 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	บริบทเป็นค่าว่าง
104	โทเค็นการเสนอราคา AppLovin ว่างเปล่า
105	ขอโฆษณาหลายรายการสำหรับโซนเดียวกันแล้ว AppLovin โหลดโฆษณาได้ครั้งละ 1 รายการต่อโซนเท่านั้น
106	โฆษณาไม่พร้อมแสดง
108	อะแดปเตอร์ AppLovin ไม่รองรับรูปแบบโฆษณาที่ขอ

iOS

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

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Flutter ของ AppLovin

1.1.0

• API สำหรับ GmaMediationApplovin ไม่คงที่อีกต่อไป
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ AppLovin Android เวอร์ชัน 12.4.3.0
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 12.4.2.0
• สร้างและทดสอบด้วยปลั๊กอิน Google Mobile Ads Flutter เวอร์ชัน 5.1.0

1.0.0

• การเผยแพร่ครั้งแรก
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ AppLovin Android เวอร์ชัน 12.3.0.0
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 12.2.1.0
• สร้างและทดสอบด้วยปลั๊กอิน Google Mobile Ads Flutter เวอร์ชัน 5.0.0