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

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

อินเทอร์เฟซแดชบอร์ดสำหรับ Maio ใช้ข้อความภาษาญี่ปุ่นสำหรับป้ายกำกับ ปุ่ม และคำอธิบาย และภาพหน้าจอในคู่มือนี้ยังไม่ได้แปล อย่างไรก็ตาม คำอธิบายและวิธีการในคู่มือนี้จะอ้างอิงป้ายกำกับและปุ่มเป็นภาษาอังกฤษ เช่น "URL スキーム" หมายถึง "URL Scheme"

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

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

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

ข้อกำหนด

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

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

ก่อนอื่น ให้ลงชื่อสมัครใช้หรือเข้าสู่ระบบบัญชี Maio คลิกปุ่มการจัดการแอปพลิเคชันในแถบด้านข้างทางซ้าย แล้วคลิกแอปใหม่

เลือกแท็บที่สอดคล้องกับประเภทโฆษณาที่ต้องการ

โฆษณาคั่นระหว่างหน้า

ป้อนชื่อแอป เลือกแพลตฟอร์ม แล้วระบุURL ของแอป เลือกโฆษณาคั่นระหว่างหน้าแบบวิดีโอเป็นประเภทโฆษณา แล้วคลิกอัปเดต

ได้รับรางวัลแล้ว

ป้อนชื่อแอป เลือกแพลตฟอร์ม แล้วระบุURL ของแอป เลือก Video Rewards เป็นประเภทโฆษณา แล้วคลิกอัปเดต

ในหน้าการจัดการแอปพลิเคชัน ให้จดบันทึกรหัสสื่อ คุณต้องตั้งค่าหน่วยโฆษณา AdMob ในส่วนถัดไป

ในหน้าการจัดการโซน ให้จดรหัสโซนไว้ นอกจากนี้ คุณยังต้องใช้รหัสนี้ในการตั้งค่าหน่วยโฆษณา AdMob ในส่วนถัดไปด้วย

(Waterfall เท่านั้น) นอกจากรหัสสื่อและรหัสโซนแล้ว คุณจะต้องมีรหัส API และคีย์ API เพื่อตั้งค่ารหัสหน่วยโฆษณาสําหรับสื่อกลาง ในหน้า Reporting API ให้จดบันทึกรหัส API และคีย์ API

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

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

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

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

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

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

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

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

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

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


เลือกเพิ่มแหล่งที่มาของโฆษณาในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา จากนั้นเลือก maio

เลือก maio แล้วเปิดใช้สวิตช์เพิ่มประสิทธิภาพ ป้อนรหัส API และคีย์ API ที่ได้ในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสําหรับ maiol จากนั้นป้อนมูลค่า eCPM สำหรับ maiol แล้วคลิกต่อไป



หากมีการแมปสำหรับ Magento อยู่แล้ว คุณจะเลือกการแมปนั้นได้ หรือคลิกเพิ่มการแมป

จากนั้นป้อนรหัสสื่อและรหัสโซนที่ได้ในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น


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

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

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

    pod install --repo-update

การผสานรวมด้วยตนเอง

  • ดาวน์โหลด maio SDK เวอร์ชันล่าสุด
  • ดาวน์โหลดอะแดปเตอร์ Maio เวอร์ชันล่าสุดจากลิงก์ดาวน์โหลดในบันทึกการเปลี่ยนแปลง แล้วลิงก์ maioAdapter.framework ในโปรเจ็กต์

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

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ maiO เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

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

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

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

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

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

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

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

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

รูปแบบ ชื่อชั้นเรียน
โฆษณาคั่นระหว่างหน้า GADMMaioInterstitialAdapter
ได้รับรางวัลแล้ว GADMMaioRewardedAdapter

ต่อไปนี้คือรหัสและข้อความที่แสดงโดยอะแดปเตอร์ Maio เมื่อโหลดโฆษณาไม่สําเร็จ

