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

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

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

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

ข้อกำหนด

• API ระดับ 23 ขึ้นไปของ Android

• Moloco Adapter 3.8.0.0 ขึ้นไป

• Google Mobile Ads SDK เวอร์ชันล่าสุด

• ทำตามคู่มือเริ่มต้นใช้งานสื่อกลางให้เสร็จสมบูรณ์

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

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

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

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

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

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

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

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

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

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

คุณต้องเพิ่ม Moloco Ads SDK ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

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

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

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

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่ม SDK โฆษณา Moloco เป็นแหล่งที่มาของโฆษณา

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:moloco:3.12.1.0")
}

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

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

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

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

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Moloco SDK หากเลือกตั้งค่าสถานะเหล่านี้ ขอแนะนําให้ทําเช่นนั้นก่อน ที่จะขอโฆษณาผ่าน Google Mobile Ads SDK

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

val privacySettings = PrivacySettings(isUserConsent = true)
MolocoPrivacy.setPrivacy(privacySettings)

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         true,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           false);
MolocoPrivacy.setPrivacy(privacySettings);

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

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

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

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

โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Moloco SDK หากเลือกตั้งค่าสถานะเหล่านี้ ขอแนะนําให้ทําเช่นนั้นก่อน ที่จะขอโฆษณาผ่าน Google Mobile Ads SDK

import com.moloco.sdk.publisher.privacy.MolocoPrivacy
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings
// ...

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

import com.moloco.sdk.publisher.privacy.MolocoPrivacy;
import com.moloco.sdk.publisher.privacy.MolocoPrivacy.PrivacySettings;
// ...

// Moloco does not support setting one flag at a time in Java.
PrivacySettings privacySettings = new PrivacySettings(
    /* isUserConsent */         false,
    /* isAgeRestrictedUser */   false,
    /* isDoNotSell */           true);
MolocoPrivacy.setPrivacy(privacySettings);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 24.3.0
• Moloco SDK เวอร์ชัน 3.10.0

เวอร์ชัน 3.9.0.0

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

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

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

เวอร์ชัน 3.8.0.1

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

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

• Google Mobile Ads SDK เวอร์ชัน 24.1.0
• Moloco SDK เวอร์ชัน 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
• Moloco SDK เวอร์ชัน 3.6.0

เวอร์ชัน 3.5.0.0

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

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

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