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

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

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

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

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

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

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

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

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

เข้าสู่ระบบบัญชี myTarget ไปที่หน้าแอป โดยคลิกแอปในส่วนหัว เพิ่มแอปโดยคลิกเพิ่มแอป

หากแอปของคุณรองรับทั้งแพลตฟอร์ม Android และ iOS คุณต้องตั้งค่าแต่ละแพลตฟอร์มแยกกัน

Android

จากนั้นระบุ URL ของ Google Play สำหรับแอป

iOS

จากนั้นระบุ URL ของ iTunes** สำหรับแอป

เมื่อเพิ่มแอป myTarget จะกำหนดให้คุณสร้างหน่วยโฆษณาก่อนจึงจะทำกระบวนการให้เสร็จสมบูรณ์ได้

เลือกแบนเนอร์จากรูปแบบโฆษณาที่มี แล้วคลิกปุ่มเพิ่มหน่วยโฆษณา

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

เลือก INTERSTITIAL จากรูปแบบโฆษณาที่มี แล้วคลิกปุ่ม เพิ่มหน่วยโฆษณา

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

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

เนทีฟ

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

ในหน้ารายละเอียดของหน่วยโฆษณา ให้จดรหัสช่องซึ่งอยู่ใต้การตั้งค่าหน่วยโฆษณาเป็น slot_id ระบบจะใช้รหัสช่องนี้เพื่อตั้งค่า หน่วยโฆษณา AdMob ในส่วนถัดไป

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

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขายพื้นที่โฆษณาแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ทำ ให้สร้างไฟล์ app-ads.txt สำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับ myTarget โปรดดูวิธีสร้างและเผยแพร่ไฟล์

เปิดโหมดทดสอบ

ทําตามวิธีการใน เอกสารประกอบของ myTarget เพื่อเพิ่มและกําหนดค่าอุปกรณ์ทดสอบใน UI ของ myTarget

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

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

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

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

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

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

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้พร้อมกับ SDK และอะแดปเตอร์ myTarget เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_mytarget: ^1.14.1

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

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ myTarget เวอร์ชันล่าสุด แตกไฟล์ที่ดาวน์โหลดมา แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_mytarget:
    path: path/to/local/package

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

ดูวิธีการได้ที่ขั้นตอนที่ 4 ในคู่มือสำหรับ Android และ iOS

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน UI ของ myTarget

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

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

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

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

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

Android

รหัสข้อผิดพลาด เหตุผล
100 myTarget SDK แสดงข้อผิดพลาด
101 พารามิเตอร์เซิร์ฟเวอร์ myTarget ที่กำหนดค่าไว้ใน UI ของ AdMob ขาดหายไป/ไม่ถูกต้อง
102 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ myTarget รองรับ
103 คำขอโฆษณาไม่ใช่คำขอโฆษณาเนทีฟแบบรวม
104 โฆษณาเนทีฟที่โหลดจาก myTarget แตกต่างจากโฆษณาเนทีฟที่ขอ
105 โฆษณาเนทีฟที่โหลดจาก myTarget ไม่มีชิ้นงานที่จำเป็นบางรายการ (เช่น รูปภาพหรือไอคอน)
106 myTarget SDK แสดงโฆษณาไม่สำเร็จ

iOS

รหัสข้อผิดพลาด เหตุผล
100 myTarget SDK ยังไม่มีโฆษณาที่พร้อมใช้งาน
101 พารามิเตอร์เซิร์ฟเวอร์ myTarget ที่กำหนดค่าไว้ใน UI ของ AdMob ขาดหายไป/ไม่ถูกต้อง
102 myTarget Adapter ไม่รองรับรูปแบบโฆษณาที่ขอ
103 พยายามแสดงโฆษณา myTarget ที่ยังไม่ได้โหลด
104 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ myTarget รองรับ
105 ไม่มีชิ้นงานโฆษณาเนทีฟที่จำเป็น

บันทึกการเปลี่ยนแปลงของตัวกลาง Flutter สำหรับ myTarget

เวอร์ชัน 1.14.1

เวอร์ชัน 1.14.0

เวอร์ชัน 1.13.0

เวอร์ชัน 1.12.0

เวอร์ชัน 1.11.0

เวอร์ชัน 1.10.0

เวอร์ชัน 1.9.0

เวอร์ชัน 1.8.0

เวอร์ชัน 1.7.1

  • อัปเดตเวอร์ชัน Flutter ขั้นต่ำเป็น 3.35.1
  • อัปเดตเพื่อรองรับปลั๊กอิน Flutter สำหรับ Google Mobile Ads เวอร์ชัน 7.0.0

เวอร์ชัน 1.7.0

เวอร์ชัน 1.6.0

เวอร์ชัน 1.5.0

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0