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

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

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

Ad Manager Mediation Adapter สําหรับ AppLovin มีความสามารถดังต่อไปนี้

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

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

ข้อกำหนด

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

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

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

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

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

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

การเสนอราคา

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

น้ำตก

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

สร้างโซน

การเสนอราคา

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

น้ำตก

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

dependencies:
  gma_mediation_applovin: ^1.0.0

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

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

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

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

ความยินยอมของผู้ใช้ EU และ GDPR

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

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

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

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

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

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

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

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

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

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

GmaMediationApplovin.setDoNotSell(true);

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสําหรับ Ad Manager และ Applovin ก่อนเผยแพร่แอป

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

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Applovin ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียวในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Applovin (การเสนอราคา) และ 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],
);

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

การเพิ่มคำกระตุ้นให้ดำเนินการ (Call-To-Action) 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 Adapter ไม่รองรับรูปแบบโฆษณาที่ขอ

iOS

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

บันทึกการเปลี่ยนแปลงของ AppLovin Flutter Mediation Adapter

เวอร์ชันถัดไป

• สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.2.0

1.2.0

• ยืนยันความเข้ากันได้กับอะแดปเตอร์ Android เวอร์ชัน 12.6.1.0 ของ AppLovin
• ยืนยันความเข้ากันได้กับ AppLovin iOS Adapter เวอร์ชัน 12.6.1.0
• สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0

1.1.0

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

1.0.0

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