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

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

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

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

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

ข้อกำหนด

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

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

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

ลงชื่อสมัครใช้หรือเข้าสู่ระบบ 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 และอะแดปเตอร์

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ 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

ภายใต้นโยบายความยินยอมของผู้ใช้ 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: ทดสอบการใช้งาน

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

อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ 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 Unity Mediation

เวอร์ชัน 3.2.0

เวอร์ชัน 3.1.12

เวอร์ชัน 3.1.11

เวอร์ชัน 3.1.10

เวอร์ชัน 3.1.8

เวอร์ชัน 3.1.7

เวอร์ชัน 3.1.6

เวอร์ชัน 3.1.5

เวอร์ชัน 3.1.4

เวอร์ชัน 3.1.3

เวอร์ชัน 3.1.2

เวอร์ชัน 3.1.1

เวอร์ชัน 3.1.0

เวอร์ชัน 3.0.2

เวอร์ชัน 3.0.1

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

เวอร์ชัน 1.0.0