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

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

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

Ad Mediation Adapter สำหรับ Moloco มีความสามารถดังนี้

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

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

• GMA Next-Gen SDK เวอร์ชันล่าสุด

• ตั้งค่าสื่อกลาง

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

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

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

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

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

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

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

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

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

ลงชื่อเข้าใช้บัญชี Ad Manager

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ค้นหา SDK โฆษณา Moloco แล้วสลับเป็นเปิดใช้การผสานรวมแอป

คลิกบันทึก

อนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่า เริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสำหรับการเสนอราคา SDK

คลิกบันทึก

กำหนดค่าการเสนอราคา Moloco

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

คลิกผู้เสนอราคารายใหม่

เลือก Moloco Ads เป็นผู้เสนอราคา

คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้

คลิกเสร็จสิ้น

กำหนดค่าการแมปหน่วยโฆษณา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

เลือกบริษัทสำหรับ Moloco Ads SDK

ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่

เลือกหน่วยโฆษณาที่เจาะจง เลือกหน่วยโฆษณาและรูปแบบ แอปบนอุปกรณ์เคลื่อนที่เป็นประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนคีย์แอปและรหัสหน่วยโฆษณาที่ได้จากส่วนก่อนหน้า

สุดท้าย ให้คลิกบันทึก

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

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

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

การผสานรวม Android Studio (แนะนำ)

ในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าการติดตั้งใช้งานต่อไปนี้ ใช้ Moloco SDK และอะแดปเตอร์เวอร์ชันล่าสุด

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:moloco:4.13.0.0")
}

configurations {
    all {
        exclude(group = "com.google.android.gms", module = "play-services-ads")
        exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
    }
}

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

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

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

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

Moloco SDK มีisDoNotSellแฟล็กเพื่อส่งข้อมูลความยินยอมไปยัง Moloco SDK

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Moloco SDK หากเลือกตั้งค่าแฟล็กเหล่านี้ เราขอแนะนำให้ดำเนินการก่อนที่จะขอโฆษณาผ่าน GMA Next-Gen SDK

val privacySettings = PrivacySettings(isDoNotSell = true)
MolocoPrivacy.setPrivacy(privacySettings)
MolocoMediationSnippets.kt

PrivacySettings privacySettings =
    new PrivacySettings(
        /* isUserConsent= */ false, /* isAgeRestrictedUser= */ false, /* isDoNotSell= */ true);
MolocoPrivacy.setPrivacy(privacySettings);
MolocoMediationSnippets.java

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบเกี่ยวกับ Moloco SDK สำหรับ Android

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

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

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

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

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

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

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

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

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

บันทึกการเปลี่ยนแปลงของ Moloco Android Mediation Adapter

เวอร์ชัน 4.13.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.13.0 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.5.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.5.0
• Moloco SDK เวอร์ชัน 4.13.0

เวอร์ชัน 4.12.0.1

• ปักหมุดทรัพยากร Dependency ของ Kotlin ของอะแดปเตอร์เป็น 1.9.0 (เวอร์ชัน Kotlin ขั้นต่ำที่ GMA NextGen SDK รองรับ)

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• Moloco SDK เวอร์ชัน 4.12.0

เวอร์ชัน 4.12.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.12.0

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.4.0
• Moloco SDK เวอร์ชัน 4.12.0

เวอร์ชัน 4.11.1.0

• อัปเดตเพื่อรายงานการแสดงโฆษณาเมื่อโฆษณาเนทีฟแสดง
• โฆษณาแบนเนอร์แบบคงที่เพื่อเรียกใช้onAdOpenedการเรียกกลับเมื่อคลิกแทนที่จะแสดง
• ยืนยันความเข้ากันได้กับ Moloco SDK 4.11.1

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.3.1
• Moloco SDK เวอร์ชัน 4.11.1

เวอร์ชัน 4.11.0.0

• เพิ่มการรองรับแบนเนอร์แบบปรับขนาดได้ลงในอะแดปเตอร์สื่อกลาง Moloco
• ยืนยันความเข้ากันได้กับ Moloco SDK 4.11.0 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.3.1
• Moloco SDK เวอร์ชัน 4.11.0

เวอร์ชัน 4.10.1.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.10.1 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
• Moloco SDK เวอร์ชัน 4.10.1

เวอร์ชัน 4.10.0.0

• Maps AgeRestrictedTreatment to Moloco's age restricted settings.
• ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 4.10.0 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.4.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.2.1
• Moloco SDK เวอร์ชัน 4.10.0

เวอร์ชัน 4.9.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.9.0 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.3.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.1.1
• Moloco SDK เวอร์ชัน 4.9.0

เวอร์ชัน 4.9.0.0 (กำลังดำเนินการ)

เวอร์ชัน 4.8.1.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.8.1

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 25.2.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 1.0.1
• Moloco SDK เวอร์ชัน 4.8.1

เวอร์ชัน 4.8.0.0

