คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Unity Ads โดยใช้ สื่อกลาง AdMob ซึ่งครอบคลุมการผสานรวม Waterfall ซึ่งจะอธิบายวิธีเพิ่ม Unity Ads ลงในการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม Unity Ads SDK และอะแดปเตอร์ลงใน Android แอป
การผสานรวมและรูปแบบโฆษณาที่รองรับ
อะแดปเตอร์สื่อกลางสําหรับ Unity Ads มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | 1 |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
1 การผสานรวมการเสนอราคาอยู่ในรุ่นเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง
ข้อกำหนด
Android API ระดับ 21 ขึ้นไป
[สำหรับการเสนอราคา]: หากต้องการผสานรวมรูปแบบโฆษณาที่รองรับทั้งหมดในการเสนอราคา ให้ใช้อะแดปเตอร์ Unity 4.11.3.0 ขึ้นไป (ขอแนะนําให้ใช้เวอร์ชันล่าสุด)
Google Mobile Ads SDK เวอร์ชันล่าสุด
สื่อกลางเสร็จสมบูรณ์ คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งค่าการกําหนดค่าใน UI ของ Unity Ads
ลงชื่อสมัครใช้หรือเข้าสู่ระบบ Unity Ads
สร้างโปรเจ็กต์
ในแดชบอร์ด Unity Ads ให้ไปที่โปรเจ็กต์ แล้วคลิกสร้างโปรเจ็กต์
กรอกแบบฟอร์มและคลิกสร้างโปรเจ็กต์เพื่อเพิ่มโปรเจ็กต์
ไปที่การสร้างรายได้ > เริ่มต้นใช้งาน แล้วคลิกเริ่มต้นใช้งาน
ในโมดัลการตั้งค่าโปรเจ็กต์ ให้เลือกฉันวางแผนที่จะใช้สื่อกลางและ Google AdMob สำหรับพาร์ทเนอร์สื่อกลาง แล้วคลิกถัดไป
เลือกการตั้งค่าโฆษณา แล้วคลิกถัดไป
กรอกแบบฟอร์มแล้วคลิกเพิ่มโปรเจ็กต์
จดรหัสเกมไว้
สร้างหน่วยโฆษณา
ไปที่การสร้างรายได้ > หน่วยโฆษณา แล้วคลิกเพิ่มหน่วยโฆษณา
ป้อนชื่อหน่วยโฆษณา แล้วเลือกแพลตฟอร์มและรูปแบบโฆษณา
สุดท้าย ให้คลิกสร้างเพื่อบันทึกหน่วยโฆษณา
เพิ่มตําแหน่งโฆษณา
การเสนอราคา
ติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google เพื่อสร้างตําแหน่งการเสนอราคา
น้ำตก
เมื่อสร้างโปรเจ็กต์แล้ว ให้ไปที่การสร้างรายได้ > ตําแหน่งโฆษณา หากต้องการสร้างตําแหน่งโฆษณาใหม่ ให้คลิกเพิ่มตําแหน่งโฆษณาสําหรับหน่วยโฆษณา
กรอกรายละเอียดที่จําเป็น แล้วคลิกเพิ่มตําแหน่งโฆษณา
จดรหัสตําแหน่งโฆษณาไว้
ค้นหาคีย์ Unity Ads Reporting API
การเสนอราคา
ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
นอกจากรหัสเกมและรหัสตําแหน่งแล้ว คุณจะต้องมีคีย์ API และรหัสหลักขององค์กร Unity Ads สำหรับการตั้งค่ารหัสหน่วยโฆษณา AdMob ด้วย
ไปที่การสร้างรายได้ > การตั้งค่า > การจัดการ API และจดบันทึกคีย์เข้าถึง Monetization Stats API
จากนั้นไปที่การสร้างรายได้ > การตั้งค่าองค์กร แล้วจดรหัสหลักขององค์กรไว้
เปิดโหมดทดสอบ
คุณเปิดใช้โหมดทดสอบได้จากหน้าแดชบอร์ด Unity Ads เลือกแท็บการทดสอบในการตั้งค่าโปรเจ็กต์
คุณสามารถบังคับใช้โหมดทดสอบสําหรับแอปได้โดยคลิกปุ่มแก้ไขข้าง Google Play Store เลือกลบล้างโหมดทดสอบไคลเอ็นต์ แล้วเลือกเปิดโหมดทดสอบ (ใช้โฆษณาทดสอบ) สําหรับอุปกรณ์ทั้งหมด
หรือคุณจะเปิดใช้โหมดทดสอบสำหรับอุปกรณ์ที่เฉพาะเจาะจงได้โดยคลิกปุ่มเพิ่มอุปกรณ์ทดสอบ
กรอกแบบฟอร์มแล้วคลิกบันทึก
ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณา Unity Ads ใน AdMob UI
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
คุณต้องเพิ่ม Unity Ads ลงในการกำหนดค่าการแสดงโฆษณาสื่อกลางสําหรับหน่วยโฆษณา
ก่อนอื่น ให้ลงชื่อเข้าใช้บัญชี AdMob จากนั้นไปที่แท็บสื่อกลาง หากมีกลุ่มสื่อกลางที่มีอยู่ซึ่งต้องการแก้ไข ให้คลิกชื่อกลุ่มสื่อกลางนั้นเพื่อแก้ไข แล้วข้ามไปเพิ่ม Unity Ads เป็นแหล่งที่มาของโฆษณา
หากต้องการสร้างกลุ่มสื่อกลางใหม่ ให้เลือกสร้างกลุ่มสื่อกลาง
ป้อนรูปแบบโฆษณาและแพลตฟอร์ม แล้วคลิกต่อไป
ตั้งชื่อกลุ่มสื่อกลาง แล้วเลือกสถานที่ที่จะกําหนดเป้าหมาย ถัดไป ให้ตั้งค่าสถานะกลุ่มสื่อกลางเป็นเปิดใช้ แล้วคลิกเพิ่มหน่วยโฆษณา
เชื่อมโยงกลุ่มสื่อกลางนี้กับหน่วยโฆษณา AdMob ที่มีอยู่อย่างน้อย 1 หน่วย จากนั้นคลิกเสร็จสิ้น
ตอนนี้คุณควรเห็นการ์ดหน่วยโฆษณาที่สร้างขึ้นด้วยหน่วยโฆษณาที่คุณเลือก
เพิ่ม Unity Ads เป็นแหล่งที่มาของโฆษณา
เลือกเพิ่มแหล่งที่มาของโฆษณาในการ์ด Waterfall ในส่วนแหล่งที่มาของโฆษณา จากนั้นเลือก Unity Ads
เลือก Unity Ads แล้วเปิดใช้สวิตช์เพิ่มประสิทธิภาพ ป้อนคีย์ API และรหัสหลักขององค์กรที่ได้ในส่วนก่อนหน้าเพื่อตั้งค่าการเพิ่มประสิทธิภาพแหล่งที่มาของโฆษณาสําหรับ Unity Ads จากนั้นป้อนค่า eCPM สําหรับ Unity Ads แล้วคลิกต่อไป
หากมีการแมปสำหรับ Unity Ads อยู่แล้ว ให้เลือกการแมปนั้น หรือคลิกเพิ่มการแมป
จากนั้นป้อนรหัสเกมและรหัสตำแหน่งโฆษณาที่ได้ในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น
เพิ่ม Unity Ads ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนในการตั้งค่า GDPR และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม Unity Ads ลงในรายชื่อพาร์ทเนอร์โฆษณา GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob
ขั้นตอนที่ 3: นําเข้า SDK และอะแดปเตอร์ Unity Ads
การผสานรวม Android Studio (แนะนำ)
ในไฟล์ build.gradle.kts
ระดับแอป ให้เพิ่มข้อกําหนดในการนําไปใช้และการกำหนดค่าต่อไปนี้ ใช้ Unity Ads SDK และอะแดปเตอร์เวอร์ชันล่าสุด
dependencies {
implementation("com.google.android.gms:play-services-ads:23.5.0")
implementation("com.unity3d.ads:unity-ads:4.12.4")
implementation("com.google.ads.mediation:unity:4.12.4.0")
}
การผสานรวมด้วยตนเอง
ดาวน์โหลด Unity Ads SDK เวอร์ชันล่าสุด (
unity-ads.aar
) จากที่เก็บ GitHub แล้วเพิ่มลงในโปรเจ็กต์ไปที่อาร์ติแฟกต์อะแดปเตอร์ Unity Ads ในที่เก็บ Maven ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์
.aar
ของ Unity Ad Adapter แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน Unity Ads SDK
ความยินยอมของผู้ใช้ EU และ GDPR
ภายใต้นโยบายความยินยอมของผู้ใช้ 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 API และการปฏิบัติตามข้อกําหนด GDPR ของ Unity Ads การปฏิบัติตามข้อกําหนด GDPR
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กำหนดให้ผู้ใช้มีสิทธิเลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยเว็บไซต์จะต้องให้ตัวเลือกไม่รับการขายผ่านลิงก์ "ไม่อนุญาตให้ขายข้อมูลส่วนบุคคลของฉัน" ที่แสดงไว้อย่างชัดเจนบนหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสําหรับการแสดงโฆษณาของ 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 และการปฏิบัติตามข้อกำหนดของ CCPA ของ Unity Ads
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
ไม่จำเป็นต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม Unity Ads
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสำหรับ AdMob และเปิดใช้โหมดทดสอบใน 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 ที่กําหนดค่าใน AdMob UI ขาดหายไป/ไม่ถูกต้อง |
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.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
- การเผยแพร่ครั้งแรก รองรับโฆษณาวิดีโอที่มีการให้รางวัลและโฆษณาคั่นระหว่างหน้า