Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

ผสานรวม Unity Ads กับสื่อกลาง

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เดิม)

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

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบสิ่งต่อไปนี้

Google Mobile Ads Flutter Plugin เวอร์ชันล่าสุด
เฟรมเวิร์ก Flutter เวอร์ชัน 3.7.0 ขึ้นไป
[สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Unity Ads 1.1.0 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)
วิธีติดตั้งใช้งานใน Android
- Android API ระดับ 24 ขึ้นไป
วิธีติดตั้งใช้งานใน iOS
- เป้าหมายการติดตั้งใช้งาน iOS เวอร์ชัน 13.0 ขึ้นไป
โปรเจ็กต์ Flutter ที่ใช้งานได้ซึ่งกำหนดค่าด้วย Google Mobile Ads Flutter Plugin ดูรายละเอียดได้ที่หัวข้อตั้งค่า Google Mobile Ads Flutter Plugin

ตั้งค่าสื่อกลาง

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

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

สร้างโปรเจ็กต์

ในแดชบอร์ด Unity Ads ให้ไปที่โปรเจ็กต์ แล้วคลิกใหม่

กรอกแบบฟอร์ม แล้วคลิกสร้างเพื่อเพิ่มโปรเจ็กต์

ไปที่การสร้างรายได้จาก Unity Ads แล้วคลิกเริ่มต้นใช้งาน

ในโมดัลโปรเจ็กต์ใหม่ ให้เลือกฉันจะใช้สื่อกลางและ Google AdMob สำหรับพาร์ทเนอร์สื่อกลาง แล้วคลิกถัดไป

เลือกตัวเลือกสำหรับการตั้งค่าโฆษณา แล้วคลิกถัดไป

เลือกการตั้งค่าตำแหน่งโฆษณา แล้วคลิกถัดไป

การเสนอราคา

น้ำตก

กรอกแบบฟอร์มแล้วคลิกเพิ่มโปรเจ็กต์

จดรหัสเกม

สร้างหน่วยโฆษณาและตำแหน่งโฆษณา

ไปที่การสร้างรายได้จาก Unity Ads > ตําแหน่ง จากนั้นเลือก โปรเจ็กต์แล้วคลิกเพิ่มหน่วยโฆษณา

ป้อนชื่อหน่วยโฆษณา แล้วเลือกแพลตฟอร์มและรูปแบบโฆษณา

Android

iOS

ไปที่การสร้างรายได้ > ตำแหน่งโฆษณา แล้วคลิกเพิ่มหน่วยโฆษณา

ป้อนชื่อหน่วยโฆษณา แล้วเลือกแพลตฟอร์มและรูปแบบโฆษณา

Android

iOS

เลือก Waterfall สำหรับการตั้งค่า ในส่วนตําแหน่ง ให้ป้อนชื่อตําแหน่ง การติดแท็กทางภูมิศาสตร์ และเป้าหมาย

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

สุดท้าย ให้คลิกเพิ่มหน่วยโฆษณาเพื่อบันทึกหน่วยโฆษณาและตําแหน่ง

ค้นหาคีย์ API การรายงานของ Unity Ads

การเสนอราคา

ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

ไปที่การสร้างรายได้จาก Unity Ads > การจัดการ API และจดคีย์ API ในสิทธิ์เข้าถึง API สถิติการสร้างรายได้

จากนั้นไปที่การสร้างรายได้จาก Unity Ads > การตั้งค่าองค์กร แล้วจดบันทึกรหัสหลักขององค์กรไว้

อัปเดต app-ads.txt

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

หากต้องการใช้ app-ads.txt สำหรับ Unity Ads โปรดดูการตั้งค่า app-ads.txt เป็นครั้งแรก

เปิดโหมดทดสอบ

คุณเปิดใช้โหมดทดสอบได้จากแดชบอร์ด Unity Ads ไปที่ การสร้างรายได้จาก Unity Ads > การทดสอบ

