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

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

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

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

ข้อกำหนด

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

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

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

เพิ่มแอปลงในแดชบอร์ดการสร้างรายได้ของ Liftoff โดยคลิกปุ่มเพิ่มแอปพลิเคชัน

กรอกแบบฟอร์มโดยใส่รายละเอียดที่จำเป็นทั้งหมด

Android

iOS

เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแดชบอร์ดแอปพลิเคชัน Liftoff Monetize

Android

iOS

จดบันทึกรหัสแอป

Android

iOS

เพิ่มตําแหน่งใหม่

หากต้องการสร้างตําแหน่งใหม่เพื่อใช้กับสื่อกลาง AdMob ให้ไปที่แดชบอร์ดตําแหน่งการสร้างรายได้ของ Liftoff คลิกปุ่มเพิ่มตําแหน่ง แล้วเลือกแอปจากรายการแบบเลื่อนลง

รายละเอียดในการเพิ่มตําแหน่งใหม่มีดังนี้

การเปิดแอป

เลือกโฆษณาคั่นระหว่างหน้า แล้วป้อนชื่อตำแหน่งโฆษณา จากนั้นเลือกใช่สำหรับข้ามได้ แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

เลือกแบนเนอร์ ป้อนชื่อตําแหน่ง แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

แบนเนอร์ 300x250

เลือก MREC ป้อนชื่อตำแหน่งโฆษณา แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

โฆษณาคั่นระหว่างหน้า

เลือกโฆษณาคั่นระหว่างหน้า ป้อนชื่อตำแหน่งโฆษณา แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

ได้รับรางวัลแล้ว

เลือกมีการให้รางวัล ป้อนชื่อตําแหน่ง แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

เลือกมีการให้รางวัล ป้อนชื่อตำแหน่งโฆษณา เปิดใช้ข้ามได้ แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับการเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

เนทีฟ

เลือกเนทีฟ ป้อนชื่อตำแหน่ง แล้วกรอกข้อมูลที่เหลือในแบบฟอร์ม [การเสนอราคาเท่านั้น] ในส่วนการสร้างรายได้ ให้สลับสวิตช์การเสนอราคาในแอปเป็นเปิดใช้ คลิกปุ่มต่อไปที่ด้านล่างของหน้าเพื่อสร้างตําแหน่งโฆษณา

จดรหัสอ้างอิงไว้ แล้วคลิกตกลง

การเปิดแอป

แบนเนอร์ 300x250

โฆษณาคั่นระหว่างหน้า

ได้รับรางวัลแล้ว

โฆษณาคั่นระหว่างหน้าที่มีการให้รางวัล

เนทีฟ

ค้นหาคีย์ Reporting API

การเสนอราคา

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

น้ำตก

นอกจากรหัสแอปและรหัสอ้างอิงแล้ว คุณจะต้องมีคีย์ Reporting API ของ Liftoff Monetize เพื่อตั้งค่ารหัสหน่วยโฆษณา AdMob ด้วย ไปที่แดชบอร์ดรายงานของ Liftoff Monetize แล้วคลิกปุ่มคีย์ Reporting API เพื่อดูคีย์ Reporting API

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

หากต้องการเปิดใช้โฆษณาทดสอบ ให้ไปที่แดชบอร์ด Liftoff Monetize แล้วไปที่แอปพลิเคชัน

เลือกแอปที่ต้องการเปิดใช้โฆษณาทดสอบในส่วนรหัสอ้างอิงตําแหน่งโฆษณาของแอป คุณสามารถเปิดใช้โฆษณาทดสอบได้โดยเลือกโหมดทดสอบเป็นแสดงโฆษณาทดสอบเท่านั้นในส่วนสถานะ

Android

iOS

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

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

Android

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

iOS

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

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

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

ขั้นตอนที่ 3: นําเข้า Vungle SDK และอะแดปเตอร์การสร้างรายได้ของ Liftoff

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลางเพื่อการสร้างรายได้ของ Liftoff สำหรับ Unity ของ Google Ads ลงในโปรเจ็กต์ได้โดยเรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรีรูทของโปรเจ็กต์

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

OpenUPM

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

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

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

รายละเอียด OpenUPM

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

รีจิสทรีของ Unity

เลือกแพ็กเกจ Google Mobile Ads LiftoffMonetize Mediation แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณา Google Mobile เวอร์ชันล่าสุดสําหรับ Liftoff Monetize จากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsLiftoffMonetizeMediation.unitypackage จากไฟล์ ZIP

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

นำเข้าจาก Unity

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

บังคับแก้ไข

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

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

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สําหรับ 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 และเปิดใช้โหมดทดสอบใน UI การสร้างรายได้ของ Liftoff