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

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

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

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

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

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

ข้อกำหนด

  • SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
  • Unity 5.6 ขึ้นไป
  • [สำหรับการเสนอราคา]: ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สําหรับ AppLovin 4.2.0 ขึ้นไป (แนะนําเวอร์ชันล่าสุด)
  • เพื่อทำให้ใช้งานได้ใน Android
    • Android API ระดับ 21 ขึ้นไป
  • เพื่อทำให้ใช้งานได้ใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย 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 โหมดทดสอบ MAX เกี่ยวกับวิธีเปิดใช้โฆษณาทดสอบ AppLovin

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

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

Android

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

iOS

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

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

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

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

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ AppLovin จากลิงก์ดาวน์โหลดใน บันทึกการเปลี่ยนแปลง และแยกGoogleMobileAdsAppLovinMediation.unitypackageออกจากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsAppLovinMediation.unitypackage ที่ดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว จากนั้นคลิกนำเข้า

จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการของ Unity Play จะดำเนินการแก้ปัญหาทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android ของแอป Unity

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

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

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

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

นอกจากนี้ หากทราบว่าผู้ใช้อยู่ในหมวดหมู่ที่จำกัดอายุผู้ชม คุณยังตั้งค่าแฟล็กด้านล่างเป็น true ได้ด้วย

AppLovin.SetIsAgeRestrictedUser(true);

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

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

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

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

การเพิ่มการโทรไปยัง AppLovin.Initialize() ในกิจกรรมการเปิดตัวทำให้ 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

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

เวอร์ชัน 7.1.0

เวอร์ชัน 7.0.1

เวอร์ชัน 7.0.0

เวอร์ชัน 6.9.1

เวอร์ชัน 6.9.0

เวอร์ชัน 6.8.0

เวอร์ชัน 6.7.0

เวอร์ชัน 6.6.0

เวอร์ชัน 6.5.1

เวอร์ชัน 6.5.0

เวอร์ชัน 6.4.3

เวอร์ชัน 6.4.2

เวอร์ชัน 6.4.1

เวอร์ชัน 6.4.0

เวอร์ชัน 6.3.1

เวอร์ชัน 6.3.0

เวอร์ชัน 6.2.1

เวอร์ชัน 6.2.0

เวอร์ชัน 6.1.0

เวอร์ชัน 6.0.0

เวอร์ชัน 5.1.3

เวอร์ชัน 5.1.2

เวอร์ชัน 5.1.1

เวอร์ชัน 5.1.0

เวอร์ชัน 5.0.0

เวอร์ชัน 4.8.1

เวอร์ชัน 4.8.0

เวอร์ชัน 4.7.0

เวอร์ชัน 4.6.2

เวอร์ชัน 4.6.1

เวอร์ชัน 4.6.0

เวอร์ชัน 4.5.8

เวอร์ชัน 4.5.7

เวอร์ชัน 4.5.6

เวอร์ชัน 4.5.5

เวอร์ชัน 4.5.4

เวอร์ชัน 4.5.3

เวอร์ชัน 4.5.2

เวอร์ชัน 4.5.1

เวอร์ชัน 4.5.0

เวอร์ชัน 4.4.1

เวอร์ชัน 4.4.0

เวอร์ชัน 4.3.0

เวอร์ชัน 4.2.0

  • รองรับอะแดปเตอร์ AppLovin Android เวอร์ชัน 9.4.2.0
  • รองรับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 6.6.1.0

เวอร์ชัน 4.1.0

  • อัปเดตปลั๊กอินเพื่อรองรับ API มีการให้รางวัลรุ่นเบต้าแบบเปิดใหม่
  • รองรับอะแดปเตอร์ AppLovin Android เวอร์ชัน 9.2.1.1
  • รองรับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 6.3.0.0

เวอร์ชัน 4.0.0

  • รองรับอะแดปเตอร์ AppLovin Android เวอร์ชัน 9.2.1.0
  • รองรับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 6.2.0.0

เวอร์ชัน 3.1.2

  • รองรับอะแดปเตอร์ AppLovin Android เวอร์ชัน 8.1.4.0
  • รองรับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 5.1.2.0

เวอร์ชัน 3.1.1

  • รองรับอะแดปเตอร์ AppLovin Android เวอร์ชัน 8.1.0.0
  • รองรับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 5.1.1.0

เวอร์ชัน 3.1.0

  • รองรับอะแดปเตอร์ AppLovin Android เวอร์ชัน 8.1.0.0
  • รองรับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 5.1.0.0

เวอร์ชัน 3.0.3

  • รองรับอะแดปเตอร์ AppLovin Android เวอร์ชัน 8.0.2.1
  • รองรับอะแดปเตอร์ AppLovin iOS เวอร์ชัน 5.0.2.0

เวอร์ชัน 3.0.2

  • รองรับ AppLovin Android SDK เวอร์ชัน 8.0.1
  • รองรับ AppLovin iOS SDK เวอร์ชัน 5.0.1

เวอร์ชัน 3.0.1

  • รองรับ AppLovin Android SDK เวอร์ชัน 8.0.0
  • รองรับ AppLovin iOS SDK เวอร์ชัน 5.0.1
  • เพิ่มวิธี AppLovin.SetIsAgeRestrictedUser() เพื่อระบุว่าผู้ใช้อยู่ในหมวดหมู่ที่จำกัดอายุหรือไม่

เวอร์ชัน 3.0.0

  • รองรับ AppLovin Android SDK เวอร์ชัน 8.0.0
  • รองรับ AppLovin iOS SDK เวอร์ชัน 5.0.1
  • เพิ่มเมธอด AppLovin.SetHasUserConsent() เพื่อส่งต่อ Flag ความยินยอมของผู้ใช้ไปยัง AppLovin SDK

เวอร์ชัน 2.0.0

  • รองรับ AppLovin Android SDK เวอร์ชัน 7.8.6
  • รองรับ AppLovin iOS SDK เวอร์ชัน 5.0.1

เวอร์ชัน 1.2.1

  • รองรับ AppLovin Android SDK เวอร์ชัน 7.8.6
  • รองรับ AppLovin iOS SDK เวอร์ชัน 4.8.3

เวอร์ชัน 1.2.0

  • รองรับ AppLovin Android SDK เวอร์ชัน 7.8.5
  • รองรับ AppLovin iOS SDK เวอร์ชัน 4.8.3

เวอร์ชัน 1.1.0

  • รองรับ AppLovin Android SDK เวอร์ชัน 7.7.0
  • รองรับ AppLovin iOS SDK เวอร์ชัน 4.7.0

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก!
  • รองรับ AppLovin Android SDK เวอร์ชัน 7.4.1
  • รองรับ AppLovin iOS SDK เวอร์ชัน 4.4.1