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

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

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

Ad Manager อะแดปเตอร์สื่อกลางสําหรับ DT Exchange มีคุณสมบัติดังต่อไปนี้

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

ข้อกำหนด

  • Google Mobile Ads SDK เวอร์ชันล่าสุด
  • Unity 4 ขึ้นไป
  • วิธีติดตั้งใช้งานใน Android
    • API ของ Android ระดับ 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 และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม DT Exchange (การสร้างรายได้ของ Fyber) ลงในรายชื่อพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob

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

OpenUPM-CLI

หากติดตั้ง OpenUPM-CLI แล้ว คุณจะติดตั้งปลั๊กอินสื่อกลาง Google Mobile Ads DT Exchange สำหรับ Unity ลงในโปรเจ็กต์ได้โดยเรียกใช้คําสั่งต่อไปนี้จากไดเรกทอรีรูทของโปรเจ็กต์

openupm add com.google.ads.mobile.mediation.dtexchange

OpenUPM

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกแก้ไข > การตั้งค่าโปรเจ็กต์ > เครื่องมือจัดการแพ็กเกจเพื่อเปิดการตั้งค่าเครื่องมือจัดการแพ็กเกจ Unity

ในแท็บ Scoped Registries ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตซึ่งมีรายละเอียดดังต่อไปนี้

  • ชื่อ: OpenUPM
  • URL: https://package.openupm.com
  • ขอบเขต: com.google

รายละเอียด OpenUPM

จากนั้นไปที่หน้าต่าง > เครื่องมือจัดการแพ็กเกจเพื่อเปิดเครื่องมือจัดการแพ็กเกจ Unity แล้วเลือกที่เก็บของฉันจากเมนูแบบเลื่อนลง

รีจิสทรีของ Unity

เลือกแพ็กเกจสื่อกลาง DT Exchange ของ Google Ads แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

ดาวน์โหลดปลั๊กอินสื่อกลางโฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุดสำหรับ DT Exchange จากลิงก์ดาวน์โหลดใน Changelog และแยก GoogleMobileAdsDTExchangeMediation.unitypackage จากไฟล์ ZIP

ในเครื่องมือแก้ไขโปรเจ็กต์ Unity ให้เลือกเนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง แล้วหาไฟล์ GoogleMobileAdsDTExchangeMediation.unitypackage ที่คุณดาวน์โหลด ตรวจสอบว่าได้เลือกไฟล์ทั้งหมดแล้ว แล้วคลิกนําเข้า

นำเข้าจาก Unity

จากนั้นเลือกชิ้นงาน > เครื่องมือจัดการทรัพยากรภายนอก > เครื่องมือแก้ไขของ Android > บังคับแก้ไข ไลบรารีเครื่องมือจัดการทรัพยากร Dependency ภายนอกจะทำการแก้ไข Dependency ตั้งแต่ต้นและคัดลอก Dependency ที่ประกาศไว้ไปยังไดเรกทอรี Assets/Plugins/Android ของแอป Unity

บังคับแก้ไข

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

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

ส่วนนี้จะแสดงวิธีเปิดหรือปิดใช้โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้สําหรับ DT Exchange

ปลั๊กอินสื่อกลาง Google Mobile Ads สําหรับ 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 ที่กําหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง
103 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ DT Exchange รองรับ
105 DT Exchange SDK โหลดโฆษณาแต่แสดงผลตัวควบคุมที่ไม่คาดคิด
106 โฆษณาไม่พร้อมแสดง
200-399 DT Exchange SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมที่ code

iOS

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

บันทึกการเปลี่ยนแปลงปลั๊กอินของ DT Exchange Unity Mediation

เวอร์ชัน 3.3.3

เวอร์ชัน 3.3.2

เวอร์ชัน 3.3.1

เวอร์ชัน 3.3.0

เวอร์ชัน 3.2.1

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