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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

จัดการแอป

เลือกแพลตฟอร์ม กรอกแบบฟอร์มที่เหลือ แล้วคลิกเพิ่มตำแหน่ง

Android

iOS

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

ตั้งค่า

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

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

เมนู

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

รหัสแอป

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

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

รหัสผู้เผยแพร่โฆษณา คีย์ผู้ใช้ และข้อมูลลับของผู้ใช้

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_dtexchange: ^1.0.0

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

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

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

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

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ DT Exchange ไม่รองรับการส่งผ่าน ข้อมูลความยินยอมไปยัง DT Exchange SDK

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

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

ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ DT Exchange ไม่รองรับการส่งผ่าน ข้อมูลความยินยอมไปยัง DT Exchange SDK

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

Android

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

iOS

การผสานรวม SKAdNetwork

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

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

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

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob

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

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

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

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

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

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

iOS

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

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

1.0.0

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