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

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

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ ให้ตรวจสอบสิ่งต่อไปนี้

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

    • ขั้นตอนที่ 1: ตั้งค่าการกำหนดค่าใน UI ของ Moloco Ads SDK โฆษณา

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

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

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

    Android

    iOS

    เมื่อสร้างแอปแล้ว ให้เลือกแอปจากแท็บ Apps เพื่อดูรายละเอียดและจดบันทึก App Key

    Android

    iOS

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

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

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

    ขั้นตอนที่ 2: ตั้งค่าดีมานด์ SDK โฆษณา 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 โฆษณา Moloco สำหรับ Google Mobile Ads ใน Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีรากของโปรเจ็กต์

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

    OpenUPM

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

    ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็น Scoped Registry โดยระบุรายละเอียดต่อไปนี้

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

    รายละเอียด OpenUPM

    จากนั้นไปที่ Window > Package Manager เพื่อเปิด Unity Package Manager แล้วเลือกMy Registries จากเมนูแบบเลื่อนลง

    Unity Registry

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

    ติดตั้งจาก OpenUPM

    แพ็กเกจ Unity

    ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Moloco 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 SDK

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

    อะแดปเตอร์ Unity ของ Moloco Ads SDK เวอร์ชัน 1.0.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง Moloco Ads SDK ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ MolocoPrivacy สำหรับ Android และสตริงความยินยอมของ TCF สำหรับ iOS

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

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

    ปลั๊กอินสื่อกลาง Unity ของ Google Mobile Ads สำหรับ Moloco Ads SDK โฆษณา มีเมธอด Moloco.SetDoNotSell(bool) เพื่อส่งข้อมูลความยินยอมไปยัง Moloco Ads SDK โฆษณา โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง Moloco Ads SDK หากเลือกตั้งค่าแฟล็กเหล่านี้ เราขอแนะนำให้ตั้งค่าก่อนที่จะขอโฆษณาผ่าน Google Mobile Ads Unity Plugin

    using GoogleMobileAds.Api.Mediation.Moloco;
// ...

Moloco.SetDoNotSell(true);

    ดูรายละเอียดเพิ่มเติมได้ที่วิธีการติดตั้งใช้งานที่แนะนำของ Moloco Ads SDK โฆษณา สำหรับ Android และ iOS

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

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

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

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

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

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

    หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Moloco 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 Moloco SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco

    iOS

    รหัสข้อผิดพลาด โดเมน เหตุผล
    101 com.google.ads.mediation.moloco Moloco SDK ไม่รองรับการแสดงโฆษณาใน 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 Moloco SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Moloco

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

    เวอร์ชัน 3.11.0 (อยู่ระหว่างดำเนินการ)

    เวอร์ชัน 3.10.1

    เวอร์ชัน 3.10.0

    เวอร์ชัน 3.9.1

    เวอร์ชัน 3.9.0

    เวอร์ชัน 3.8.1

    เวอร์ชัน 3.8.0

    เวอร์ชัน 3.7.0

    เวอร์ชัน 3.6.1

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

    เวอร์ชัน 3.0.0

    เวอร์ชัน 2.2.1

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