รหัสข้อผิดพลาด เหตุผล
0-10 maio แสดงข้อผิดพลาดเฉพาะ SDK ดูรายละเอียดเพิ่มเติมจากโค้ดของ Maio
101 maio ยังไม่มีโฆษณา
102 พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสตำแหน่งโฆษณา)
103 อะแดปเตอร์ Maio ไม่รองรับรูปแบบโฆษณาที่ขอ
104 โหลดโฆษณาสําหรับการกําหนดค่าเครือข่ายนี้แล้ว

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง iOS ของ maio

เวอร์ชัน 2.1.5.1

  • อัปเดต CFBundleShortVersionString ให้มีคอมโพเนนต์ 3 รายการแทน 4 รายการ

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

  • Google Mobile Ads SDK เวอร์ชัน 11.10.0
  • Maio SDK เวอร์ชัน 2.1.5

เวอร์ชัน 2.1.5.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 11.6.0
  • Maio SDK เวอร์ชัน 2.1.5

เวอร์ชัน 2.1.4.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 11.2.0
  • Maio SDK เวอร์ชัน 2.1.4

เวอร์ชัน 2.1.3.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 11.1.0
  • Maio SDK เวอร์ชัน 2.1.3

เวอร์ชัน 2.1.2.1

  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 11.0 ขึ้นไป
  • รวม Info.plist ไว้ในเฟรมเวิร์กภายใน MaioAdapter.xcframework

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

  • Google Mobile Ads SDK เวอร์ชัน 11.0.1
  • Maio SDK เวอร์ชัน 2.1.2

เวอร์ชัน 2.1.2.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 10.14.0
  • Maio SDK เวอร์ชัน 2.1.2

เวอร์ชัน 2.1.1.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 10.12.0
  • Maio SDK เวอร์ชัน 2.1.1

เวอร์ชัน 2.0.0.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 2.0.0
  • นำการพึ่งพา MaioOB SDK ออกแล้ว
  • นำการรองรับสถาปัตยกรรม armv7 ออก
  • ตอนนี้ต้องใช้ iOS เวอร์ชัน 12.0 เป็นเวอร์ชันขั้นต่ำ
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 10.4.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 10.10.0
  • Maio SDK เวอร์ชัน 2.0.0

เวอร์ชัน 1.6.3.1

  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 10.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 10.0.0
  • Maio SDK เวอร์ชัน 1.6.3
  • MaioOB SDK เวอร์ชัน 2.0.0-alpha

เวอร์ชัน 1.6.3.0

  • อัปเดตอะแดปเตอร์ให้ใช้ didRewardUser API
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.8.0 ขึ้นไป
  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.3 และ maioOB SDK เวอร์ชัน 2.0.0-alpha

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

  • Google Mobile Ads SDK เวอร์ชัน 9.12.0
  • Maio SDK เวอร์ชัน 1.6.3
  • MaioOB SDK เวอร์ชัน 2.0.0-alpha

เวอร์ชัน 1.6.2.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.2 และ maioOB SDK เวอร์ชัน 2.0.0-alpha

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

  • Google Mobile Ads SDK เวอร์ชัน 9.5.0
  • Maio SDK เวอร์ชัน 1.6.2
  • MaioOB SDK เวอร์ชัน 2.0.0-alpha

เวอร์ชัน 1.6.1.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.1 และ maioOB SDK เวอร์ชัน 2.0.0-alpha

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

  • Google Mobile Ads SDK เวอร์ชัน 9.2.0
  • Maio SDK เวอร์ชัน 1.6.1
  • MaioOB SDK เวอร์ชัน 2.0.0-alpha

เวอร์ชัน 1.6.0.1

  • ผ่านการรับรองความเข้ากันได้กับ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.0.0
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 9.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 9.0.0
  • Maio SDK เวอร์ชัน 1.6.0
  • MaioOB SDK เวอร์ชัน 2.0.0-alpha

เวอร์ชัน 1.6.0.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.6.0 และ maioOB SDK เวอร์ชัน 2.0.0-alpha

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

  • Google Mobile Ads SDK เวอร์ชัน 8.13.0
  • ตอนนี้ต้องใช้ iOS เวอร์ชัน 10.0 ขึ้นไป
  • Maio SDK เวอร์ชัน 1.6.0
  • MaioOB SDK เวอร์ชัน 2.0.0-alpha