คุณบังคับใช้โหมดทดสอบสำหรับแอปได้โดยคลิกปุ่มแก้ไขของแต่ละแพลตฟอร์ม เปิดใช้ลบล้างโหมดทดสอบของไคลเอ็นต์ แล้วเลือกบังคับใช้โหมดทดสอบเป็นเปิด (เช่น ใช้โฆษณาทดสอบ) สำหรับอุปกรณ์ทั้งหมด

Android

iOS

หรือจะเปิดใช้โหมดทดสอบสำหรับอุปกรณ์ที่เฉพาะเจาะจงโดยคลิกเพิ่มอุปกรณ์ทดสอบก็ได้

ป้อนรายละเอียดอุปกรณ์ทดสอบ แล้วคลิกบันทึก

ขั้นตอนที่ 2: ตั้งค่าดีมานด์ Unity Ads ใน UI ของ Ad Manager

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

Android

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

iOS

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

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

ทำตามขั้นตอนในการตั้งค่ากฎระเบียบของยุโรปและการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม Unity Ads ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบของยุโรปและรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager

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

การผสานรวมผ่าน pub.dev

เพิ่มทรัพยากร Dependency ต่อไปนี้ด้วย SDK และอะแดปเตอร์ Unity Ads เวอร์ชันล่าสุดในไฟล์ pubspec.yaml ของแพ็กเกจ

dependencies:
  gma_mediation_unity: ^1.11.1

การผสานรวมด้วยตนเอง

ดาวน์โหลดปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Unity Ads เวอร์ชันล่าสุด แตกไฟล์ที่ดาวน์โหลดมา แล้วเพิ่มโฟลเดอร์ปลั๊กอินที่แตกออกมา (และเนื้อหาของโฟลเดอร์) ลงในโปรเจ็กต์ Flutter จากนั้นอ้างอิงปลั๊กอินในไฟล์ pubspec.yaml โดยเพิ่มทรัพยากร Dependency ต่อไปนี้

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

Unity Ads Flutter Adapter เวอร์ชัน 1.10.0 ขึ้นไปรองรับการส่งสัญญาณความยินยอมตาม GDPR จากแพลตฟอร์มการจัดการความยินยอม ที่ผสานรวมกับกรอบความโปร่งใสและความยินยอม (TCF) ของ IAB ไปยัง Unity Ads SDK ดูข้อมูลเพิ่มเติมได้ที่หัวข้อตั้งค่าการกำหนดค่าความยินยอมแบบ TCF หรือไม่ใช่ TCF

กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา

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

ปลั๊กอินสื่อกลาง Google Mobile Ads สำหรับ Unity Ads มีเมธอด GmaMediationUnity.setCCPAConsent() โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยัง Unity Ads SDK หากเลือกเรียกใช้เมธอดนี้ เราขอแนะนำให้เรียกใช้ก่อนที่จะขอโฆษณาผ่าน Google Mobile Ads Flutter Plugin

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

ตั้งค่าการดูแลตามอายุ

ปลั๊กอินสื่อกลาง Unity Ads เวอร์ชัน 1.6.5 ขึ้นไปจะส่งต่อการตั้งค่าที่มีเด็กเป็นกลุ่มเป้าหมายและการตั้งค่าผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ไปยัง Unity Ads

หากต้องการประมวลผลสัญญาณเหล่านี้ในระดับผู้ใช้แต่ละราย Unity Ads กำหนดให้คุณต้องเปิดใช้การกำหนดกลุ่มเป้าหมายแบบผสมในแดชบอร์ดการสร้างรายได้ของ Unity ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้การระบุกลุ่มเป้าหมายแบบผสมในโปรเจ็กต์ได้ที่การตั้งค่าการระบุอายุระดับเกม

ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น

Android

ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Unity Ads Android

iOS

การผสานรวม SKAdNetwork

ทำตามเอกสารประกอบของ Unity Ads เพื่อเพิ่มตัวระบุ SKAdNetwork ลงในไฟล์ Info.plist ของโปรเจ็กต์

