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

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

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

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

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

ข้อกำหนด

  • Android API ระดับ 19 ขึ้นไป

ขั้นตอนที่ 1: ตั้งการกําหนดค่าใน UI ของ Unity Ads

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

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

ในแดชบอร์ดโฆษณา Unity ให้ไปที่โปรเจ็กต์ แล้วคลิกสร้างโปรเจ็กต์

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

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

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

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

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

จดรหัสเกมไว้

สร้างหน่วยโฆษณา

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

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

สุดท้าย คลิกสร้างเพื่อบันทึกหน่วยโฆษณา

เพิ่มตำแหน่ง

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

กรอกรายละเอียดที่จำเป็นแล้วคลิกเพิ่มตำแหน่ง

โปรดจดรหัสตำแหน่งไว้

เรียกดูข้อมูลเข้าสู่ระบบของคุณ

นอกเหนือจากรหัสเกมและรหัสตำแหน่งแล้ว คุณยังต้องใช้คีย์ 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: นำเข้า Unity Ads SDK และอะแดปเตอร์

ในไฟล์ build.gradle.kts ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าต่อไปนี้ ใช้อะแดปเตอร์และ Unity Ads SDK เวอร์ชันล่าสุด

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.unity3d.ads:unity-ads:4.9.3")
    implementation("com.google.ads.mediation:unity:4.9.3.0")
}

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

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

  2. ไปที่อาร์ติแฟกต์ของอะแดปเตอร์ Unity Ads ใน Maven Repository ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ Unity Ads แล้วเพิ่มลงในโปรเจ็กต์

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

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

ใน SDK เวอร์ชัน 2.0.0 Unity Ads ได้เพิ่ม API เพื่อรองรับการตั้งค่าความเป็นส่วนตัว โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง Unity Ads 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()

โปรดดูรายละเอียดเพิ่มเติมและค่าที่จะได้รับในแต่ละวิธีใน ความยินยอมด้านความเป็นส่วนตัวและ API ข้อมูลของ Unity Ads และ การปฏิบัติตาม GDPR

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

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

ใน SDK เวอร์ชัน 2.0.0 Unity Ads ได้เพิ่ม API เพื่อรองรับการตั้งค่าความเป็นส่วนตัว โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมนี้ไปยัง Unity Ads 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()

ดูความยินยอมด้านความเป็นส่วนตัวและ API ข้อมูลของ Unity Ads และ การปฏิบัติตาม CCPA เพื่อดูรายละเอียดเพิ่มเติมและค่าที่ระบุไว้ในแต่ละวิธี

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

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

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

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

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

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

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

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

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

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 ดูรายละเอียดเพิ่มเติมได้ที่รหัส
0-9 UnityAds SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Unity
101 พารามิเตอร์เซิร์ฟเวอร์ UnityAds ที่กำหนดค่าใน Ad Manager UI ขาดหายไป/ไม่ถูกต้อง
102 UnityAds ไม่รองรับอุปกรณ์นี้
103 UnityAds เสร็จสิ้นการนำเสนอด้วยสถานะข้อผิดพลาด kUnityAdsFinishStateError
104 ออบเจ็กต์โฆษณา Unity เป็นศูนย์หลังจากเรียกใช้ตัวเริ่มต้น
105 แสดงโฆษณา Unity ไม่สำเร็จเนื่องจากโฆษณาไม่พร้อม
106 UnityAds ที่เรียกว่า โค้ดเรียกกลับที่เปลี่ยนตำแหน่งด้วยสถานะตำแหน่ง kUnityAdsPositionStateNoFill
107 UnityAds ที่เรียกว่า ตำแหน่ง ที่เปลี่ยนโค้ดเรียกกลับโดยมีสถานะตำแหน่ง kUnityAdsPositionStateDisabled
108 โหลดโฆษณาสำหรับตำแหน่งนี้แล้ว UnityAds SDK ไม่รองรับการโหลดโฆษณาหลายรายการสำหรับตำแหน่งเดียวกัน

บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Android สำหรับ Unity Ads

เวอร์ชัน 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

  • รายงานการแสดงโฆษณาเมื่อ Unity Ads SDK เรียกใช้เมธอดโค้ดเรียกกลับ onBanner video() ใหม่
  • ยืนยันความเข้ากันได้กับ 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

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 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
  • Unity Ads SDK เวอร์ชัน 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
  • ตอนนี้ระบบจะส่งต่อโค้ดเรียกกลับ 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
  • Unity Ads SDK เวอร์ชัน 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
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 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

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.8.0
  • Unity Ads SDK เวอร์ชัน 3.6.2

เวอร์ชัน 3.6.0.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.6.0
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กำหนดเป็น 19.6.0

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.6.0
  • Unity Ads SDK เวอร์ชัน 3.6.0

เวอร์ชัน 3.5.1.1

  • แก้ไขปัญหาเมื่อพยายามขอโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัลหลายรายการ

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.5.0
  • Unity Ads SDK เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.1.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.5.1
  • แก้ไขปัญหาที่ทำให้คำขอโฆษณาแบนเนอร์อัจฉริยะล้มเหลว

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.5.0
  • Unity Ads SDK เวอร์ชัน 3.5.1

เวอร์ชัน 3.5.0.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.5.0
  • เพิ่มการรองรับแบนเนอร์แบบปรับขนาดได้
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 19.5.0

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.5.0
  • Unity Ads SDK เวอร์ชัน 3.5.0

เวอร์ชัน 3.4.8.0

  • แก้ไขข้อผิดพลาด NullPointerException ที่เกิดขึ้นเมื่อโฆษณาแบนเนอร์ถูกทำลาย
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กำหนดเป็น 19.3.0

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.3.0
  • Unity Ads SDK เวอร์ชัน 3.4.8

เวอร์ชัน 3.4.6.1

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

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 19.0.1
  • Unity Ads SDK เวอร์ชัน 3.4.2

เวอร์ชัน 3.4.2.1

  • ปรับปรุงการส่งต่อข้อผิดพลาดของ Unity เพื่อให้ทราบถึงการเริ่มต้นและความล้มเหลวในการโหลดโฆษณาก่อนหน้านี้และลดการหมดเวลา
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กําหนดเป็น 19.0.1

สร้างและทดสอบกับ

  • Google Mobile Ads SDK เวอร์ชัน 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 Ads
  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.1.0

เวอร์ชัน 3.0.1.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.0.1
  • แก้ไขข้อบกพร่องที่ทำให้เกิด "NPE" ขณะแสดงโฆษณาคั่นระหว่างหน้า

เวอร์ชัน 3.0.0.2

  • อัปเดตอะแดปเตอร์ให้รองรับ Rewarded 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 จะตรงกัน)
  • เพิ่มการสนับสนุนการติดต่อกลับ onAdLeftApplication แล้ว

เวอร์ชัน 2.0.6.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 2.0.6

เวอร์ชัน 2.0.5.0

  • ตอนนี้คุณเพิ่มอะแดปเตอร์เป็นทรัพยากร Dependency ของคอมไพล์ได้แล้วโดยการเพิ่มข้อมูลต่อไปนี้ ลงในแท็กทรัพยากร Dependency ของไฟล์ create.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][เวอร์ชันแพตช์อะแดปเตอร์]
  • อัปเดต Unity Ads SDK ขั้นต่ำที่จำเป็นเป็นเวอร์ชัน 2.0.2 แล้ว
  • อัปเดต SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น v9.0.0 แล้ว
  • แอปไม่จำเป็นต้องเรียกใช้ UnityAds.changeActivity(this) อีกต่อไป

เวอร์ชัน 1.0.0

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