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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เลือกการตั้งค่าตําแหน่ง แล้วคลิกถัดไป

การเสนอราคา

น้ำตก

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

จดรหัสเกม

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

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

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

Android

iOS

การเสนอราคา

เลือกการเสนอราคาสำหรับการตั้งค่า ในส่วนตําแหน่ง ให้ป้อนชื่อตําแหน่ง

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

น้ำตก

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

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

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

ค้นหาคีย์ Unity Ads Reporting API

การเสนอราคา

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

น้ำตก

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

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

อัปเดต app-ads.txt

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

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

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

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

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

Android

iOS

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

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

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

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

Android

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

iOS

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

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

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

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

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

เพิ่มทรัพยากร Dependency ต่อไปนี้พร้อมกับ Unity Ads SDK และอะแดปเตอร์เวอร์ชันล่าสุดในไฟล์ 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: ทดสอบการติดตั้งใช้งาน

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

ตรวจสอบว่าคุณได้ ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ AdMob และเปิดใช้โหมดทดสอบใน 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 แสดงผลตําแหน่งที่มีสถานะเป็น DISABLED
104	UnityAds พยายามแสดงโฆษณาที่มีบริบทเป็น Null
105	บริบทที่ใช้ในการเริ่มต้น โหลด และ/หรือแสดงโฆษณาจาก Unity Ads ไม่ใช่อินสแตนซ์ของกิจกรรม
106	UnityAds พยายามแสดงโฆษณาที่ยังไม่พร้อมแสดง
107	อุปกรณ์ไม่รองรับ UnityAds
108	UnityAds โหลดโฆษณาได้ครั้งละ 1 รายการต่อตําแหน่งเท่านั้น
109	UnityAds เสร็จสมบูรณ์โดยมีสถานะ ERROR
110	ขนาดโฆษณาที่ขอไม่ตรงกับขนาดแบนเนอร์ที่ UnityAds รองรับ
111	UnityAds แสดงข้อผิดพลาดในการเริ่มต้น
112	Unity Ads แสดงโทเค็นการเสนอราคาเป็นค่าว่างหรือว่างเปล่า
200-204	UnityAds Banner a specific error. ดูรายละเอียดเพิ่มเติมได้ที่โค้ด

iOS

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