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

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

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

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

ข้อกำหนด

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

เนทีฟ

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

ในหน้ารายละเอียดของหน่วยโฆษณา ให้จดรหัสช่องซึ่งจะอยู่ในส่วนการตั้งค่าหน่วยโฆษณาเป็น 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: ^

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

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

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

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

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

หากอแดปเตอร์ไม่ได้รับโฆษณาจาก 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 ไม่มีชิ้นงานที่จำเป็นบางรายการ (เช่น รูปภาพหรือไอคอน)

iOS

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

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

เวอร์ชัน 1.4.0

เวอร์ชัน 1.3.0

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0