เวอร์ชัน 1.5.8.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.8 และ maioOB SDK เวอร์ชัน 2.0.0-alpha
  • เพิ่มความสามารถในการเสนอราคาลงในอะแดปเตอร์สําหรับรูปแบบโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัล
  • ลดความจําเป็นในการใช้ Google Mobile Ads SDK เวอร์ชัน 8.0.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 8.7.0
  • Maio SDK เวอร์ชัน 1.5.8
  • MaioOB SDK เวอร์ชัน 2.0.0-alpha

เวอร์ชัน 1.5.6.1

  • เพิ่มรหัสและข้อความแสดงข้อผิดพลาดมาตรฐานสำหรับอะแดปเตอร์
  • อัปเดตอะแดปเตอร์ให้ใช้รูปแบบ .xcframework
  • แก้ไขข้อบกพร่องที่ระบบไม่ส่งต่อเหตุการณ์โฆษณาที่มีการให้รางวัลในบางครั้ง
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 8.3.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 8.3.0
  • Maio SDK เวอร์ชัน 1.5.6

เวอร์ชัน 1.5.6.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.6
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.68.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 7.68.0
  • Maio SDK เวอร์ชัน 1.5.6

เวอร์ชัน 1.5.5.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.5
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.64.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 7.64.0
  • Maio SDK เวอร์ชัน 1.5.5

เวอร์ชัน 1.5.4.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.5.4
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.60.0 ขึ้นไป

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

  • Google Mobile Ads SDK เวอร์ชัน 7.60.0
  • Maio SDK เวอร์ชัน 1.5.4

เวอร์ชัน 1.5.3.1

  • เพื่อจำกัดการหมดเวลา ตอนนี้คำขอโฆษณาจะดำเนินการไม่สำเร็จทันทีหากไม่มีโฆษณาที่พร้อมแสดงใน MAIO
  • ยกเลิกการรองรับสถาปัตยกรรม i386

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

  • Google Mobile Ads SDK เวอร์ชัน 7.58.0
  • Maio SDK เวอร์ชัน 1.5.3

เวอร์ชัน 1.5.3.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 7.55.1
  • Maio SDK เวอร์ชัน 1.5.3

เวอร์ชัน 1.5.2.1

  • แก้ไขปัญหาที่อะแดปเตอร์ไม่ได้เรียกใช้การเรียกกลับ -rewardedAdDidPresent:

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

  • Google Mobile Ads SDK เวอร์ชัน 7.53.1
  • Maio SDK เวอร์ชัน 1.5.2

เวอร์ชัน 1.5.2.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 7.53.1
  • Maio SDK เวอร์ชัน 1.5.2

เวอร์ชัน 1.5.1.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 7.52.0
  • Maio SDK เวอร์ชัน 1.5.1

เวอร์ชัน 1.5.0.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 7.51.0
  • Maio Ads SDK เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.8.0

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

เวอร์ชัน 1.4.6.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.4.6
  • อัปเดตอะแดปเตอร์ให้ใช้ API แบบให้รางวัลใหม่
  • ตอนนี้ต้องใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 7.42.2 ขึ้นไป

เวอร์ชัน 1.4.2.0

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

เวอร์ชัน 1.4.1.0

  • ยืนยันความเข้ากันได้กับ maio SDK เวอร์ชัน 1.4.1
  • แก้ไขปัญหาที่อะแดปเตอร์ Maio อาจไม่ทํางานหากมีการระบุ MediaId หลายรายการจาก AdMob

เวอร์ชัน 1.4.0.0

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

เวอร์ชัน 1.3.2.0

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

เวอร์ชัน 1.3.1.1

  • เพิ่มการเรียกกลับ adapterDidCompletePlayingRewardBasedVideoAd: ลงในอะแดปเตอร์

เวอร์ชัน 1.3.1.0

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

เวอร์ชัน 1.3.0.0

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

เวอร์ชัน 1.2.19.0

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

เวอร์ชัน 1.2.18.0

  • ฉบับแรก
  • เพิ่มการรองรับโฆษณาคั่นระหว่างหน้าและโฆษณาวิดีโอที่มีการให้รางวัล