ผสานรวมโฆษณา 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 ให้ไปที่โปรเจ็กต์ แล้วคลิกสร้างโปรเจ็กต์

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

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

ในโมดัลการตั้งค่าโปรเจ็กต์ ให้เลือกฉันวางแผนที่จะใช้สื่อกลางและ 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 Key and Organization core ID ที่ได้ในส่วนก่อนหน้า

เมื่อเลือกพาร์ทเนอร์ผลตอบแทนแล้ว ให้เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม Android เป็นแพลตฟอร์ม และใช้งานอยู่เป็นสถานะ ป้อนGame ID and Placement ID ที่ได้ในส่วนก่อนหน้า จากนั้นป้อนค่า CPM เริ่มต้น

คลิกบันทึกที่ด้านล่างของหน้าเมื่อดำเนินการเสร็จ

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

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

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

ในไฟล์ 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")
}

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

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

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