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

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

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

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

การผสานรวม
การเสนอราคา  1
น้ำตก
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
เนทีฟ
1 การผสานรวมการเสนอราคาปิดอยู่ เบต้า ให้ติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

ตอนนี้คุณควรจะเห็นการ์ดหน่วยโฆษณาเต็มไปด้วยหน่วยโฆษณาที่คุณเลือกไว้ ดังนี้

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

การเสนอราคา

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

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

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

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

ต่อไป ให้ป้อน Game ID and Placement ID ที่ได้รับในส่วนก่อนหน้านี้ จากนั้นคลิกเสร็จสิ้น

น้ำตก

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

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

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

แล้วป้อน Game ID and Placement ID ที่ได้รับในส่วนก่อนหน้า จากนั้นคลิกเสร็จสิ้น

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

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

ขั้นตอนที่ 3: นำเข้า SDK โฆษณา Unity และอะแดปเตอร์

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.2.0")
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
วันที่

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

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

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

เวอร์ชัน 4.12.2.0

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

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

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

เวอร์ชัน 4.12.1.0

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

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

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

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

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

  • รายงานการแสดงโฆษณาเมื่อ SDK โฆษณา Unity Ads เรียกใช้ onBannerShow() ใหม่ Callback Method
  • ยืนยันความเข้ากันได้กับ 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 ใหม่
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 21.4.0

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

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

เวอร์ชัน 4.4.0.0

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

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

  • Google Mobile Ads SDK เวอร์ชัน 21.1.0
  • Unity Ads SDK เวอร์ชัน 4.3.0

เวอร์ชัน 4.2.1.1

  • อัปเดต compileSdkVersion และ targetSdkVersion เป็น API 31 แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 21.0.0

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

  • Google Mobile Ads SDK เวอร์ชัน 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 แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 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 เพิ่มเติมด้วยตนเอง
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.8.0

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

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

เวอร์ชัน 3.6.0.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.6.0 แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.6.0

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

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

เวอร์ชัน 3.5.1.1

  • แก้ไขปัญหาขณะพยายามขอโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัลหลายรายการ

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

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

เวอร์ชัน 3.5.1.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.5.1 แล้ว
  • แก้ไขปัญหาที่ทำให้คำขอโฆษณาแบนเนอร์อัจฉริยะล้มเหลว

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

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

เวอร์ชัน 3.5.0.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.5.0 แล้ว
  • เพิ่มการรองรับแบนเนอร์แบบปรับขนาดได้
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.5.0

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

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

เวอร์ชัน 3.4.8.0

  • แก้ไขข้อผิดพลาด NullPointerException ที่เกิดขึ้นเมื่อโฆษณาแบนเนอร์ถูกทำลาย
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.3.0

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

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

เวอร์ชัน 3.4.6.1

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

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

  • Google Mobile Ads SDK เวอร์ชัน 19.1.0
  • Unity Ads SDK เวอร์ชัน 3.4.6

เวอร์ชัน 3.4.2.3

  • เพิ่มรหัสข้อผิดพลาดที่สื่อความหมายและเหตุผลที่โหลด/แสดงอะแดปเตอร์ไม่สำเร็จ
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 19.1.0

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

  • Google Mobile Ads SDK เวอร์ชัน 19.1.0
  • Unity Ads SDK เวอร์ชัน 3.4.2

เวอร์ชัน 3.4.2.2

  • แก้ไขข้อขัดข้อง ConcurrentModificationException ที่เกิดขึ้นเมื่อ Unity Ads แสดงผลข้อผิดพลาด

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

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

เวอร์ชัน 3.4.2.1

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

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

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

เวอร์ชัน 3.4.2.0

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

เวอร์ชัน 3.2.0.0

  • แก้ไขปัญหาที่ทำให้คำขอโฆษณาแบนเนอร์ไม่สำเร็จ
  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.2.0 แล้ว
  • ย้ายข้อมูลอะแดปเตอร์ไปยัง AndroidX แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 18.1.1

เวอร์ชัน 3.1.0.0

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

เวอร์ชัน 3.0.1.0

  • ยืนยันความเข้ากันได้กับ Unity Ads SDK 3.0.1 แล้ว
  • แก้ไขข้อบกพร่องที่ทำให้เกิด "NPE" ขณะแสดงโฆษณาคั่นระหว่างหน้า

เวอร์ชัน 3.0.0.2

  • อัปเดตอะแดปเตอร์ให้รองรับ Reward API เวอร์ชันเบต้าแบบเปิดใหม่แล้ว
  • อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่ต้องใช้เป็น 17.2.0

เวอร์ชัน 3.0.0.1

  • เพิ่มการรองรับแบนเนอร์โฆษณา Unity

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

เวอร์ชัน 1.0.0

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