คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก DT Exchange โดยใช้สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม DT Exchange ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK และอะแดปเตอร์ DT Exchange เข้ากับ Flutter แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
AdMob อะแดปเตอร์สื่อกลางสําหรับ 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 ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
Android
โปรดดูวิธีการที่ขั้นตอนที่ 2 ในคู่มือสำหรับ Android
iOS
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Fyber ลงในรายการพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนในการตั้งค่า GDPR และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม DT Exchange (การสร้างรายได้ของ Fyber) ลงในรายชื่อพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ DT Exchange
การผสานรวมผ่าน 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 แล้ว
ยืนยันโฆษณาทดสอบ
หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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 แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมที่ code |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | DT Exchange SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในเอกสารประกอบ |
101 | พารามิเตอร์เซิร์ฟเวอร์ DT Exchange ที่กําหนดค่าใน AdMob 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