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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter

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

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

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

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

ข้อกำหนด

  • ปลั๊กอิน Unity สำหรับโฆษณา Google Mobile ล่าสุด
  • Unity 5.6 ขึ้นไป
  • ปลั๊กอิน Moloco Unity 1.2.0 ขึ้นไป
  • หากต้องการติดตั้งใช้งานใน Android
    • API ระดับ 23 ขึ้นไปของ Android
  • หากต้องการติดตั้งใช้งานใน iOS
    • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
  • โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วยปลั๊กอิน Unity สำหรับโฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดได้ที่เริ่มต้นใช้งาน
  • ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

ขั้นตอนที่ 1: ตั้งค่าใน UI ของ Moloco

เข้าสู่ระบบพอร์ทัลผู้เผยแพร่โฆษณาของ Moloco

ไปที่แท็บภาพรวม > แอป แล้วคลิกปุ่มเพิ่มแอปเพื่อ สร้างแอปใหม่

เลือกการตั้งค่าระบบปฏิบัติการและการตั้งค่าความเป็นส่วนตัวสำหรับแอป กรอกข้อมูลที่เหลือใน แบบฟอร์ม แล้วคลิกสร้าง

Android

iOS

เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแท็บแอปเพื่อดูรายละเอียด และจดคีย์แอปไว้

Android

iOS

ไปที่แท็บภาพรวม > หน่วยโฆษณา เลือกแอปจาก เมนูแบบเลื่อนลง แล้วคลิกหน่วยโฆษณาใหม่

เลือกการเสนอราคาในแอปเป็นวิธีการประมูล แล้วกรอกข้อมูลที่เหลือใน แบบฟอร์ม จากนั้นคลิกสร้าง

ไปที่หน่วยโฆษณาที่สร้างขึ้นใหม่ในแท็บหน่วยโฆษณาเพื่อดูรายละเอียด จดรหัสหน่วยโฆษณา

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

รายละเอียด OpenUPM

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

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

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

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Moloco Ads SDK เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดใน บันทึกการเปลี่ยนแปลง และแตกไฟล์ GoogleMobileAdsMolocoMediation.unitypackage จากไฟล์ ZIP

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

นำเข้าจาก Unity

จากนั้นเลือกAssets > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ปัญหา Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับปิด

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

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

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

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

ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob แล้ว

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

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

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

หากอแดปเตอร์ไม่ได้รับโฆษณาจาก Moloco ผู้เผยแพร่โฆษณาสามารถตรวจสอบ ข้อผิดพลาดพื้นฐานจากคำตอบของโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้

Android

com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter

iOS

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

Android

รหัสข้อผิดพลาด โดเมน เหตุผล
101 com.google.ads.mediation.moloco ไม่มีคีย์แอป Moloco หรือคีย์แอป Moloco ไม่ถูกต้อง
102 com.google.ads.mediation.moloco ไม่มีรหัสหน่วยโฆษณา Moloco หรือรหัสไม่ถูกต้อง
103 com.google.ads.mediation.moloco ออบเจ็กต์โฆษณา Moloco ที่แสดงผลเป็น Null
-1 ถึง 5000 com.moloco.sdk SDK ของ Moloco แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco

iOS

รหัสข้อผิดพลาด โดเมน เหตุผล
101 com.google.ads.mediation.moloco SDK ของ Moloco ไม่รองรับการแสดงโฆษณาใน iOS 12 และเวอร์ชันที่ต่ำกว่า
102 com.google.ads.mediation.moloco ไม่มีคีย์แอป Moloco หรือคีย์แอป Moloco ไม่ถูกต้อง
103 com.google.ads.mediation.moloco ไม่มีรหัสหน่วยโฆษณา Moloco หรือรหัสไม่ถูกต้อง
104 com.google.ads.mediation.moloco โฆษณายังไม่พร้อมแสดง
105 com.google.ads.mediation.moloco โฆษณาแสดงไม่สำเร็จ
106 com.google.ads.mediation.moloco ไม่มีข้อมูลการแสดงผลที่จะแสดงโฆษณา
-1 ถึง 5000 ส่งโดย Moloco SDK SDK ของ Moloco แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco

การยืนยันฝั่งเซิร์ฟเวอร์สำหรับโฆษณาที่มีการให้รางวัล

หากคุณตรวจสอบความถูกต้องของการเรียกกลับของการยืนยันฝั่งเซิร์ฟเวอร์ (SSV) ตัวระบุแหล่งที่มาของโฆษณาสำหรับ Moloco คือ 8267622065755668722

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

เวอร์ชัน 2.2.0

เวอร์ชัน 2.1.0

เวอร์ชัน 2.0.0

เวอร์ชัน 1.6.1

เวอร์ชัน 1.6.0

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.1

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.1

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0