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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลาง SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google Moloco Ads สำหรับ 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

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

รีจิสทรีของ 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: ทดสอบการติดตั้งใช้งาน

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

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

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

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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.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