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

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

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

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

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

ข้อกำหนด

• API ระดับ 23 ขึ้นไปของ Android

• [สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้ Unity Adapter 4.11.3.0 ขึ้นไป (ขอแนะนำให้ใช้เวอร์ชันล่าสุด)

• Google Mobile Ads SDK เวอร์ชันล่าสุด

• ทําตามคู่มือเริ่มต้นใช้งานสื่อกลาง

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ค้นหาคีย์ 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 > การทดสอบ

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

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

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

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

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

คุณต้องเพิ่ม Unity Ads ลงในการกำหนดค่าสื่อกลางสำหรับหน่วยโฆษณา

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

หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง

ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป

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

เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่ อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น

ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่แสดงหน่วยโฆษณาที่คุณเลือก

เพิ่ม Unity Ads เป็นแหล่งที่มาของโฆษณา

การเสนอราคา

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

คลิกวิธีลงนามในข้อตกลงสำหรับพาร์ทเนอร์และ ตั้งค่าการเป็นพาร์ทเนอร์การเสนอราคากับ Unity Ads



คลิกรับทราบและยอมรับ แล้วคลิกต่อไป



หากมีการแมปสำหรับ Unity Ads อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป



จากนั้นป้อน รหัสเกมและรหัสตําแหน่ง ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

น้ำตก

ในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา ให้เลือกเพิ่มแหล่งที่มาของโฆษณา

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



หากมีการแมปสำหรับ Unity Ads อยู่แล้ว คุณสามารถเลือกการแมปนั้นได้ หากไม่ ให้คลิกเพิ่มการแมป

จากนั้นป้อน รหัสเกมและรหัสตำแหน่ง ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

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

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

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

การผสานรวม Android Studio (แนะนํา)

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.4.0")
    implementation("com.unity3d.ads:unity-ads:4.15.0")
    implementation("com.google.ads.mediation:unity:4.15.1.0")
}

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

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

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

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

ความยินยอมจากผู้ใช้ในสหภาพยุโรปและ GDPR

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

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

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

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

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

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

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

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

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

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

โหลดโฆษณาด้วยบริบทของกิจกรรม

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

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

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

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

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

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

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

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

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

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

บันทึกการเปลี่ยนแปลงของ Unity Ads Android Mediation Adapter

เวอร์ชัน 4.15.1.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 24.4.0
• SDK ของ Unity Ads เวอร์ชัน 4.15.1

เวอร์ชัน 4.15.0.0

• อัปเดตให้รวบรวมสัญญาณสำหรับโฆษณาแบนเนอร์ RTB ไม่สำเร็จหากบริบทไม่ใช่กิจกรรม (เนื่องจาก Unity Ads SDK ต้องใช้บริบทกิจกรรมเพื่อโหลดโฆษณาแบนเนอร์ RTB) การแก้ไขนี้จะเพิ่มอัตราความสำเร็จในการโหลดโฆษณาของผู้เผยแพร่โฆษณา
• ยืนยันความเข้ากันได้กับ Unity Ads SDK 4.15.0

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 24.3.0
• Unity Ads SDK เวอร์ชัน 4.15.0

เวอร์ชัน 4.14.2.0

• ได้รับการยืนยันว่าเข้ากันได้กับ Unity Ads SDK 4.14.2

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

• Google Mobile Ads SDK เวอร์ชัน 24.2.0
• Unity Ads SDK เวอร์ชัน 4.14.2

เวอร์ชัน 4.14.1.0

• ความเข้ากันได้ที่ได้รับการยืนยันกับ Unity Ads SDK 4.14.1

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

• Google Mobile Ads SDK เวอร์ชัน 24.1.0
• Unity Ads SDK เวอร์ชัน 4.14.1

เวอร์ชัน 4.14.0.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ Unity Ads SDK 4.14.0 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 24.0.0
• Unity Ads SDK เวอร์ชัน 4.14.0

เวอร์ชัน 4.13.2.0

• อัปเดตระดับ API ขั้นต่ำของ Android ที่จำเป็นเป็น 23
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 24.0.0

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

• Google Mobile Ads SDK เวอร์ชัน 24.0.0
• Unity Ads SDK เวอร์ชัน 4.13.2

เวอร์ชัน 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
• SDK ของ Unity Ads เวอร์ชัน 4.12.5

เวอร์ชัน 4.12.5.0

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

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

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

เวอร์ชัน 4.12.2.0

• ได้รับการยืนยันว่าใช้งานร่วมกับ Unity Ads SDK 4.12.2 ได้

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

• Google Mobile Ads SDK เวอร์ชัน 23.2.0
• SDK โฆษณา Unity เวอร์ชัน 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
• SDK โฆษณา Unity เวอร์ชัน 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
• SDK โฆษณา Unity เวอร์ชัน 4.9.3

เวอร์ชัน 4.9.2.0

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

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

• Google Mobile Ads SDK เวอร์ชัน 22.3.0
• SDK โฆษณา Unity เวอร์ชัน 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 เรียกใช้เมธอดเรียกกลับ 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
• SDK ของ Unity Ads เวอร์ชัน 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() Callback เมื่อโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัลเริ่มเล่น

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

• 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

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 21.0.0
• SDK โฆษณา Unity เวอร์ชัน 4.2.1

เวอร์ชัน 4.2.1.0

• ได้รับการยืนยันว่าเข้ากันได้กับ Unity Ads SDK 4.2.1

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

• Google Mobile Ads SDK เวอร์ชัน 20.6.0
• SDK โฆษณา Unity เวอร์ชัน 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

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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
• SDK ของ Unity Ads เวอร์ชัน 3.7.2

เวอร์ชัน 3.7.1.0

• ความเข้ากันได้ที่ได้รับการยืนยันกับ Unity Ads SDK 3.7.1
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น 20.1.0

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 20.1.0
• SDK ของ Unity Ads เวอร์ชัน 3.7.1

เวอร์ชัน 3.6.2.0

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

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

• 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

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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

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

• SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เวอร์ชัน 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()
• อัปเดต 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'
• เปลี่ยนไปใช้การเผยแพร่ Adapter เป็นไฟล์ AAR แทนไฟล์ JAR (ดูคำแนะนำเพิ่มเติมใน README)

เวอร์ชัน 2.0.4.0

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

เวอร์ชัน 2.0.2.0

• เปลี่ยนระบบการตั้งชื่อเวอร์ชันเป็น [เวอร์ชัน SDK ของ Unity Ads].[เวอร์ชันแพตช์ของอะแดปเตอร์]
• อัปเดต Unity Ads SDK ขั้นต่ำที่จำเป็นเป็น v2.0.2
• อัปเดต Google Mobile Ads SDK เวอร์ชันขั้นต่ำที่กำหนดเป็น v9.0.0
• แอปไม่จำเป็นต้องเรียกใช้ UnityAds.changeActivity(this) อีกต่อไป

เวอร์ชัน 1.0.0

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