คู่มือนี้แสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดง โฆษณาจาก Unity Ads ที่ใช้ สื่อกลาง ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งครอบคลุมถึงวิธีเพิ่ม Unity Ads ลงใน การกำหนดค่าสื่อกลาง และวิธีผสานรวม SDK โฆษณา Unity และอะแดปเตอร์ แอป Android
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสำหรับ Unity Ads มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- API ของ Android ระดับ 21 ขึ้นไป
SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันล่าสุด
ดำเนินการสื่อกลางให้เสร็จสิ้น คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: กำหนดค่าใน UI ของ Unity Ads
ลงชื่อสมัครใช้หรือเข้าสู่ระบบ Unity Ads
สร้างโปรเจ็กต์
ในแดชบอร์ด Unity Ads ให้ไปที่ โปรเจ็กต์ แล้วคลิกสร้างโปรเจ็กต์
กรอกแบบฟอร์มแล้วคลิกสร้างโปรเจ็กต์เพื่อเพิ่มโปรเจ็กต์
ไปที่การสร้างรายได้ > เริ่มต้นใช้งาน แล้วคลิกเริ่มต้นใช้งาน
ในโมดัลการตั้งค่าโปรเจ็กต์ ให้เลือกฉันวางแผนที่จะใช้สื่อกลาง แล้วเลือก Google AdMob สำหรับพาร์ทเนอร์สื่อกลาง แล้วคลิกถัดไป
เลือกการตั้งค่าโฆษณา แล้วคลิกถัดไป
กรอกแบบฟอร์มแล้วคลิกเพิ่มโปรเจ็กต์
จดบันทึกรหัสเกม
สร้างหน่วยโฆษณา
ไปที่การสร้างรายได้ > หน่วยโฆษณา จากนั้นคลิกเพิ่มหน่วยโฆษณา
ป้อนชื่อหน่วยโฆษณา แล้วเลือกแพลตฟอร์มและรูปแบบโฆษณา
สุดท้าย คลิกสร้างเพื่อบันทึกหน่วยโฆษณา
เพิ่มตำแหน่ง
เมื่อสร้างโปรเจ็กต์แล้ว ให้ไปที่การสร้างรายได้ > ตำแหน่งโฆษณา ถึง สร้างตำแหน่งใหม่ ให้คลิกเพิ่มตำแหน่งสำหรับหน่วยโฆษณา
กรอกรายละเอียดที่จำเป็นแล้วคลิกเพิ่มตำแหน่ง
จดรหัสตำแหน่งโฆษณาไว้
ค้นหาคีย์ Unity Ads Reporting API
การเสนอราคา
ซึ่งไม่จำเป็นต้องทำขั้นตอนนี้สำหรับการผสานรวมการเสนอราคา
น้ำตก
นอกจากรหัสเกมและรหัสตำแหน่งแล้ว คุณจะต้องมี คีย์ API ของ Unity Ads และรหัสหลักขององค์กรสำหรับตั้งค่า Ad Manager รหัสหน่วยโฆษณา
ไปที่การสร้างรายได้ > การตั้งค่า > การจัดการ API และจดบันทึก ของคีย์การเข้าถึง API สถิติการสร้างรายได้
จากนั้นไปที่การสร้างรายได้ > การตั้งค่าองค์กร และจดบันทึก ของรหัสหลักขององค์กร
เปิดโหมดทดสอบ
สามารถเปิดใช้โหมดทดสอบได้จาก แดชบอร์ด Unity Ads ภายใต้แท็ก เลือกแท็บการทดสอบ
คุณบังคับใช้โหมดทดสอบสำหรับแอปได้โดยคลิกปุ่มแก้ไขด้านข้าง Google Play Store เลือกลบล้างโหมดการทดสอบไคลเอ็นต์ แล้วเลือก บังคับให้เปิดโหมดทดสอบ (เช่น ใช้โฆษณาทดสอบ) สำหรับอุปกรณ์ทั้งหมด
หรือจะเปิดใช้โหมดทดสอบสำหรับอุปกรณ์เฉพาะโดยคลิก ปุ่มเพิ่มอุปกรณ์ทดสอบ
กรอกแบบฟอร์มแล้วคลิกบันทึก
ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณา Unity ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสำหรับหน่วยโฆษณา
ลงชื่อเข้าใช้บัญชี Ad Manager
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่
ป้อนชื่อที่ไม่ซ้ำสำหรับกลุ่มผลตอบแทน ตั้งค่าสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกำหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาภายใต้พื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่คุณต้องการเพิ่มสื่อกลาง
จากนั้น คลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน
หากมีพาร์ทเนอร์ผลตอบแทนสำหรับUnity Adsอยู่แล้ว คุณก็เลือกได้ มิเช่นนั้น ให้เลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่
เลือก Unity Ads เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำ และเปิดใช้สื่อกลาง
เปิดการรวบรวมข้อมูลอัตโนมัติ แล้วป้อนAPI Key and Organization core ID ที่ได้รับในส่วนก่อนหน้า
เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม Android เป็นแพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนGame ID and Placement ID ที่ได้รับในส่วนก่อนหน้านี้ จากนั้นป้อนค่า CPM เริ่มต้น
คลิกบันทึกที่ด้านล่างของหน้าเมื่อทำเสร็จแล้ว
เพิ่ม Unity Ads ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม Unity Ads ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน Ad Manager
ขั้นตอนที่ 3: นำเข้า SDK โฆษณา Unity และอะแดปเตอร์
การผสานรวมกับ Android Studio (แนะนำ)
ในไฟล์ build.gradle.kts
ระดับแอป ให้เพิ่มการใช้งานต่อไปนี้
ทรัพยากร Dependency และการกำหนดค่า ใช้ Unity Ads SDK เวอร์ชันล่าสุด
และอะแดปเตอร์
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.unity3d.ads:unity-ads:4.12.1")
implementation("com.google.ads.mediation:unity:4.12.2.0")
}
การผสานรวมด้วยตนเอง
ดาวน์โหลด Unity Ads SDK (
unity-ads.aar
) เวอร์ชันล่าสุดจาก ที่เก็บของ GitHub แล้วเพิ่มลงในโครงการนำทางไปที่ อาร์ติแฟกต์ของอะแดปเตอร์ Unity Ads ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลด Unity ไฟล์
.aar
ของอะแดปเตอร์โฆษณา แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวบน Unity Ads SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้ความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้มีการเปิดเผยข้อมูลบางอย่าง และ ความยินยอมที่ได้รับจาก ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับ การใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นไปตาม ข้อกำหนดด้าน ePrivacy และการคุ้มครองข้อมูลทั่วไปของสหภาพยุโรป กฎระเบียบ (GDPR) เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่อาจรวบรวม ได้รับ หรือใช้ข้อมูลส่วนตัว และ ให้ข้อมูลเกี่ยวกับการใช้งานของแต่ละเครือข่าย ขณะนี้ Google ไม่สามารถ ส่งต่อตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติ
ใน SDK เวอร์ชัน 2.0.0 นั้น Unity Ads ได้เพิ่ม API เพื่อรองรับการตั้งค่าความเป็นส่วนตัว โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง Unity SDK โฆษณา หากคุณเลือกที่จะส่งข้อมูลความยินยอมไปยัง Unity Ads SDK ด้วยตนเอง จึงขอแนะนำให้เรียกโค้ดนี้ก่อนที่จะขอโฆษณา ผ่าน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
ดู Unity Ads Privacy Consent และ Data API และ การปฏิบัติตาม GDPR สําหรับรายละเอียดเพิ่มเติมและค่าที่ระบุในแต่ละวิธีได้
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
สหรัฐอเมริกา กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐ ต้องให้ผู้ใช้ได้รับ เพื่อเลือกไม่ใช้ "การลดราคา" ของ "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความ ข้อกำหนดดังกล่าว) โดยการเลือกไม่ใช้ที่นำเสนอผ่านโฆษณาว่า "อย่าขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นได้ชัด ข้อมูล" ลิงก์ใน "การขาย" หน้าแรกของพรรคการเมือง สหรัฐอเมริกา สถานะความเป็นส่วนตัว คู่มือการปฏิบัติตามกฎหมายช่วยให้คุณ การประมวลผลข้อมูลแบบจำกัด สําหรับการแสดงโฆษณาของ Google แต่ Google ใช้การตั้งค่านี้กับโฆษณาแต่ละรายการไม่ได้ เครือข่ายในเชนสื่อกลาง (Mediation Chain) ดังนั้น คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่าย ในเชนสื่อกลางที่สามารถเข้าร่วมการขาย และปฏิบัติตามคำแนะนำ จากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อ การปฏิบัติตามข้อกำหนด
ใน SDK เวอร์ชัน 2.0.0 นั้น Unity Ads ได้เพิ่ม API เพื่อรองรับการตั้งค่าความเป็นส่วนตัว โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง Unity SDK โฆษณา หากคุณเลือกที่จะส่งข้อมูลความยินยอมไปยัง Unity Ads SDK ด้วยตนเอง จึงขอแนะนำให้เรียกโค้ดนี้ก่อนที่จะขอโฆษณา ผ่าน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
ดู Unity Ads Privacy Consent และ Data API และ การปฏิบัติตาม CCPA สําหรับรายละเอียดเพิ่มเติมและค่าที่ระบุในแต่ละวิธีได้
ขั้นตอนที่ 5: เพิ่มโค้ดที่จําเป็น
ไม่ต้องมีโค้ดเพิ่มเติมสำหรับการผสานรวม Unity Ads ใดๆ
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager และเปิดใช้โหมดทดสอบใน Unity Ads UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก Unity Ads ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ Unity Ads (Waterfall) แหล่งที่มาของโฆษณา
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก Unity Ads
ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่แท้จริงจากการตอบกลับโฆษณาโดยใช้
วันที่
ResponseInfo.getAdapterResponses()
ในคลาสต่อไปนี้
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
วันที่
ต่อไปนี้เป็นรหัสและข้อความประกอบที่อะแดปเตอร์ UnityAds ส่งเมื่อ โฆษณาไม่โหลด:
รหัสข้อผิดพลาด | เหตุผล |
---|---|
0-10 | UnityAds SDK แสดงข้อผิดพลาด ดูรหัส เพื่อดูรายละเอียดเพิ่มเติม |
101 | พารามิเตอร์เซิร์ฟเวอร์ UnityAds ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง |
102 | UnityAds แสดงผลตำแหน่งที่มีสถานะ NO_FILL |
103 | UnityAds แสดงผลตำแหน่งที่มีสถานะ "ปิดใช้" |
104 | UnityAds พยายามแสดงโฆษณาที่มีบริบทเป็นค่าว่าง |
105 | บริบทที่ใช้ในการเริ่มต้น โหลด และ/หรือแสดงโฆษณาจาก Unity Ads ไม่ถือเป็นอินสแตนซ์กิจกรรม |
106 | UnityAds พยายามแสดงโฆษณาที่ไม่พร้อมแสดง |
107 | อุปกรณ์ไม่รองรับ UnityAds |
108 | UnityAds โหลดโฆษณาได้เพียง 1 รายการต่อตำแหน่งเท่านั้น |
109 | UnityAds ดำเนินการเสร็จสิ้นโดยมีสถานะ ERROR |
200-204 | ข้อผิดพลาดเฉพาะแบนเนอร์ UnityAds ดูรหัส เพื่อดูรายละเอียดเพิ่มเติม |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Android ของ Unity Ads
เวอร์ชัน 4.12.2.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.12.2 แล้ว
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 23.2.0
- Unity Ads SDK เวอร์ชัน 4.12.2
เวอร์ชัน 4.12.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.12.1 แล้ว
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 23.2.0
- Unity Ads SDK เวอร์ชัน 4.12.1
เวอร์ชัน 4.12.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.12.0 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 23.1.0
- Unity Ads SDK เวอร์ชัน 4.12.0
เวอร์ชัน 4.11.3.0
- เพิ่มการรองรับการเสนอราคาสําหรับรูปแบบโฆษณาแบนเนอร์ โฆษณาคั่นระหว่างหน้า และโฆษณาที่มีการให้รางวัล
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.11.3 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 23.1.0
- Unity Ads SDK เวอร์ชัน 4.11.3
เวอร์ชัน 4.11.2.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.11.2 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 23.0.0
- Unity Ads SDK เวอร์ชัน 4.11.2
เวอร์ชัน 4.10.0.0
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 23.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.10.0 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 23.0.0
- Unity Ads SDK เวอร์ชัน 4.10.0
เวอร์ชัน 4.9.3.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.9.3 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 22.6.0
- Unity Ads SDK เวอร์ชัน 4.9.3
เวอร์ชัน 4.9.2.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.9.2 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 22.3.0
- Unity Ads SDK เวอร์ชัน 4.9.2
เวอร์ชัน 4.9.1.0
- อัปเดต SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันขั้นต่ำที่ต้องใช้เป็น 22.3.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.9.1 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 22.3.0
- Unity Ads SDK เวอร์ชัน 4.9.1
เวอร์ชัน 4.8.0.0
- รายงานการแสดงโฆษณาเมื่อ SDK โฆษณา Unity Ads เรียกใช้ onBannerShow() ใหม่ Callback Method
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.8.0 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 22.2.0
- Unity Ads SDK เวอร์ชัน 4.8.0
เวอร์ชัน 4.7.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.7.1 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 22.1.0
- Unity Ads SDK เวอร์ชัน 4.7.1
เวอร์ชัน 4.7.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.7.0 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 22.0.0
- Unity Ads SDK เวอร์ชัน 4.7.0
เวอร์ชัน 4.6.1.1
- อัปเดตอะแดปเตอร์เพื่อใช้คลาส
VersionInfo
ใหม่ - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 22.0.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 22.0.0
- Unity Ads SDK เวอร์ชัน 4.6.1
เวอร์ชัน 4.6.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.6.1 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 21.5.0
- Unity Ads SDK เวอร์ชัน 4.6.1
เวอร์ชัน 4.6.0.0
- เพิ่มการรองรับการส่งต่อข้อมูล COPPA ไปยัง Unity Ads SDK
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.6.0 แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 21.5.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 21.5.0
- Unity Ads SDK เวอร์ชัน 4.6.0
เวอร์ชัน 4.5.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.5.0 แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 21.4.0
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 21.4.0
- Unity Ads SDK เวอร์ชัน 4.5.0
เวอร์ชัน 4.4.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.4.1 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 21.2.0
- SDK โฆษณา Unity เวอร์ชัน 4.4.1
เวอร์ชัน 4.4.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.4.0 แล้ว
- อัปเดต SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชันขั้นต่ำที่ต้องใช้เป็น 21.2.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 21.2.0
- Unity Ads SDK เวอร์ชัน 4.4.0
เวอร์ชัน 4.3.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.3.0 แล้ว
- ตอนนี้ระบบจะส่งต่อ Callback
onAdOpened()
เมื่อโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัลเริ่มเล่น
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 21.1.0
- Unity Ads SDK เวอร์ชัน 4.3.0
เวอร์ชัน 4.2.1.1
- อัปเดต
compileSdkVersion
และtargetSdkVersion
เป็น API 31 แล้ว - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 21.0.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 21.0.0
- Unity Ads SDK เวอร์ชัน 4.2.1
เวอร์ชัน 4.2.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.2.1 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- Unity Ads SDK เวอร์ชัน 4.2.1
เวอร์ชัน 4.1.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.1.0 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- Unity Ads SDK เวอร์ชัน 4.1.0
เวอร์ชัน 4.0.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.0.1 แล้ว
- อัปเดต Google Mobile Ads SDK เป็นเวอร์ชัน 20.6.0 ขั้นต่ำที่ต้องใช้
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- SDK โฆษณา Unity เวอร์ชัน 4.0.1
เวอร์ชัน 4.0.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.0.0 แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 20.5.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.5.0
- Unity Ads SDK เวอร์ชัน 4.0.0
เวอร์ชัน 3.7.5.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.7.5 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.2.0
- Unity Ads SDK เวอร์ชัน 3.7.5
เวอร์ชัน 3.7.4.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.7.4 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.2.0
- Unity Ads SDK เวอร์ชัน 3.7.4
เวอร์ชัน 3.7.2.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.7.2 แล้ว
- อัปเดต Google Mobile Ads SDK เป็นเวอร์ชัน 20.2.0 ขั้นต่ำที่ต้องใช้
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.2.0
- Unity Ads SDK เวอร์ชัน 3.7.2
เวอร์ชัน 3.7.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.7.1 แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 20.1.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 20.1.0
- Unity Ads SDK เวอร์ชัน 3.7.1
เวอร์ชัน 3.6.2.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.6.2 แล้ว
- แก้ไขปัญหาโฆษณาที่มีการให้รางวัลไม่ส่งต่อการเรียกกลับการคลิก
- เราได้นำ UnityAds SDK ออกจากบิลด์อะแดปเตอร์ที่รวมอยู่ในแพ็กเกจแล้ว ปัจจุบันผู้เผยแพร่โฆษณาต้องรวม UnityAds SDK เป็นทรัพยากร Dependency เพิ่มเติมด้วยตนเอง
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.8.0
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.8.0
- Unity Ads SDK เวอร์ชัน 3.6.2
เวอร์ชัน 3.6.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.6.0 แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.6.0
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.6.0
- Unity Ads SDK เวอร์ชัน 3.6.0
เวอร์ชัน 3.5.1.1
- แก้ไขปัญหาขณะพยายามขอโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัลหลายรายการ
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.5.0
- Unity Ads SDK เวอร์ชัน 3.5.1
เวอร์ชัน 3.5.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.5.1 แล้ว
- แก้ไขปัญหาที่ทำให้คำขอโฆษณาแบนเนอร์อัจฉริยะล้มเหลว
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.5.0
- Unity Ads SDK เวอร์ชัน 3.5.1
เวอร์ชัน 3.5.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.5.0 แล้ว
- เพิ่มการรองรับแบนเนอร์แบบปรับขนาดได้
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.5.0
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.5.0
- Unity Ads SDK เวอร์ชัน 3.5.0
เวอร์ชัน 3.4.8.0
- แก้ไขข้อผิดพลาด
NullPointerException
ที่เกิดขึ้นเมื่อโฆษณาแบนเนอร์ถูกทำลาย - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.3.0
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.3.0
- Unity Ads SDK เวอร์ชัน 3.4.8
เวอร์ชัน 3.4.6.1
- สร้างบิลด์อะแดปเตอร์ที่ไม่มี Unity Ads SDK รวมอยู่ในแพ็กเกจ
ซึ่งทำให้ผู้เผยแพร่โฆษณามีตัวเลือกในการใช้บริการ Unity Ads เมื่อเป็นสื่อกลางใน
Unity เพื่อหลีกเลี่ยงปัญหาทรัพยากร Dependency ที่ขัดแย้งกัน
- ผู้เผยแพร่โฆษณาสามารถเลือกใช้ตัวเลือกนี้โดยใส่
ทรัพยากร Dependency
com.google.ads.mediation:unity-adapter-only:x.y.z.p
build.gradle
ระดับแอป
- ผู้เผยแพร่โฆษณาสามารถเลือกใช้ตัวเลือกนี้โดยใส่
ทรัพยากร Dependency
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- Unity Ads SDK เวอร์ชัน 3.4.6
เวอร์ชัน 3.4.6.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.4.6 แล้ว
- ตอนนี้อะแดปเตอร์จะส่งต่อ Callback
onAdOpened()
เมื่อผู้ใช้คลิกโฆษณาแบนเนอร์
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- Unity Ads SDK เวอร์ชัน 3.4.6
เวอร์ชัน 3.4.2.3
- เพิ่มรหัสข้อผิดพลาดที่สื่อความหมายและเหตุผลที่โหลด/แสดงอะแดปเตอร์ไม่สำเร็จ
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.1.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 19.1.0
- Unity Ads SDK เวอร์ชัน 3.4.2
เวอร์ชัน 3.4.2.2
- แก้ไขข้อขัดข้อง
ConcurrentModificationException
ที่เกิดขึ้นเมื่อ Unity Ads แสดงผลข้อผิดพลาด
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.0.1
- Unity Ads SDK เวอร์ชัน 3.4.2
เวอร์ชัน 3.4.2.1
- ปรับปรุงการส่งต่อข้อผิดพลาดของ Unity เพื่อให้จดจำการเริ่มต้นและโหลดโฆษณาที่ดำเนินการไม่สำเร็จได้เร็วขึ้น และลดระยะหมดเวลา
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.0.1
สร้างและทดสอบด้วย:
- SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 19.0.1
- Unity Ads SDK เวอร์ชัน 3.4.2
เวอร์ชัน 3.4.2.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.4.2 แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.3.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- Unity Ads SDK เวอร์ชัน 3.4.2
เวอร์ชัน 3.4.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.4.0 แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.3.0
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- Unity Ads SDK เวอร์ชัน 3.4.0
เวอร์ชัน 3.3.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.3.0 แล้ว
สร้างและทดสอบด้วย:
- Google Mobile Ads SDK เวอร์ชัน 18.2.0
- Unity Ads SDK เวอร์ชัน 3.3.0
เวอร์ชัน 3.2.0.1
- แก้ไขข้อขัดข้องเกี่ยวกับข้อยกเว้นของตัวชี้แบบ Null ที่เกิดขึ้นเมื่อเรียกใช้
loadAd()
ก่อนโทรหาUnityAds.initialize()
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.2.0
เวอร์ชัน 3.2.0.0
- แก้ไขปัญหาที่ทำให้คำขอโฆษณาแบนเนอร์ไม่สำเร็จ
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.2.0 แล้ว
- ย้ายข้อมูลอะแดปเตอร์ไปยัง AndroidX แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.1.1
เวอร์ชัน 3.1.0.0
- เพิ่มการรองรับขนาดโฆษณาแบนเนอร์ที่ยืดหยุ่น
- อะแดปเตอร์ดำเนินการตามคำขอโฆษณาไม่สำเร็จหากขนาดที่ขอใช้ร่วมกันไม่ได้ แบนเนอร์โฆษณา Unity ขนาดใดก็ได้
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.1.0 แล้ว
เวอร์ชัน 3.0.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.0.1 แล้ว
- แก้ไขข้อบกพร่องที่ทำให้เกิด "NPE" ขณะแสดงโฆษณาคั่นระหว่างหน้า
เวอร์ชัน 3.0.0.2
- อัปเดตอะแดปเตอร์ให้รองรับ Reward API เวอร์ชันเบต้าแบบเปิดใหม่แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 17.2.0
เวอร์ชัน 3.0.0.1
- เพิ่มการรองรับแบนเนอร์โฆษณา Unity
เวอร์ชัน 3.0.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.0.0 แล้ว
เวอร์ชัน 2.3.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.3.0 แล้ว
เวอร์ชัน 2.2.1.1
- อัปเดตอะแดปเตอร์ให้เรียกใช้เหตุการณ์โฆษณา
onRewardedVideoComplete()
เวอร์ชัน 2.2.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.2.1 แล้ว
เวอร์ชัน 2.2.0.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.2.0 แล้ว
เวอร์ชัน 2.1.2.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.1.2 แล้ว
เวอร์ชัน 2.1.1.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.1.1 แล้ว
เวอร์ชัน 2.1.0.0
- อัปเดตอะแดปเตอร์ให้สามารถใช้งานร่วมกับ Unity Ads SDK 2.1.0 ได้
เวอร์ชัน 2.0.8.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.0.8 แล้ว
เวอร์ชัน 2.0.7.0
- การใช้การรายงานการคลิกของ Unity Ads (สถิติการคลิกของ AdMob และ Unity Ads จะ ที่ตรงกัน)
- เพิ่มการสนับสนุน Callback onAdLeftApplication
เวอร์ชัน 2.0.6.0
- ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.0.6 แล้ว
เวอร์ชัน 2.0.5.0
- โดยเพิ่มอะแดปเตอร์เป็นทรัพยากร Dependency ของคอมไพล์ได้โดยการเพิ่มรายการต่อไปนี้
ไปยังแท็ก Dependencies ของไฟล์build.gradle:
compile 'com.google.ads.mediation:unity:2.0.5.0'
- ย้ายไปกระจายอะแดปเตอร์เป็น Aar แทนไฟล์ Jar (โปรดดู README สำหรับคำแนะนำเพิ่มเติม)
เวอร์ชัน 2.0.4.0
- แก้ไขข้อบกพร่องที่ทำให้โฆษณาวิดีโอที่มีการให้รางวัลโหลดไม่สำเร็จเมื่อ โหลดโฆษณาคั่นระหว่างหน้าก่อน
เวอร์ชัน 2.0.2.0
- เปลี่ยนระบบการตั้งชื่อเวอร์ชันเป็น [เวอร์ชัน Unity Ads SDK][เวอร์ชันแพตช์ของอะแดปเตอร์]
- อัปเดต SDK โฆษณา Unity Ads ขั้นต่ำที่ต้องใช้เป็น v2.0.2
- อัปเดต SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จำเป็นเป็น v9.0.0
- แอปไม่จําเป็นต้องเรียกใช้ UnityAds.changeActivity(this) อีกต่อไป
เวอร์ชัน 1.0.0
- การเผยแพร่ครั้งแรก รองรับโฆษณาวิดีโอที่มีการให้รางวัลและโฆษณาคั่นระหว่างหน้า