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

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

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

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

การผสานรวม
การเสนอราคา  1
น้ำตก
รูปแบบ
แบนเนอร์
โฆษณาคั่นระหว่างหน้า
ได้รับรางวัลแล้ว
เนทีฟ

1 การผสานรวมการเสนอราคาอยู่ในรุ่นเบต้าแบบปิด โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าเพื่อขอสิทธิ์เข้าถึง

ข้อกำหนด

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

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

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

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

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

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

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

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

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

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

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

สร้างหน่วยโฆษณา

ไปที่การสร้างรายได้ > หน่วยโฆษณา แล้วคลิกเพิ่มหน่วยโฆษณา

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

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

เพิ่มตําแหน่งโฆษณา

การเสนอราคา

ติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google เพื่อสร้างตําแหน่งการเสนอราคา

น้ำตก

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

กรอกรายละเอียดที่จำเป็นแล้วคลิกเพิ่มตำแหน่ง

จดรหัสตำแหน่งโฆษณาไว้

ค้นหาคีย์ Unity Ads Reporting API

การเสนอราคา

ขั้นตอนนี้ไม่จําเป็นสำหรับการผสานรวมการเสนอราคา

น้ำตก

นอกจากรหัสเกมและรหัสตำแหน่งแล้ว คุณจะต้องมีคีย์ API สำหรับโฆษณา Unity และรหัสหลักขององค์กรเพื่อตั้งค่ารหัสหน่วยโฆษณา AdMob ด้วย

ไปที่การสร้างรายได้ > การตั้งค่า > การจัดการ API และจดคีย์เข้าถึง Monetization Stats API

จากนั้นไปที่การสร้างรายได้ > การตั้งค่าองค์กร แล้วจดรหัสหลักขององค์กรไว้

เปิดโหมดทดสอบ

คุณเปิดใช้โหมดทดสอบได้จากหน้าแดชบอร์ด Unity Ads เลือกแท็บการทดสอบในการตั้งค่าโปรเจ็กต์

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

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

กรอกแบบฟอร์มแล้วคลิกบันทึก

ขั้นตอนที่ 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 และกฎระเบียบของรัฐในสหรัฐอเมริกาใน UI ของ AdMob

ขั้นตอนที่ 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.4")
    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 ด้วยตนเอง เราขอแนะนำให้เรียกใช้โค้ดนี้ก่อนที่จะขอโฆษณาผ่าน 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()

ดูรายละเอียดเพิ่มเติมและค่าที่ระบุได้ในแต่ละเมธอดได้จากคู่มือความยินยอมด้านความเป็นส่วนตัวและ 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()

ดูคู่มือ Privacy Consent and Data API ของ Unity Ads และ การปฏิบัติตาม CCPA เพื่อดูรายละเอียดเพิ่มเติมและค่าที่ระบุในแต่ละเมธอด

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

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

ขั้นตอนที่ 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 แสดงเมื่อโหลดโฆษณาไม่สําเร็จ

รหัสข้อผิดพลาด เหตุผล
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 ดูรายละเอียดเพิ่มเติมในรหัส

บันทึกการเปลี่ยนแปลงของอะแดปเตอร์สื่อกลาง 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

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

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

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

เวอร์ชัน 1.0.0

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