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

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เวอร์ชันเก่า)

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

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

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

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

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

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

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

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

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

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

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

    จัดการแอป

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

    Android

    iOS

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

    ตั้งค่า

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

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

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

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

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

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

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

    จดรหัสผู้เผยแพร่โฆษณา, คีย์ผู้ใช้ และ 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 Exchange SDK และอะแดปเตอร์

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

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

    dependencies:
  gma_mediation_dtexchange: ^1.3.7

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

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

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

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

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

    DT Exchange Flutter Adapter เวอร์ชัน 1.1.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอมที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง DT Exchange SDK ดูข้อมูลเพิ่มเติมได้ที่ Android และ iOS

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

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

    ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ DT Exchange ไม่รองรับการส่งข้อมูลความยินยอมไปยัง DT Exchange 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 บริบทไม่ใช่อินสแตนซ์กิจกรรม
    108 แสดงโฆษณาไม่สำเร็จ
    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.7

    เวอร์ชัน 1.3.6

    เวอร์ชัน 1.3.5

    เวอร์ชัน 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