ผสานรวม Liftoff สร้างรายได้ด้วยสื่อกลาง

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

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

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

1 การเสนอราคา การผสานรวมสำหรับรูปแบบนี้อยู่ในรุ่นเบต้าแบบปิด

2 การเสนอราคา สำหรับรูปแบบนี้อยู่ในเวอร์ชันเบต้าแบบเปิด

3 การแสดงวิดีโอตามลำดับขั้น การผสานรวมสำหรับรูปแบบนี้อยู่ในรุ่นเบต้าแบบปิด

ข้อกำหนด

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

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

ขั้นตอนที่ 2: ตั้งค่า Liftoff Monetize ใน AdMob UI

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif

ดูวิธีการนำไปใช้ที่ GDPR แนะนำสำหรับ Android และ iOS สำหรับรายละเอียดเพิ่มเติม และค่าที่ระบุไว้ในเมธอด

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

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

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

using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...

LiftoffMonetize.SetCCPAStatus(true);

ดูคำแนะนำในการใช้งาน CCPA ที่แนะนำสำหรับ Android และ iOS สำหรับรายละเอียดเพิ่มเติม และ ค่าที่ระบุในเมธอดได้

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

Android

รูปแบบ ชื่อชั้นเรียน
โฆษณาเปิดแอป (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
โฆษณาเปิดแอป (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter
แบนเนอร์ (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
แบนเนอร์ (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
โฆษณาคั่นระหว่างหน้า (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
โฆษณาคั่นระหว่างหน้า (Waterfall) com.vungle.mediation.VungleInterstitialAdapter
มีการให้รางวัล (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
มีการให้รางวัล (Waterfall) com.vungle.mediation.VungleAdapter
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) com.google.ads.mediation.vungle.VungleMediationAdapter
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (Waterfall) com.google.ads.mediation.vungle.VungleMediationAdapter

iOS

รูปแบบ ชื่อชั้นเรียน
การเปิดแอป (การเสนอราคา) GADMediationAdapterVungle
โฆษณาเปิดแอป (Waterfall) GADMediationAdapterVungle
แบนเนอร์ (การเสนอราคา) GADMediationAdapterVungle
แบนเนอร์ (Waterfall) GADMAdapterVungleInterstitial
โฆษณาคั่นระหว่างหน้า (การเสนอราคา) GADMediationAdapterVungle
โฆษณาคั่นระหว่างหน้า (Waterfall) GADMAdapterVungleInterstitial
ให้รางวัล (การเสนอราคา) GADMediationAdapterVungle
มีการให้รางวัล (Waterfall) GADMAdapterVungleRewardBasedVideoAd
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (การเสนอราคา) GADMediationAdapterVungle
โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล (Waterfall) GADMediationAdapterVungle

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

Android

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น รหัสแอปหรือรหัสตำแหน่ง)
102 ขนาดแบนเนอร์ที่ขอไม่ตรงกับขนาดโฆษณา Liftoff Monetize ที่ถูกต้อง
103 Liftoff Monetize ต้องใช้บริบท Activity ในการส่งคำขอ ทั้งหมด
104 Vungle SDK ไม่สามารถโหลดโฆษณาหลายรายการสำหรับตำแหน่งเดียวกัน ID
105 เริ่มต้น Vungle SDK ไม่สำเร็จ
106 Vungle SDK แสดงการเรียกกลับการโหลดที่สำเร็จ แต่ Banners.getBanner() หรือ Vungle.getNativeAd() แสดงผลลัพธ์เป็น Null
107 Vungle SDK ไม่พร้อมที่จะเล่นโฆษณา
108 Vungle SDK แสดงผลโทเค็นการเสนอราคาที่ไม่ถูกต้อง

iOS

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น รหัสแอปหรือรหัสตำแหน่ง)
102 โหลดโฆษณาสำหรับการกำหนดค่าเครือข่ายนี้แล้ว Vungle SDK ไม่สามารถโหลดโฆษณาที่ 2 สำหรับรหัสตำแหน่งเดียวกัน
103 ขนาดโฆษณาที่ขอไม่ตรงกับ Liftoff Monetize ที่รองรับ ขนาดแบนเนอร์
104 Vungle SDK แสดงผลโฆษณาแบนเนอร์ไม่ได้
105 Vungle SDK รองรับการโหลดโฆษณาแบนเนอร์ครั้งละ 1 รายการเท่านั้น โดยไม่คำนึงถึง รหัสตำแหน่ง
106 Vungle SDK ส่งการเรียกกลับที่ระบุว่าเล่นโฆษณาไม่ได้
107 Vungle SDK ไม่พร้อมที่จะเล่นโฆษณา

สำหรับข้อผิดพลาดที่มาจาก Vungle SDK โปรดดูรหัสข้อผิดพลาด: Vungle SDK สำหรับ iOS และ Android

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

เวอร์ชัน 5.2.1

เวอร์ชัน 5.2.0

เวอร์ชัน 5.1.1

เวอร์ชัน 5.1.0

  • แก้ไข NullPointerException ที่ทำให้การบิลด์ไม่สำเร็จเมื่อส่งออกเป็นโปรเจ็กต์ Android
  • อัปเดต Privacy API ดังนี้
    • นำวิธีการ UpdateConsentStatus() และ UpdateCCPAStatus() ออก
    • นำ Enum VungleConsentStatus และ VungleCCPAStatus ออกแล้ว
    • อัปเดตวิธีการ SetGDPRStatus(bool) เป็น SetGDPRStatus(bool, String) แล้ว
  • นำเมธอดต่อไปนี้ออกจากคลาส LiftoffMonetizeMediationExtras
    • SetAllPlacements(String[])
    • SetSoundEnabled(bool)
  • รองรับอะแดปเตอร์ Liftoff Monetize Android เวอร์ชัน 7.3.1.0
  • รองรับอะแดปเตอร์สำหรับ iOS ของ Liftoff Monetize เวอร์ชัน 7.3.1.0
  • สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0

เวอร์ชัน 5.0.0

เวอร์ชัน 4.0.0

เวอร์ชัน 3.9.2

เวอร์ชัน 3.9.1

เวอร์ชัน 3.9.0

เวอร์ชัน 3.8.2

เวอร์ชัน 3.8.1

เวอร์ชัน 3.8.0

เวอร์ชัน 3.7.5

เวอร์ชัน 3.7.4

เวอร์ชัน 3.7.3

เวอร์ชัน 3.7.2

เวอร์ชัน 3.7.1

เวอร์ชัน 3.7.0

เวอร์ชัน 3.6.0

เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.0

เวอร์ชัน 3.4.1

เวอร์ชัน 3.4.0

เวอร์ชัน 3.3.1

เวอร์ชัน 3.3.0

เวอร์ชัน 3.2.0

เวอร์ชัน 3.1.4

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 6.3.24.1
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.3.2.3

เวอร์ชัน 3.1.3

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 6.3.24.1
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.3.2.2

เวอร์ชัน 3.1.2

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

เวอร์ชัน 3.1.1

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 6.3.24.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.3.2.0
  • อัปเดตเมธอด Vungle.UpdateConsentStatus() เพื่อทำให้พารามิเตอร์ consentMessageVersion เป็นพารามิเตอร์ที่ไม่บังคับ ตอนนี้ระบบจะไม่สนใจค่า consentMessageVersion สำหรับ iOS
  • เลิกใช้งาน Vungle.GetCurrentConsentMessageVersion() สำหรับ iOS แล้ว

เวอร์ชัน 3.1.0

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 6.3.17.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.3.0.0
  • อัปเดตเมธอด Vungle.UpdateConsentStatus() เพื่อรับพารามิเตอร์ String เพิ่มเติมสำหรับเวอร์ชันข้อความขอความยินยอมที่ได้จากผู้เผยแพร่โฆษณา
  • เพิ่มเมธอด Vungle.GetCurrentConsentMessageVersion() เพื่อรับเวอร์ชันข้อความขอความยินยอมที่ได้จากผู้เผยแพร่โฆษณา

เวอร์ชัน 3.0.1

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 6.2.5.1
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.2.0.3

เวอร์ชัน 3.0.0

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 6.2.5.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 6.2.0.2
  • เพิ่มวิธีการต่อไปนี้
    • Vungle.UpdateConsentStatus() เพื่อตั้งค่าสถานะความยินยอมที่จะบันทึกใน Vungle SDK
    • Vungle.GetCurrentConsentStatus() เพื่อดูสถานะความยินยอมปัจจุบันของผู้ใช้

เวอร์ชัน 2.0.0

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

เวอร์ชัน 1.1.0

  • รองรับอะแดปเตอร์ Android เวอร์ชัน 5.3.2.1
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.4.0.0

เวอร์ชัน 1.0.0

  • เปิดตัวครั้งแรก
  • รองรับอะแดปเตอร์ Android เวอร์ชัน 5.3.0.0
  • รองรับอะแดปเตอร์ iOS เวอร์ชัน 5.3.0.0