ผสานรวม Moloco กับการเสนอราคา

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

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

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

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

ข้อกำหนด

  • เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป

  • Moloco adapter 3.9.1.0 ขึ้นไป

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

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

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

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

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

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

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

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

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

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

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

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

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

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

คลิกบันทึก

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

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

คลิกบันทึก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • เพิ่มบรรทัดต่อไปนี้ลงใน Podfile ของโปรเจ็กต์

    pod 'GoogleMobileAdsMediationMoloco'

  • จากบรรทัดคำสั่ง ให้เรียกใช้คำสั่งต่อไปนี้

    pod install --repo-update

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

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

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

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

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setHasUserConsent:YES];

ดูข้อมูลเพิ่มเติมได้ที่ เอกสารประกอบด้านความเป็นส่วนตัวของ Moloco

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

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

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

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

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

ดูข้อมูลเพิ่มเติมได้ที่ เอกสารประกอบด้านความเป็นส่วนตัวของ Moloco

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

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

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

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

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

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

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

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

รหัสข้อผิดพลาด โดเมน เหตุผล
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

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

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

  • รวม Info.plist ภายในเฟรมเวิร์ก

เวอร์ชัน 3.12.1.0

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

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

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

เวอร์ชัน 3.12.0.0

  • ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 3.12.0

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

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

เวอร์ชัน 3.11.0.0

  • ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 3.11.0

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

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

เวอร์ชัน 3.10.1.0

  • ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 3.10.1

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

  • Google Mobile Ads SDK เวอร์ชัน 12.6.0
  • Moloco SDK เวอร์ชัน 3.10.1

เวอร์ชัน 3.10.0.0

  • ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 3.10.0

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

  • Google Mobile Ads SDK เวอร์ชัน 12.5.0
  • Moloco SDK เวอร์ชัน 3.10.0

เวอร์ชัน 3.9.1.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 12.3.0
  • Moloco SDK เวอร์ชัน 3.9.1

เวอร์ชัน 3.9.0.0

  • ตอนนี้ระบบจะตั้งชื่อแพลตฟอร์มสื่อกลางเมื่อเริ่มต้น Moloco SDK
  • ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 3.9.0

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

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

เวอร์ชัน 3.8.0.0

  • เปิดใช้ธง -fobjc-arc และ -fstack-protector-all
  • แก้ไขปัญหาเกี่ยวกับการได้รับการให้ดาวสำหรับโฆษณาเนทีฟ
  • ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 3.8.0

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

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

เวอร์ชัน 3.7.2.0

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

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

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

เวอร์ชัน 3.7.1.0

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

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

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

เวอร์ชัน 3.7.0.0

  • ยืนยันความเข้ากันได้กับ Moloco SDK เวอร์ชัน 3.7.0

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

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

เวอร์ชัน 3.6.0.1

  • อัปเดตอแดปเตอร์เพื่อดึงข้อมูลเวอร์ชัน Moloco SDK จากเทรดหลัก
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 12.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 12.0.0
  • Moloco SDK เวอร์ชัน 3.6.0

เวอร์ชัน 3.6.0.0

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

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

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

เวอร์ชัน 3.5.0.0

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

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

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