คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก DT Exchange โดยใช้สื่อกลางที่ครอบคลุมการผสานรวม Waterfall โดยจะครอบคลุมวิธีการเพิ่ม DT Exchange ในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม SDK ของ DT Exchange และอะแดปเตอร์ลงในแอป Unity
การผสานรวมที่รองรับและรูปแบบโฆษณา
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ DT Exchange มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว |
ข้อกำหนด
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
- Unity 4 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน Android
- Android API ระดับ 21 ขึ้นไป
- เพื่อทำให้ใช้งานได้ใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS 12.0 ขึ้นไป
- โปรเจ็กต์ Unity ที่ใช้งานได้ซึ่งกำหนดค่าด้วย SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ดูรายละเอียดในเริ่มต้นใช้งาน
- ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน DT Exchange UI
เพิ่มแอปและตำแหน่งโฆษณาใหม่
ลงชื่อสมัครใช้หรือเข้าสู่ระบบ DT Exchange Console
คลิกปุ่มเพิ่มแอปเพื่อเพิ่มแอป
เลือกแพลตฟอร์ม กรอกแบบฟอร์มที่เหลือ แล้วคลิกเพิ่มตำแหน่ง
Android
iOS
ใส่ชื่อตำแหน่งใหม่ในช่องตั้งชื่อตำแหน่ง แล้วเลือกประเภทตำแหน่งที่ต้องการจากรายการแบบเลื่อนลง สุดท้าย คลิกบันทึกตำแหน่ง
รหัสแอปและรหัสตำแหน่งโฆษณา
เปิดแถบการนำทางด้านซ้ายโดยวางเมาส์เหนือแถบนั้น จากนั้นคลิกแอป จากเมนูด้านซ้าย
ในหน้าการจัดการแอป ให้จดรหัสแอปข้างแอป
เลือกแอปของคุณ ไปที่แท็บตำแหน่ง แล้วคลิกไอคอนคัดลอก ถัดจากชื่อตำแหน่ง โปรดจดรหัสตำแหน่งไว้
รหัสผู้เผยแพร่โฆษณา คีย์ผู้ใช้ และข้อมูลลับของผู้ใช้
คลิกชื่อผู้ใช้จากเมนูด้านซ้าย แล้วเลือกโปรไฟล์ผู้ใช้
จดรหัสผู้เผยแพร่โฆษณา คีย์ผู้ใช้ และข้อมูลลับของผู้ใช้ไว้เนื่องจากจำเป็นในขั้นตอนถัดไป
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ของ DT Exchange ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
Android
ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสําหรับ Android
iOS
โปรดดูวิธีการในขั้นตอนที่ 2 ในคู่มือสำหรับ iOS
เพิ่ม Fyber ลงในรายชื่อพาร์ทเนอร์โฆษณาเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาและ GDPR
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Fyber ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน Ad Manager
ขั้นตอนที่ 3: นำเข้า DT Exchange SDK และอะแดปเตอร์
ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ DT Exchange จากลิงก์ดาวน์โหลดใน Changelog แล้วแยก GoogleMobileAdsFyberMediation.unitypackage
ออกจากไฟล์ ZIP
ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วค้นหาไฟล์ GoogleMobileAdsFyberMediation.unitypackage
ที่ดาวน์โหลดไว้ ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว และคลิกนำเข้า
จากนั้นเลือกเนื้อหา > ตัวแก้ไขบริการ Google Play > ตัวแก้ไข Android > บังคับให้แก้ไข ไลบรารีของตัวแปลค่าบริการของ Unity Play จะดำเนินการแก้ปัญหาทรัพยากร Dependency ตั้งแต่ต้นและคัดลอกทรัพยากร Dependency ที่ประกาศไว้ในไดเรกทอรี Assets/Plugins/Android
ของแอป Unity
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน DT Exchange SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้ให้การเปิดเผยบางอย่างแก่ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับการใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง ซึ่งอาจรวบรวม รับ หรือใช้ข้อมูลส่วนตัว และให้ข้อมูลเกี่ยวกับการใช้แต่ละเครือข่าย ขณะนี้ Google ไม่สามารถส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติได้
ส่วนนี้จะแสดงวิธีเปิดหรือปิดใช้โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้สำหรับ DT Exchange
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ DT Exchange เวอร์ชัน 1.1.0 ได้เพิ่มคลาส Fyber
ด้วยวิธี SetGDPRRequired()
และ SetGDPRConsentString()
ซึ่งช่วยให้คุณส่งข้อมูลความยินยอมไปยัง DT Exchange ด้วยตนเองได้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งพารามิเตอร์เหล่านี้ไปยังอะแดปเตอร์ DT Exchange
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
ดูข้อมูลเพิ่มเติมได้ที่บทความ GDPR ของ DT Exchange รวมถึงค่าต่างๆ ที่ระบุในวิธีการนี้
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กําหนดให้ผู้ใช้มีสิทธิในการเลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยให้เลือกไม่ใช้ผ่านลิงก์ "ห้ามขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นชัดเจนในหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสำหรับการแสดงโฆษณา Google ได้ แต่ Google ใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางไม่ได้ คุณจึงต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้แน่ใจว่าปฏิบัติตามข้อกำหนดได้
ปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google สำหรับ DT Exchange เวอร์ชัน 3.1.1 ได้เพิ่มคลาส Fyber
โดยใช้เมธอด SetCCPAString()
ซึ่งช่วยให้คุณส่งข้อมูลความยินยอมไปยัง DT Exchange ด้วยตนเองได้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งพารามิเตอร์เหล่านี้ไปยังอะแดปเตอร์ DT Exchange
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetCCPAString("myCCPAConsentString");
// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();
ดูข้อมูลเพิ่มเติมได้ที่บทความโอเพนซอร์สของ CCPA ของ DT Exchange รวมถึงค่าที่ระบุได้ในเมธอดดังกล่าว
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
Android
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม DT Exchange
iOS
การผสานรวม SKAdNetwork
ทำตามเอกสารประกอบของ DT Exchange เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist
ของโปรเจ็กต์
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก 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 แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่รหัส |
iOS
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | DT Exchange SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในเอกสารประกอบ |
101 | พารามิเตอร์เซิร์ฟเวอร์ DT Exchange ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
102 | ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ DT Exchange รองรับ |
103 | แสดงโฆษณาไม่สำเร็จเนื่องจากมีออบเจ็กต์โฆษณาไปแล้ว |
104 | แสดงโฆษณา DT Exchange ไม่สำเร็จเนื่องจากโฆษณาไม่พร้อม |
105 | DT Exchange SDK แสดงผลข้อผิดพลาดในการเริ่มต้น |
บันทึกการเปลี่ยนแปลงปลั๊กอิน Unity Mediation ของ DT Exchange
เวอร์ชัน 3.1.11
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.7.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.2.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 3.1.10
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.6.1
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.2.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.0.0
เวอร์ชัน 3.1.8
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.5.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.2.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.6.0
เวอร์ชัน 3.1.7
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.4.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.2.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.5.2
เวอร์ชัน 3.1.6
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.3.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.2.3.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.4.1
เวอร์ชัน 3.1.5
- ย้ายเนื้อหาของอะแดปเตอร์ไปที่
GoogleMobileAds/Mediation/DTExchange/
แล้ว - เนมสเปซของอะแดปเตอร์ที่มีการเปลี่ยนโครงสร้างภายในเพื่อใช้
GoogleMobileAds.Mediation.DTExchange
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.3.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.2.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 8.1.0
เวอร์ชัน 3.1.4
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.2.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.1.9.1
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.1
เวอร์ชัน 3.1.3
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.1.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.1.9.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.4.0
เวอร์ชัน 3.1.2
- เปลี่ยนชื่อปลั๊กอินสื่อกลาง Unity เป็น "DT Exchange" แล้ว
- เปลี่ยนชื่อชั้นเรียน
GoogleMobileAds.Api.Mediation.Fyber.Fyber
เป็นGoogleMobileAds.Api.Mediation.DTExchange.DTExchange
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.1.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.1.7.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.1
เวอร์ชัน 3.1.1
- เพิ่มเมธอดต่อไปนี้ไปยังคลาส
Fyber
SetCCPAString(string)
ClearCCPAString()
- รองรับอะแดปเตอร์ Fyber Android เวอร์ชัน 8.2.0.0
- รองรับอะแดปเตอร์ Fyber iOS เวอร์ชัน 8.1.6.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 3.1.0
- รองรับอะแดปเตอร์ Fyber Android เวอร์ชัน 8.2.0.0
- รองรับอะแดปเตอร์ Fyber iOS เวอร์ชัน 8.1.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.2.0
เวอร์ชัน 3.0.2
- รองรับอะแดปเตอร์ Fyber Android เวอร์ชัน 8.1.3.1
- รองรับอะแดปเตอร์ Fyber iOS เวอร์ชัน 8.1.5.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 3.0.1
- รองรับอะแดปเตอร์ Fyber Android เวอร์ชัน 8.1.3.0
- รองรับอะแดปเตอร์ Fyber iOS เวอร์ชัน 8.1.4.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.0
เวอร์ชัน 3.0.0
เวอร์ชัน 2.0.0
เวอร์ชัน 1.6.1
เวอร์ชัน 1.6.0
เวอร์ชัน 1.5.2
เวอร์ชัน 1.5.1
เวอร์ชัน 1.5.0
เวอร์ชัน 1.4.0
เวอร์ชัน 1.3.0
เวอร์ชัน 1.2.3
เวอร์ชัน 1.2.2
เวอร์ชัน 1.2.1
เวอร์ชัน 1.2.0
เวอร์ชัน 1.1.0
- เพิ่มเมธอดต่อไปนี้ลงในคลาส
Fyber
เพื่อรองรับข้อกําหนด GDPRSetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- รองรับอะแดปเตอร์ Fyber Android เวอร์ชัน 7.3.4.0
- รองรับอะแดปเตอร์ Fyber iOS เวอร์ชัน 7.5.0.0
เวอร์ชัน 1.0.0
- เปิดตัวครั้งแรก!
- รองรับอะแดปเตอร์ Fyber Android เวอร์ชัน 7.3.4.0
- รองรับอะแดปเตอร์ Fyber iOS เวอร์ชัน 7.4.0.0