คู่มือนี้แสดงวิธีใช้ 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 กำลังทำงานซึ่งกำหนดค่าด้วย Google SDK โฆษณาในอุปกรณ์เคลื่อนที่ โปรดดู เริ่มต้นใช้งานเพื่อดูรายละเอียด
- ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ DT Exchange
Add new app and ad placement
Sign up or log in to DT Exchange Console.
Click on the Add App button to add your app.
Select your Platform, fill out the rest of the form, and click Add Placements.
Android
iOS
Enter a name for the new placement in the field labeled Name your Placement and select your desired Placement Type from the dropdown list. Finally, click Save Placement.
App ID and Placement ID
Open the left navigation bar by hovering your mouse over it. Then click Apps from the left menu.
On the App Management page, take note of the App ID next to your app.
Select your app, navigate to the Placements tab, and click on the copy icon next to Placement Name. Take note of the Placement ID.
Publisher ID, Consumer Key and Consumer Secret
Click on your username from the left menu and select User Profile.
Take note of the Publisher ID, Consumer Key, and Consumer Secret as these are needed in the next step.
ขั้นตอนที่ 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
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้ความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่าง และ ความยินยอมที่ได้รับจาก ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับ การใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นไปตาม ข้อกำหนดด้าน ePrivacy และการคุ้มครองข้อมูลทั่วไปของสหภาพยุโรป กฎระเบียบ (GDPR) เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัว และ ให้ข้อมูลเกี่ยวกับการใช้งานของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถ ส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ส่วนนี้จะแสดงวิธีเปิดหรือปิดใช้โฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้สำหรับ DT Exchange
ปลั๊กอินสื่อกลางโฆษณา Google Mobile สำหรับ DT Exchange เวอร์ชัน 1.1.0 ได้เพิ่ม
Fyber
ที่มีเมธอด SetGDPRRequired()
และ SetGDPRConsentString()
ให้คุณส่งต่อข้อมูลความยินยอมไปยัง DT Exchange ด้วยตนเอง ดังต่อไปนี้
โค้ดตัวอย่างแสดงวิธีส่งพารามิเตอร์เหล่านี้ไปยัง DT Exchange
อะแดปเตอร์:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
ไปที่เว็บไซต์ของ DT Exchange GDPR เพื่อดูข้อมูลเพิ่มเติมและค่าที่สามารถระบุไว้ในเมธอดได้
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
สหรัฐอเมริกา กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐ ต้องให้ผู้ใช้ได้รับ เพื่อเลือกไม่ใช้ "การลดราคา" ของ "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ข้อกำหนดดังกล่าว) โดยการเลือกไม่ใช้ที่นำเสนอผ่านโฆษณาว่า "อย่าขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัด ข้อมูล" ลิงก์ในหน้า "การขาย" หน้าแรกของพรรคการเมือง สหรัฐอเมริกา สถานะความเป็นส่วนตัว คู่มือการปฏิบัติตามกฎหมายช่วยให้คุณ การประมวลผลข้อมูลแบบจำกัด สําหรับการแสดงโฆษณาของ Google แต่ Google ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด
ปลั๊กอินสื่อกลางโฆษณา Google Mobile สำหรับ 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 ของ 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.3.0
- เปลี่ยนชื่อ
DummyClient
เป็นPlaceholderClient
แล้ว - รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.3.0.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.3.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.2.0
เวอร์ชัน 3.2.1
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.7.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.3.1.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.1
เวอร์ชัน 3.2.0
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.7.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.3.0.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 3.1.12
- รองรับอะแดปเตอร์ DT Exchange Android เวอร์ชัน 8.2.7.0
- รองรับอะแดปเตอร์ DT Exchange iOS เวอร์ชัน 8.2.8.0
- สร้างและทดสอบด้วย Google Mobile Ads Unity Plugin เวอร์ชัน 9.1.0
เวอร์ชัน 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()
- รองรับอะแดปเตอร์ Android ของ Feber เวอร์ชัน 8.2.0.0
- รองรับอะแดปเตอร์ iOS ของ Fyber เวอร์ชัน 8.1.6.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.3.0
เวอร์ชัน 3.1.0
- รองรับอะแดปเตอร์ Android ของ Feber เวอร์ชัน 8.2.0.0
- รองรับอะแดปเตอร์ iOS ของ Fyber เวอร์ชัน 8.1.5.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.2.0
เวอร์ชัน 3.0.2
- รองรับอะแดปเตอร์ Android ของ Fyber เวอร์ชัน 8.1.3.1
- รองรับอะแดปเตอร์ iOS ของ Fyber เวอร์ชัน 8.1.5.0
- สร้างและทดสอบโดยใช้ Google Mobile Ads Unity Plugin เวอร์ชัน 7.0.2
เวอร์ชัน 3.0.1
- รองรับอะแดปเตอร์ Android ของ Feber เวอร์ชัน 8.1.3.0
- รองรับอะแดปเตอร์ iOS ของ Fyber เวอร์ชัน 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()
- รองรับอะแดปเตอร์ Android ของ Fyber เวอร์ชัน 7.3.4.0
- รองรับอะแดปเตอร์ iOS ของ Fyber เวอร์ชัน 7.5.0.0
เวอร์ชัน 1.0.0
- เปิดตัวครั้งแรก
- รองรับอะแดปเตอร์ Android ของ Fyber เวอร์ชัน 7.3.4.0
- รองรับอะแดปเตอร์ iOS ของ Fyber เวอร์ชัน 7.4.0.0