คู่มือนี้จะแสดงวิธีใช้ Google Mobile Ads SDK เพื่อโหลดและแสดงโฆษณาจาก Unity Ads โดยใช้ สื่อกลาง ซึ่งครอบคลุมการผสานรวม 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 สำหรับพาร์ทเนอร์สื่อกลาง แล้วคลิกถัดไป
เลือกการตั้งค่าโฆษณา แล้วคลิกถัดไป
กรอกแบบฟอร์มแล้วคลิกเพิ่มโปรเจ็กต์
จดรหัสเกมไว้
สร้างหน่วยโฆษณา
ไปที่การสร้างรายได้ > หน่วยโฆษณา แล้วคลิกเพิ่มหน่วยโฆษณา
ป้อนชื่อหน่วยโฆษณา แล้วเลือกแพลตฟอร์มและรูปแบบโฆษณา
สุดท้าย ให้คลิกสร้างเพื่อบันทึกหน่วยโฆษณา
เพิ่มตําแหน่งโฆษณา
เมื่อสร้างโปรเจ็กต์แล้ว ให้ไปที่การสร้างรายได้ > ตําแหน่งโฆษณา หากต้องการสร้างตําแหน่งโฆษณาใหม่ ให้คลิกเพิ่มตําแหน่งโฆษณาสําหรับหน่วยโฆษณา
กรอกรายละเอียดที่จําเป็น แล้วคลิกเพิ่มตําแหน่งโฆษณา
จดรหัสตําแหน่งโฆษณาไว้
ค้นหาคีย์ Unity Ads Reporting API
การเสนอราคา
ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
นอกจากรหัสเกมและรหัสตําแหน่งแล้ว คุณจะต้องมีคีย์ API และรหัสหลักขององค์กร Unity Ads สําหรับการตั้งค่ารหัสหน่วยโฆษณา Ad Manager ด้วย
ไปที่การสร้างรายได้ > การตั้งค่า > การจัดการ API และจดบันทึกคีย์เข้าถึง Monetization Stats API
จากนั้นไปที่การสร้างรายได้ > การตั้งค่าองค์กร แล้วจดรหัสหลักขององค์กรไว้
เปิดโหมดทดสอบ
คุณเปิดใช้โหมดทดสอบได้จากหน้าแดชบอร์ด Unity Ads เลือกแท็บการทดสอบในการตั้งค่าโปรเจ็กต์
คุณสามารถบังคับใช้โหมดทดสอบสําหรับแอปได้โดยคลิกปุ่มแก้ไขข้าง Google Play Store เลือกลบล้างโหมดทดสอบไคลเอ็นต์ แล้วเลือกเปิดโหมดทดสอบ (ใช้โฆษณาทดสอบ) สําหรับอุปกรณ์ทั้งหมด
หรือคุณจะเปิดใช้โหมดทดสอบสำหรับอุปกรณ์ที่เฉพาะเจาะจงได้โดยคลิกปุ่มเพิ่มอุปกรณ์ทดสอบ
กรอกแบบฟอร์มแล้วคลิกบันทึก
ขั้นตอนที่ 2: ตั้งค่าดีมานด์โฆษณา Unity Ads ใน Ad Manager UI
กำหนดการตั้งค่าสื่อกลางสําหรับหน่วยโฆษณา
ลงชื่อเข้าใช้บัญชี Ad Manager
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่
ป้อนชื่อที่ไม่ซ้ำกันสําหรับกลุ่มผลตอบแทน ตั้งค่าสถานะเป็นใช้งานอยู่ เลือกรูปแบบโฆษณา และตั้งค่าประเภทพื้นที่โฆษณาเป็นแอปบนอุปกรณ์เคลื่อนที่ ในส่วนการกําหนดเป้าหมาย > พื้นที่โฆษณา ให้เลือกหน่วยโฆษณาในส่วนพื้นที่โฆษณาและแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ที่ต้องการเพิ่มสื่อกลาง
จากนั้นคลิกปุ่มเพิ่มพาร์ทเนอร์ผลตอบแทน
หากมีพาร์ทเนอร์ผลตอบแทนสำหรับ Unity Ads อยู่แล้ว ให้เลือกพาร์ทเนอร์รายนั้น หรือเลือกสร้างพาร์ทเนอร์ผลตอบแทนใหม่
เลือก Unity Ads เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน และเปิดใช้สื่อกลาง
เปิดการเก็บรวบรวมข้อมูลอัตโนมัติ แล้วป้อนคีย์ API และรหัสหลักขององค์กรที่ได้ในส่วนก่อนหน้า
เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม เลือก Android เป็นแพลตฟอร์ม และเลือกใช้งานอยู่เป็นสถานะ ป้อนรหัสเกมและรหัสตำแหน่งโฆษณาที่ได้ในส่วนก่อนหน้า จากนั้นป้อนค่า CPM เริ่มต้น
คลิกบันทึกที่ด้านล่างของหน้าเมื่อดำเนินการเสร็จ
เพิ่ม Unity Ads ลงในรายชื่อพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกา
ทําตามขั้นตอนในการตั้งค่า GDPR และการตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกาเพื่อเพิ่ม Unity Ads ลงในรายการพาร์ทเนอร์โฆษณาตาม GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ Ad Manager
ขั้นตอนที่ 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.3")
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: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
ตรวจสอบว่าคุณได้ลงทะเบียนอุปกรณ์ทดสอบสําหรับ 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 ที่กําหนดค่าใน Ad Manager 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
- การเผยแพร่ครั้งแรก รองรับโฆษณาวิดีโอที่มีการให้รางวัลและโฆษณาคั่นระหว่างหน้า