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

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

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

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

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

1 การผสานการเสนอราคาอยู่ในรุ่นเบต้าแบบเปิด

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

จดรหัสตําแหน่งโฆษณาไว้

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

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

การเสนอราคา

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

น้ำตก

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

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

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

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

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

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

กรอกแบบฟอร์มแล้วคลิกบันทึก

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

ลงชื่อเข้าใช้บัญชี Ad Manager

เพิ่ม Unity Ads ในบริษัท

การเสนอราคา

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

น้ำตก

ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา

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

คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อเสร็จแล้ว

เปิดใช้การแชร์สัญญาณที่ปลอดภัย

การเสนอราคา

ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บการตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก

น้ำตก

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

แชร์สัญญาณที่ปลอดภัยในคำขอราคาเสนอ

การเสนอราคา

ไปที่พื้นที่โฆษณา > สัญญาณที่ปลอดภัย ในส่วนสัญญาณที่ปลอดภัย ให้ค้นหา Unity Ads แล้วเปิดเปิดใช้การผสานรวมแอป

คลิกบันทึก

น้ำตก

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

อนุญาตการแชร์สัญญาณที่ปลอดภัยสําหรับการเสนอราคา SDK

การเสนอราคา

ไปที่การแสดงโฆษณา > การตั้งค่าแชแนลดีมานด์ ในแท็บการตั้งค่าเริ่มต้น ให้เปิดอนุญาตการแชร์สัญญาณที่ปลอดภัยสําหรับSDK bidding

คลิกบันทึก

น้ำตก

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

กำหนดค่าการเสนอราคาของ Unity Ads

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

คลิกผู้เสนอราคารายใหม่

เลือก Unity Ads เป็นผู้เสนอราคา

คลิกดำเนินการต่อเพื่อเปิดใช้การเสนอราคา SDK สำหรับผู้เสนอราคารายนี้

คลิกเสร็จสิ้น

น้ำตก

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

กำหนดค่าการแมปหน่วยโฆษณา

การเสนอราคา

ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกไปที่การเสนอราคา SDK

เลือกบริษัทสําหรับ Unity Ads

ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่

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

น้ำตก

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

เลื่อนลงแล้วคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน

เลือกบริษัทที่คุณสร้างไว้สําหรับ Unity Ads ในส่วนก่อนหน้า เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม, Android เป็นแพลตฟอร์ม และใช้งานอยู่เป็นสถานะ

ป้อนรหัสเกมและรหัสตำแหน่งโฆษณาที่ได้ในส่วนก่อนหน้า รวมถึงค่า CPM เริ่มต้น คลิกบันทึก

หมายเหตุ: การรวบรวมข้อมูลอัตโนมัติต้องใช้เวลารวบรวมข้อมูล 2-3 วันก่อนที่จะคำนวณค่า CPM แบบไดนามิกสำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ เมื่อคำนวณ eCPM ได้แล้ว ระบบจะอัปเดตข้อมูลในนามของคุณโดยอัตโนมัติ

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.unity3d.ads:unity-ads:4.13.1")
    implementation("com.google.ads.mediation:unity:4.13.1.0")
}

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

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

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

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

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

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

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()

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

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

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

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

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 ของข้อมูล และการปฏิบัติตาม CCPA ของ Unity Ads

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

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

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

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

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

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

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

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

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

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

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

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

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

เวอร์ชัน 4.13.1.0

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

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.6.0
  • Unity Ads SDK เวอร์ชัน 4.13.1

เวอร์ชัน 4.13.0.0

  • นำการตรวจสอบบริบท Activity ที่ไม่จำเป็นออกจากอะแดปเตอร์
  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.13.0

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.6.0
  • Unity Ads SDK เวอร์ชัน 4.13.0

เวอร์ชัน 4.12.5.1

  • แก้ไขการโหลดโฆษณาแบนเนอร์สำหรับการเสนอราคาไม่สำเร็จโดยการตั้งค่ารหัสออบเจ็กต์เมื่อโหลดโฆษณา

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.6.0
  • Unity Ads SDK เวอร์ชัน 4.12.5

เวอร์ชัน 4.12.5.0

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

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.5.0
  • Unity Ads SDK เวอร์ชัน 4.12.5

เวอร์ชัน 4.12.4.0

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

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.3.0
  • Unity Ads SDK เวอร์ชัน 4.12.4

เวอร์ชัน 4.12.3.0

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

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.3.0
  • Unity Ads SDK เวอร์ชัน 4.12.3

เวอร์ชัน 4.12.2.0

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

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 23.2.0
  • Unity Ads SDK เวอร์ชัน 4.12.2

เวอร์ชัน 4.12.1.0

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

สร้างขึ้นและทดสอบด้วย

  • Google Mobile Ads SDK เวอร์ชัน 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

  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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

  • อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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 เรียกใช้เมธอด callback ใหม่ของ onBannerShown()
  • ยืนยันความเข้ากันได้กับ 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 ใหม่
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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
  • อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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
  • อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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
  • อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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 แล้ว
  • อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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
  • Unity Ads SDK เวอร์ชัน 4.0.1

เวอร์ชัน 4.0.0.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.0.0
  • อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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
  • อัปเดตเวอร์ชันขั้นต่ำของ Google Mobile Ads SDK เป็น 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 เพิ่มเติม
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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
  • เพิ่มการรองรับแบนเนอร์แบบปรับขนาดได้
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 19.5.0

สร้างขึ้นและทดสอบด้วย

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

เวอร์ชัน 3.4.8.0

  • แก้ไขข้อผิดพลาด NullPointerException ที่เกิดขึ้นเมื่อมีการทำลายโฆษณาแบนเนอร์
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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 เพื่อหลีกเลี่ยงปัญหาการพึ่งพาที่ขัดแย้งกัน
    • ผู้เผยแพร่โฆษณาอาจเลือกใช้โดยระบุcom.google.ads.mediation:unity-adapter-only:x.y.z.p Dependency ในไฟล์ 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

  • เพิ่มรหัสข้อผิดพลาดที่สื่อความหมายและสาเหตุของการโหลด/แสดงอะแดปเตอร์ไม่สำเร็จ
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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 เพื่อตรวจหาการเริ่มต้นและโหลดโฆษณาที่ไม่สําเร็จได้เร็วขึ้นและลดการหมดเวลา
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 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 Pointer ที่จะเกิดขึ้นเมื่อเรียกใช้ loadAd() ก่อนเรียกใช้ UnityAds.initialize()
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น 18.2.0

เวอร์ชัน 3.2.0.0

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

เวอร์ชัน 3.0.0.1

  • เพิ่มการรองรับแบนเนอร์ Unity Ads

เวอร์ชัน 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 การคอมไพล์ได้โดยเพิ่มข้อมูลต่อไปนี้ลงในแท็ก 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 version].[adapter patch version]
  • อัปเดต Unity Ads SDK เวอร์ชันขั้นต่ำที่จำเป็นเป็น v2.0.2
  • อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำเป็น v9.0.0
  • แอปไม่จําเป็นต้องเรียก UnityAds.changeActivity(this) อีกต่อไป

เวอร์ชัน 1.0.0

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