ผสานรวมโฆษณา Unity กับสื่อกลาง

คู่มือนี้แสดงวิธีใช้ 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

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

คุณเปิดใช้โหมดทดสอบได้จากแดชบอร์ด 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")
}

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

1. ดาวน์โหลด Unity Ads SDK (unity-ads.aar) เวอร์ชันล่าสุดจาก ที่เก็บของ GitHub แล้วเพิ่มลงในโครงการ

2. นำทางไปที่ อาร์ติแฟกต์ของอะแดปเตอร์ 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

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

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

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

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 ส่งเมื่อ โฆษณาไม่โหลด:

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง 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 แล้ว
• อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 แล้ว
• แก้ไขปัญหาโฆษณาที่มีการให้รางวัลไม่ส่งต่อ Callback ของการคลิก
• เราได้นำ 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 ระดับแอป

สร้างและทดสอบด้วย:

• 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

• การเผยแพร่ครั้งแรก รองรับโฆษณาวิดีโอที่มีการให้รางวัลและโฆษณาคั่นระหว่างหน้า