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

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

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

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

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

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

ข้อกำหนด

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

ขั้นตอนที่ 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 และอะแดปเตอร์

OpenUPM-CLI

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

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

ในตัวแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิด การตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตด้วยตัวเลือก รายละเอียดต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิด ตัวจัดการแพ็กเกจ Unity และ เลือก My Registries จากเมนูแบบเลื่อนลง

รีจิสทรี Unity

เลือกสื่อกลาง AppLovin สำหรับโฆษณาบนอุปกรณ์เคลื่อนที่ของ Google สำหรับ แพ็กเกจ Unity แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

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

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

นำเข้าจาก Unity

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

บังคับแก้ไข

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

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

เนื่องจากปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชัน 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 ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด

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

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

เวอร์ชัน 7.4.0

เวอร์ชัน 7.3.1

เวอร์ชัน 7.3.0

เวอร์ชัน 7.2.2

เวอร์ชัน 7.2.1

เวอร์ชัน 7.2.0

เวอร์ชัน 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

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

เวอร์ชัน 4.1.0

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

เวอร์ชัน 4.0.0

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

เวอร์ชัน 3.1.2

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

เวอร์ชัน 3.1.1

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

เวอร์ชัน 3.1.0

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

เวอร์ชัน 3.0.3

  • รองรับอะแดปเตอร์ Android AppLovin เวอร์ชัน 8.0.2.1
  • รองรับอะแดปเตอร์ iOS ของ AppLovin เวอร์ชัน 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() เพื่อส่งต่อการแจ้งความยินยอมของผู้ใช้ไปยัง 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