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

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

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

Ad Manager อะแดปเตอร์สื่อกลางสําหรับ DT Exchange มีคุณสมบัติดังต่อไปนี้

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

ข้อกำหนด

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

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

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

ลงชื่อสมัครใช้หรือเข้าสู่ระบบคอนโซล DT Exchange

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

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

Android

iOS

ป้อนชื่อตําแหน่งใหม่ในช่องที่มีป้ายกํากับว่าตั้งชื่อตําแหน่ง และเลือกประเภทตําแหน่งที่ต้องการจากรายการแบบเลื่อนลง สุดท้าย ให้คลิกบันทึกตําแหน่ง

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

เปิดแถบนําทางด้านซ้ายโดยวางเมาส์เหนือแถบ จากนั้นคลิกแอปจากเมนูด้านซ้าย

ในหน้าการจัดการแอป ให้จดรหัสแอปข้างแอปไว้

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

รหัสผู้เผยแพร่โฆษณา รหัสผู้ใช้ และข้อมูลลับของผู้ใช้ในการเข้าถึง

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

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

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

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

Android

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

iOS

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

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

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

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

หมายเหตุ: การไม่ผสานรวม DT Exchange เวอร์ชันที่เข้ากันได้กับ Google Mobile Ads SDK อาจทําให้เกิดปัญหาการสร้าง

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

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

dependencies:
  gma_mediation_dtexchange: ^1.0.0

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

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

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

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

ความยินยอมของ EU และ GDPR

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

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

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

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

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

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

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

สำคัญ: ปิดใช้โหมดทดสอบสำหรับ AdMob และ DT Exchange ก่อนเผยแพร่แอป

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

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

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

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

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

รหัสและข้อความที่มาพร้อมกับข้อผิดพลาดที่อะแดปเตอร์ DT Exchange แสดงเมื่อโหลดโฆษณาไม่สําเร็จมีดังนี้

Android

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

iOS

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

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

เวอร์ชันถัดไป

• สร้างและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.2.0

1.1.0

• ยืนยันความเข้ากันได้กับอะแดปเตอร์ DT Exchange สำหรับ Android เวอร์ชัน 8.3.0.0
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ iOS ของ DT Exchange เวอร์ชัน 8.3.1.0
• สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0

1.0.0

• การเผยแพร่ครั้งแรก
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ DT Exchange สำหรับ Android เวอร์ชัน 8.2.7.0
• ยืนยันความเข้ากันได้กับอะแดปเตอร์ DT Exchange สำหรับ iOS เวอร์ชัน 8.2.8.0
• สร้างขึ้นและทดสอบด้วยปลั๊กอิน Flutter ของ Google Mobile Ads เวอร์ชัน 5.1.0