ขั้นตอนที่ 6: ทดสอบการติดตั้งใช้งาน

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

ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager และเปิดใช้โหมดทดสอบใน UI ของ Unity Ads

ยืนยันโฆษณาทดสอบ

หากต้องการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Unity Ads ให้เปิดใช้การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้แหล่งที่มาของโฆษณา Unity Ads (การเสนอราคา) และ Unity Ads (การแสดงวิดีโอตามลำดับขั้น)

รหัสข้อผิดพลาด

หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Unity Ads ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่สำคัญจากการตอบกลับของโฆษณาได้โดยใช้ ResponseInfo ในคลาสต่อไปนี้

Android

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

ต่อไปนี้คือรหัสและข้อความที่แสดงโดยอะแดปเตอร์ UnityAds เมื่อโหลดโฆษณาไม่สำเร็จ

Android

รหัสข้อผิดพลาด	เหตุผล
0-10	SDK ของ UnityAds แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ที่โค้ด
101	พารามิเตอร์เซิร์ฟเวอร์ UnityAds ที่กำหนดค่าใน UI ของ AdMob ไม่มีหรือไม่ถูกต้อง
102	UnityAds แสดงผลตำแหน่งโฆษณาที่มีสถานะ NO_FILL
103	UnityAds แสดงผลตำแหน่งโฆษณาที่มีสถานะ "ปิดใช้"
104	UnityAds พยายามแสดงโฆษณาที่มีบริบทเป็น Null
105	บริบทที่ใช้ในการเริ่มต้น โหลด และ/หรือแสดงโฆษณาจาก Unity Ads ไม่ใช่อินสแตนซ์ของกิจกรรม
106	UnityAds พยายามแสดงโฆษณาที่ยังไม่พร้อมแสดง
107	อุปกรณ์ไม่รองรับ UnityAds
108	UnityAds โหลดโฆษณาได้ครั้งละ 1 รายการต่อตำแหน่งโฆษณาเท่านั้น
109	UnityAds เสร็จสมบูรณ์โดยมีสถานะข้อผิดพลาด
110	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ UnityAds รองรับ
111	UnityAds แสดงข้อผิดพลาดในการเริ่มต้น
112	Unity Ads แสดงโทเค็นการเสนอราคาเป็น Null หรือว่างเปล่า
200-204	แบนเนอร์ UnityAds มีข้อผิดพลาดที่เฉพาะเจาะจง ดูรายละเอียดเพิ่มเติมได้ที่โค้ด

iOS

0-9	UnityAds SDK แสดงข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Unity
101	พารามิเตอร์เซิร์ฟเวอร์ UnityAds ที่กำหนดค่าใน UI ของ Ad Manager หายไป/ไม่ถูกต้อง
102	อุปกรณ์ไม่รองรับ UnityAds
103	UnityAds แสดงผลเสร็จแล้วโดยมีสถานะข้อผิดพลาด `kUnityAdsFinishStateError`
104	ออบเจ็กต์โฆษณา Unity จะเป็น nil หลังจากเรียกใช้ตัวเริ่มต้น
105	แสดง Unity Ads ไม่สำเร็จเนื่องจากโฆษณาไม่พร้อม
107	UnityAds เรียกใช้การเรียกกลับเมื่อมีการเปลี่ยนแปลงตำแหน่งโฆษณาโดยมีสถานะตำแหน่งโฆษณาเป็น `kUnityAdsPlacementStateDisabled`
108	โหลดโฆษณาสำหรับตำแหน่งนี้แล้ว UnityAds SDK ไม่รองรับการโหลดโฆษณาหลายรายการสำหรับตําแหน่งเดียวกัน
109	โฆษณาแบนเนอร์ที่ UnityAds แสดงผลไม่ตรงกับขนาดที่ขอ
110	UnityAds แสดงข้อผิดพลาดในการเริ่มต้น
111	รูปแบบโฆษณาที่ไม่รองรับ
112	UnityAds แสดงผลโทเค็นการเสนอราคาเป็นค่า Null หรือว่างเปล่า