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

เลือกแพลตฟอร์ม: Android ใหม่ Android iOS Unity Flutter

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

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

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

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

1 การผสานรวมการเสนอราคาอยู่ในโปรแกรมเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อ ขอสิทธิ์เข้าถึง

2 รูปแบบโฆษณาเนทีฟอยู่ใน เวอร์ชันเบต้า โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

ข้อกำหนด

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

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

เพิ่มแอปและตำแหน่งโฆษณาใหม่

ลงชื่อสมัครใช้ หรือ เข้าสู่ระบบ ไปยัง DT Exchange Console

คลิกเพิ่มแอป

จัดการแอป

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

Android

iOS

ป้อนชื่อและเลือกประเภทตำแหน่งโฆษณา จากนั้นคลิกบันทึกตำแหน่งโฆษณา

ตั้งค่า

รหัสแอปและรหัสตำแหน่งโฆษณา

วางเมาส์เหนือแถบการนำทางด้านซ้ายเพื่อเปิด จากนั้นคลิกการจัดการแอป

ในหน้าการจัดการแอป ให้จดรหัสแอป ข้างแอปของคุณ

เลือกแอปแล้วไปที่แท็บตำแหน่งโฆษณา จดรหัสตำแหน่งโฆษณา

รหัสตำแหน่งโฆษณา

รหัสผู้เผยแพร่โฆษณา, Consumer Key และ Consumer Secret

คลิกชื่อผู้ใช้จากเมนูด้านซ้าย แล้วเลือกโปรไฟล์ผู้ใช้

จดรหัสผู้เผยแพร่โฆษณา, Consumer Key และ Consumer Secret ไว้ เนื่องจาก คุณจะต้องใช้ข้อมูลเหล่านี้ในขั้นตอนถัดไป

โปรไฟล์ผู้ใช้

อัปเดต app-ads.txt

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

หากต้องการใช้ app-ads.txt สำหรับ DT Exchange, ให้เพิ่ม DT ลงในไฟล์ app-ads.txt

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

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

Android

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

iOS

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

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

ทำตามขั้นตอนในการ ตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม DT Exchange (การสร้างรายได้จาก Fyber) ลงใน รายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager

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

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

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

dependencies:
  gma_mediation_dtexchange: ^1.3.3

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

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

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ DT Exchange ไม่รองรับการส่งข้อมูลความยินยอมไปยัง DT SDK

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

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ DT Exchange ไม่รองรับการส่งข้อมูลความยินยอมไปยัง DT SDK

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

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

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

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

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

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

รหัสข้อผิดพลาด เหตุผล
101 พารามิเตอร์เซิร์ฟเวอร์ DT Exchange ที่กำหนดค่าไว้ใน UI ของ Ad Manager ขาดหายไป/ไม่ถูกต้อง
103 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ DT Exchange รองรับ
105 DT SDK โหลดโฆษณาแล้วแต่แสดงผลคอนโทรลเลอร์ที่ไม่คาดคิด
106 โฆษณาไม่พร้อมแสดง
107 บริบทไม่ใช่อินสแตนซ์กิจกรรม
200-399 DT SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่ โค้ด

iOS

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

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง Flutter สำหรับ DT Exchange

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

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

เวอร์ชัน 1.3.3

เวอร์ชัน 1.3.2

เวอร์ชัน 1.3.1

เวอร์ชัน 1.2.0

เวอร์ชัน 1.1.5

เวอร์ชัน 1.1.4

เวอร์ชัน 1.1.3

เวอร์ชัน 1.1.2

เวอร์ชัน 1.1.1

เวอร์ชัน 1.1.0

เวอร์ชัน 1.0.0