• อัปเดตเพื่อส่งบริบทของแอปพลิเคชันไปยัง Moloco.initialize() แทนบริบทของกิจกรรมเพื่อหลีกเลี่ยงหน่วยความจำรั่วไหล
• ยืนยันความเข้ากันได้กับ Moloco SDK 4.8.0 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.2.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 0.25.0-beta01
• Moloco SDK เวอร์ชัน 4.8.0

เวอร์ชัน 4.7.0.0

• เพิ่มพร็อพเพอร์ตี้เพื่อสร้างอะแดปเตอร์ที่มีทรัพยากร Dependency ของ GMA Next-Gen SDK
• ยืนยันความเข้ากันได้กับ Moloco SDK 4.7.0 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 25.1.0
• Google Mobile Ads Next-Gen SDK เวอร์ชัน 0.25.0-beta01
• Moloco SDK เวอร์ชัน 4.7.0

เวอร์ชัน 4.6.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.6.0 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• Moloco SDK เวอร์ชัน 4.6.0

เวอร์ชัน 4.5.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.5.0 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• Moloco SDK เวอร์ชัน 4.5.0

เวอร์ชัน 4.4.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.4.0 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.9.0
• Moloco SDK เวอร์ชัน 4.4.0

เวอร์ชัน 4.3.1.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.3.1

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.8.0
• Moloco SDK เวอร์ชัน 4.3.1

เวอร์ชัน 4.2.1.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.2.1

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• Moloco SDK เวอร์ชัน 4.2.1

เวอร์ชัน 4.2.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.2.0

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• Moloco SDK เวอร์ชัน 4.2.0

เวอร์ชัน 4.1.1.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.1.1 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 24.7.0
• Moloco SDK เวอร์ชัน 4.1.1

เวอร์ชัน 4.1.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.1.0 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.6.0
• Moloco SDK เวอร์ชัน 4.1.0

เวอร์ชัน 4.0.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 4.0.0 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.5.0
• Moloco SDK เวอร์ชัน 4.0.0

เวอร์ชัน 3.12.1.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.12.1

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 24.5.0
• Moloco SDK เวอร์ชัน 3.12.1

เวอร์ชัน 3.12.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.12.0 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• Moloco SDK เวอร์ชัน 3.12.0

เวอร์ชัน 3.11.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ Moloco SDK 3.11.0 ได้

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• Moloco SDK เวอร์ชัน 3.11.0

เวอร์ชัน 3.10.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.10.0 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.3.0
• SDK ของ Moloco เวอร์ชัน 3.10.0

เวอร์ชัน 3.9.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.9.0

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.2.0
• SDK ของ Moloco เวอร์ชัน 3.9.0

เวอร์ชัน 3.8.0.1

• เพิ่มการรองรับขนาดโฆษณาแบนเนอร์สี่เหลี่ยมผืนผ้ากลาง

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.1.0
• SDK ของ Moloco เวอร์ชัน 3.8.0

เวอร์ชัน 3.8.0.0

• เพิ่มการรองรับการเสนอราคาสําหรับรูปแบบโฆษณาเนทีฟ
• ยืนยันความเข้ากันได้กับ Moloco SDK 3.8.0

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.1.0
• Moloco SDK เวอร์ชัน 3.8.0

เวอร์ชัน 3.7.2.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.7.2 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.0.0
• Moloco SDK เวอร์ชัน 3.7.2

เวอร์ชัน 3.7.1.0

• อัปเดตระดับ API ของ Android ขั้นต่ำที่จำเป็นเป็น 23
• อัปเดตเวอร์ชันขั้นต่ำที่กำหนดของ Google Mobile Ads SDK เป็น 24.0.0
• ยืนยันความเข้ากันได้กับ Moloco SDK 3.7.1 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 24.0.0
• Moloco SDK เวอร์ชัน 3.7.1

เวอร์ชัน 3.7.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.7.0 แล้ว

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 23.6.0
• Moloco SDK เวอร์ชัน 3.7.0

เวอร์ชัน 3.6.1.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.6.1 แล้ว

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 23.6.0
• Moloco SDK เวอร์ชัน 3.6.1

เวอร์ชัน 3.6.0.0

• ยืนยันความเข้ากันได้กับ Moloco SDK 3.6.0

สร้างและทดสอบด้วย:

• Google Mobile Ads SDK เวอร์ชัน 23.6.0
• SDK ของ Moloco เวอร์ชัน 3.6.0

เวอร์ชัน 3.5.0.0

• การเผยแพร่ครั้งแรก
• เพิ่มการรองรับการเสนอราคาสําหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล
• ได้รับการยืนยันว่าใช้งานร่วมกับ Moloco SDK 3.5.0 ได้

สร้างขึ้นและทดสอบกับ

• Google Mobile Ads SDK เวอร์ชัน 23.6.0
• Moloco SDK เวอร์ชัน 3.5.0