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

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

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

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

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

ข้อกำหนด

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

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

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

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

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

จัดการแอป

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

Android

iOS

ป้อนชื่อและเลือกประเภทของตําแหน่ง จากนั้นคลิกบันทึกตําแหน่ง

ตั้งค่า

รหัสแอปและรหัสตำแหน่ง

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

ในหน้าการจัดการแอป ให้จดรหัสแอปข้างแอปของคุณ

เลือกแอปและไปที่แท็บตําแหน่ง จดรหัสตําแหน่ง

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

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

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

จดรหัสผู้เผยแพร่โฆษณา คีย์ผู้ใช้ และรหัสลับผู้ใช้ไว้ เนื่องจากคุณจะต้องใช้ในขั้นตอนถัดไป

โปรไฟล์ผู้ใช้

อัปเดต app-ads.txt

ผู้ขายที่ได้รับอนุญาตสำหรับแอป app-ads.txt เป็นความคิดริเริ่มของ IAB Tech Lab ที่ช่วยตรวจสอบว่าคุณจะขาย พื้นที่โฆษณาในแอปผ่านช่องทางที่คุณได้รับอนุญาตเท่านั้น คุณจะต้องใช้ไฟล์ app-ads.txt เพื่อป้องกันไม่ให้เสียรายได้จากโฆษณาเป็นจำนวนมาก หากยังไม่ได้ดำเนินการ ให้สร้างไฟล์ app-ads.txt สำหรับแอป

หากต้องการใช้ app-ads.txt สำหรับ DT Exchange ให้เพิ่ม DT ลงในไฟล์ app-ads.txt

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ DT Exchange ใน UI ของ AdMob

กำหนดค่าการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา

Android

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคำแนะนำสำหรับ Android

iOS

ดูวิธีการได้ที่ขั้นตอนที่ 2 ในคู่มือสำหรับ iOS

เพิ่ม DT Exchange ลงในรายการพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา

ทําตามขั้นตอนใน การตั้งค่ากฎระเบียบของยุโรป และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม DT Exchange (Fyber Monetization) ลงใน รายชื่อพาร์ทเนอร์โฆษณาที่ปฏิบัติตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ AdMob

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

OpenUPM-CLI

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

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

OpenUPM

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

ในแท็บรีจิสทรีที่กำหนดขอบเขต ให้เพิ่ม OpenUPM เป็นรีจิสทรีที่กำหนดขอบเขตโดยใช้รายละเอียดต่อไปนี้

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

รายละเอียด OpenUPM

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

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

เลือกแพ็กเกจ การไกล่เกลี่ย DTExchange ของโฆษณาในอุปกรณ์เคลื่อนที่ของ Google แล้วคลิกติดตั้ง

ติดตั้งจาก OpenUPM

แพ็กเกจ Unity

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

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

นำเข้าจาก Unity

จากนั้นเลือกเนื้อหา > External Dependency Manager > Android Resolver > Force Resolve ไลบรารี External Dependency Manager จะทำการแก้ปัญหาทรัพยากร 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 Open Source ของ 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 ที่กำหนดค่าใน UI ของ AdMob ขาดหายไป/ไม่ถูกต้อง
103 ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ DT Exchange รองรับ
105 SDK ของ DT Exchange โหลดโฆษณาแล้ว แต่แสดงผลตัวควบคุมที่ไม่คาดคิด
106 โฆษณาไม่พร้อมแสดง
107 บริบทไม่ใช่อินสแตนซ์กิจกรรม
200-399 DT Exchange SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่โค้ด

iOS

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

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

เวอร์ชัน 3.3.11

เวอร์ชัน 3.3.10

เวอร์ชัน 3.3.9

เวอร์ชัน 3.3.8

เวอร์ชัน 3.3.7

เวอร์ชัน 3.3.6

เวอร์ชัน 3.3.5

เวอร์ชัน 3.3.4

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