คู่มือนี้จะแสดงวิธีใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อโหลดและแสดงโฆษณาจาก AdColony โดยใช้สื่อกลาง โดยครอบคลุมทั้งการผสานรวมการเสนอราคาและ Waterfall โดยจะครอบคลุมวิธีการเพิ่ม AdColony ไปยังการกำหนดค่าสื่อกลางของหน่วยโฆษณา และวิธีผสานรวม AdColony SDK และอะแดปเตอร์ลงใน Android แอป
การผสานรวมที่รองรับและรูปแบบโฆษณา
Ad Manager อะแดปเตอร์สื่อกลางสำหรับ AdColony มีความสามารถดังต่อไปนี้
การผสานรวม | |
---|---|
การเสนอราคา | |
น้ำตก | |
รูปแบบ | |
แบนเนอร์ | |
โฆษณาคั่นระหว่างหน้า | |
ได้รับรางวัลแล้ว | |
เนทีฟ |
ข้อกำหนด
- Android API ระดับ 19 ขึ้นไป
- [สำหรับการเสนอราคา]: อะแดปเตอร์ AdColony 3.3.10.1 ขึ้นไป (แนะนำให้ใช้เวอร์ชันล่าสุด)
SDK โฆษณาบนอุปกรณ์เคลื่อนที่ของ Google ล่าสุด
ทำตามสื่อกลาง คู่มือเริ่มต้นใช้งาน
ขั้นตอนที่ 1: ตั้งการกำหนดค่าใน AdColony UI
ลงชื่อสมัครใช้และเข้าสู่ระบบบัญชี AdColony เพิ่มแอปลงใน หน้าแดชบอร์ดของผู้เผยแพร่โฆษณา AdColony โดยคลิกปุ่ม ตั้งค่าแอปใหม่
กรอกแบบฟอร์มและคลิกสร้างที่ด้านล่างของหน้าเพื่อเพิ่มแอปไปยัง AdColony
เมื่อสร้างแอปแล้ว คุณสามารถดูรหัสแอปได้โดยไปที่ การสร้างรายได้ > แอป ในส่วนข้อมูลพื้นฐานของแอปของแอป
จากนั้นสร้างโซนโฆษณาใหม่โดยคลิกปุ่มตั้งค่าโซนโฆษณาใหม่ในส่วนโซนโฆษณาของหน้าแอป เราขอแนะนำให้คุณสร้างโซนโฆษณาใหม่สำหรับสื่อกลางด้วย Ad Manager แม้ว่าคุณจะมีโซนดังกล่าวแล้ว
สำหรับคำแนะนำเพิ่มเติมในการสร้างตำแหน่งโฆษณา ให้เลือกแท็บที่สอดคล้องกับรูปแบบโฆษณาที่คุณต้องการ
แบนเนอร์
- ตั้งค่า Zone is Active? เป็น Yes
ป้อนชื่อโซนโฆษณาของคุณ
เลือกแบนเนอร์เป็นขนาดโซนโฆษณา
ป้อนค่าขีดจำกัดการเล่นรายวัน
โฆษณาคั่นระหว่างหน้า
- ตั้งค่า Zone is Active? เป็น Yes
ป้อนชื่อโซนโฆษณาของคุณ
เลือกโฆษณาตอนต้น/โฆษณาคั่นระหว่างหน้าเป็นประเภทโซน
ป้อนค่าขีดจำกัดการเล่นรายวัน
ได้รับรางวัลแล้ว
- ตั้งค่า Zone is Active? เป็น Yes
ป้อนชื่อโซนโฆษณาของคุณ
เลือก Value Exchange/V4VC เป็น ประเภทโซน
ตั้งค่าฝั่งไคลเอ็นต์เท่านั้นเป็นใช่ แล้วป้อนชื่อสกุลเงินเสมือน วิดีโอสูงสุดรายวันต่อผู้ใช้ และจำนวนรางวัล
ป้อนค่าขีดจำกัดการเล่นรายวัน
คลิกปุ่มสร้างเมื่อเสร็จแล้วเพื่อสร้างโซนโฆษณา
เมื่อสร้างโซนโฆษณาแล้ว คุณจะดูรหัสโซนได้ในส่วนการผสานรวมของโซนโฆษณา เราจะใช้รหัสโซนในขั้นตอนถัดไป
ค้นหาคีย์ AdColony API
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
คุณต้องใช้คีย์ API ของ AdColony เพื่อตั้งค่าAd Manager รหัสหน่วยโฆษณา ไปที่การตั้งค่าบัญชีในแดชบอร์ดผู้เผยแพร่โฆษณา AdColony เพื่อค้นหาคีย์ API ของคุณ
เปิดโหมดทดสอบ
หากต้องการเปิดใช้โฆษณาทดสอบใน AdColony ให้ไปที่แดชบอร์ด AdColony และไปที่การสร้างรายได้ > แอป เลือกโซนที่ต้องการเปิดใช้โฆษณาทดสอบในส่วนโซนโฆษณาของแอป คุณเปิดใช้โฆษณาทดสอบได้โดยเลือกใช่เพื่อแสดงโฆษณาทดสอบเท่านั้นไหมในส่วนการพัฒนา
ขั้นตอนที่ 2: ตั้งค่าดีมานด์ AdColony ใน Ad Manager UI
ลงชื่อเข้าใช้บัญชี Ad Manager
เพิ่ม AdColony บริษัท
การเสนอราคา
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวมการเสนอราคา
น้ำตก
ไปที่ผู้ดูแลระบบ > บริษัท แล้วคลิกปุ่มบริษัทใหม่ในแท็บบริษัททั้งหมด เลือกเครือข่ายโฆษณา
เลือก AdColony เป็นเครือข่ายโฆษณา ป้อนชื่อที่ไม่ซ้ำกัน และเปิดใช้สื่อกลาง เปิดการรวบรวมข้อมูลอัตโนมัติ แล้วป้อนAPI Keyที่ได้รับในส่วนก่อนหน้า
คุณไม่จำเป็นต้องป้อนชื่อผู้ใช้หรือรหัสผ่าน คลิกบันทึกเมื่อ เสร็จสิ้น
เปิดใช้การแชร์สัญญาณที่ปลอดภัย
การเสนอราคา
ไปที่ผู้ดูแลระบบ > การตั้งค่าส่วนกลาง ไปที่แท็บ การตั้งค่าบัญชี Ad Exchange แล้วตรวจสอบและเปิดการแชร์สัญญาณที่ปลอดภัย คลิกบันทึก
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวม Waterfall
กำหนดค่า AdColony การเสนอราคา
การเสนอราคา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วคลิกผู้เสนอราคาใหม่ในแท็บการเสนอราคา SDK
เลือก AdColony เป็นผู้เสนอราคา
สลับเปิดเพิ่มคลังสัญญาณของผู้เสนอราคารายนี้ลงในรายการสัญญาณที่อนุญาตและอนุญาตให้แชร์สัญญาณกับผู้เสนอราคารายนี้ จากนั้นคลิกดำเนินการต่อ
คลิกต่อไป
คลิกเสร็จ
น้ำตก
ขั้นตอนนี้ไม่จำเป็นสำหรับการผสานรวม Waterfall
กำหนดค่าการแมปหน่วยโฆษณา
การเสนอราคา
ไปที่การแสดงโฆษณา > ผู้เสนอราคา แล้วเลือกบริษัทสำหรับ AdColony ในแท็บการเสนอราคา SDK
ไปที่แท็บการแมปหน่วยโฆษณา แล้วคลิกการแมปหน่วยโฆษณาใหม่
เลือกหน่วยโฆษณาเฉพาะ เลือกหน่วยโฆษณาและรูปแบบ เลือกแอปบนอุปกรณ์เคลื่อนที่เป็นประเภทพื้นที่โฆษณา และแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ จากนั้นป้อนApp ID and Zone ID ที่ได้จากส่วนก่อนหน้า สุดท้ายให้คลิกบันทึก
น้ำตก
ไปที่การแสดงโฆษณา > กลุ่มผลตอบแทน แล้วคลิกปุ่มกลุ่มผลตอบแทนใหม่ เลือกแอปพลิเคชันบนอุปกรณ์เคลื่อนที่
เลื่อนลงและคลิกเพิ่มพาร์ทเนอร์ผลตอบแทน
เลือกบริษัทที่คุณสร้างขึ้นให้ AdColony ในส่วนก่อนหน้านี้ เลือกสื่อกลาง SDK บนอุปกรณ์เคลื่อนที่เป็นประเภทการผสานรวม Android เป็นแพลตฟอร์ม และเลือกสถานะเป็นใช้งานอยู่
ป้อน App ID and Zone ID ที่ได้รับในส่วนก่อนหน้า และค่า CPM เริ่มต้น คลิกบันทึก
หมายเหตุ: การรวบรวมข้อมูลอัตโนมัติจะใช้เวลา 2-3 วันในการรวบรวมข้อมูลก่อนที่จะคำนวณค่า CPM แบบไดนามิกสำหรับเครือข่ายสื่อกลางได้อย่างแม่นยำ เมื่อคำนวณ eCPM ได้แล้ว ระบบจะอัปเดต eCPM ในนามของคุณโดยอัตโนมัติ
เพิ่ม AdColony ลงในรายชื่อพาร์ทเนอร์โฆษณาเกี่ยวกับกฎระเบียบของรัฐในสหรัฐอเมริกาและ GDPR
ทำตามขั้นตอนใน การตั้งค่า GDPR และ การตั้งค่ากฎระเบียบของรัฐในสหรัฐอเมริกา เพื่อเพิ่ม AdColony ลงในรายชื่อพาร์ทเนอร์โฆษณาตามกฎระเบียบ GDPR และกฎระเบียบของรัฐในสหรัฐอเมริกาใน Ad Manager
ขั้นตอนที่ 3: นำเข้า AdColony SDK และอะแดปเตอร์
การผสานรวมกับ Android Studio (แนะนำ)
ในไฟล์ build.gradle.kts
ระดับแอป ให้เพิ่มทรัพยากร Dependency และการกำหนดค่าต่อไปนี้ ใช้ AdColony SDK และอะแดปเตอร์เวอร์ชันล่าสุด ดังนี้
dependencies {
implementation("com.google.android.gms:play-services-ads:23.0.0")
implementation("com.google.ads.mediation:adcolony:4.8.0.2")
}
ย้ายข้อมูลโปรเจ็กต์ไปยัง AndroidX
AdColony SDK ต้องใช้ไลบรารีการสนับสนุนของ Android แต่ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ล่าสุดใช้ไลบรารี Jetpack
เพื่อให้แน่ใจว่า AdColony SDK และ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ใช้งานร่วมกันได้ ให้สร้างไฟล์ gradle.properties
ที่ระดับบนสุดของโปรเจ็กต์ แล้วเพิ่มโค้ดต่อไปนี้
android.useAndroidX=true
android.enableJetifier=true
การดําเนินการนี้จะเขียนไบนารี AdColony SDK ใหม่เพื่อใช้ไลบรารี Jetpack ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าเหล่านี้ได้ในคำแนะนำในการย้ายข้อมูล AndroidX
การผสานรวมด้วยตนเอง
- ดาวน์โหลด AdColony Android SDK และดึงข้อมูล
adcolony.jar
ในโฟลเดอร์Library
แล้วเพิ่มลงในโปรเจ็กต์ - AdColony SDK ขึ้นอยู่กับไลบรารีการสนับสนุนคำอธิบายประกอบ ดู ปรับปรุงการตรวจสอบโค้ดด้วยคำอธิบายประกอบ สำหรับรายละเอียดเกี่ยวกับวิธีเพิ่มไลบรารีการสนับสนุนคำอธิบายประกอบลงในโปรเจ็กต์ของคุณ
- ไปที่อาร์ติแฟกต์ของอะแดปเตอร์ AdColony ใน Maven Repository ของ Google เลือกเวอร์ชันล่าสุด ดาวน์โหลดไฟล์ .aar ของอะแดปเตอร์ AdColony แล้วเพิ่มลงในโปรเจ็กต์
ขั้นตอนที่ 4: ใช้การตั้งค่าความเป็นส่วนตัวใน AdColony SDK
ความยินยอมของสหภาพยุโรปและ GDPR
ภายใต้นโยบายความยินยอมของผู้ใช้ EU ของ Google คุณต้องตรวจสอบว่าได้ให้การเปิดเผยบางอย่างแก่ผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) เกี่ยวกับการใช้ตัวระบุอุปกรณ์และข้อมูลส่วนตัว นโยบายนี้เป็นผลมาจากข้อกำหนดด้าน ePrivacy และกฎระเบียบให้ความคุ้มครองข้อมูลส่วนบุคคลของผู้บริโภค (GDPR) ของสหภาพยุโรป เมื่อขอความยินยอม คุณต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในเชนสื่อกลาง ซึ่งอาจรวบรวม รับ หรือใช้ข้อมูลส่วนตัว และให้ข้อมูลเกี่ยวกับการใช้แต่ละเครือข่าย ขณะนี้ Google ไม่สามารถส่งตัวเลือกความยินยอมของผู้ใช้ไปยังเครือข่ายดังกล่าวโดยอัตโนมัติได้
อะแดปเตอร์ AdColony จะแสดงเมธอด AdColonyMediationAdapter.getAppOptions()
ในการปรับแต่งพารามิเตอร์ที่ส่งไปยัง SDK ของ AdColony มี 2 วิธีที่เกี่ยวข้องกับ GDPR ในตัวเลือกเหล่านี้ ได้แก่ setPrivacyFrameworkRequired()
และ setPrivacyConsentString()
โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยังอะแดปเตอร์ AdColony ซึ่งจะนําไปใช้ในวิธีการเริ่มต้นของ AdColony คุณต้องตั้งค่าตัวเลือกเหล่านี้ก่อนที่จะเริ่มใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อให้ระบบส่งต่อไปยัง SDK ของ AdColony ได้อย่างถูกต้อง
Java
import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...
AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1");
Kotlin
import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...
val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1")
ดูรายละเอียดเพิ่มเติมเกี่ยวกับค่าที่อาจระบุไว้ในวิธีการเหล่านี้ได้ที่รายละเอียดการใช้งาน GDPR ของ AdColony
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา
กฎหมายคุ้มครองความเป็นส่วนตัวของรัฐในสหรัฐอเมริกา กําหนดให้ผู้ใช้มีสิทธิในการเลือกไม่รับ "การขาย" "ข้อมูลส่วนบุคคล" (ตามที่กฎหมายให้คำจำกัดความไว้) โดยให้เลือกไม่ใช้ผ่านลิงก์ "ห้ามขายข้อมูลส่วนบุคคลของฉัน" ที่เห็นชัดเจนในหน้าแรกของฝ่ายที่ทำ "การขาย" คู่มือการปฏิบัติตามกฎหมายความเป็นส่วนตัวของรัฐในสหรัฐอเมริกาช่วยให้คุณเปิดใช้การประมวลผลข้อมูลแบบจำกัดสำหรับการแสดงโฆษณา Google ได้ แต่ Google ใช้การตั้งค่านี้กับเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางไม่ได้ คุณจึงต้องระบุเครือข่ายโฆษณาแต่ละเครือข่ายในสายสื่อกลางที่อาจมีส่วนร่วมในการขายข้อมูลส่วนบุคคล และปฏิบัติตามคำแนะนำจากเครือข่ายเหล่านั้นแต่ละเครือข่ายเพื่อให้แน่ใจว่าปฏิบัติตามข้อกำหนดได้
อะแดปเตอร์ AdColony จะแสดงเมธอด AdColonyMediationAdapter.getAppOptions()
ในการปรับแต่งพารามิเตอร์ที่ส่งไปยัง SDK ของ AdColony มี 2 วิธีที่เกี่ยวข้องกับ CCPA ในตัวเลือกเหล่านี้ ได้แก่ setPrivacyFrameworkRequired()
และ setPrivacyConsentString()
โค้ดตัวอย่างต่อไปนี้แสดงวิธีส่งข้อมูลความยินยอมไปยังอะแดปเตอร์ AdColony ซึ่งจะนําไปใช้ในวิธีการเริ่มต้นของ AdColony คุณต้องตั้งค่าตัวเลือกเหล่านี้ก่อนที่จะเริ่มใช้งาน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google เพื่อให้ระบบส่งต่อไปยัง SDK ของ AdColony ได้อย่างถูกต้อง
Java
import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...
AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1");
Kotlin
import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...
val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1")
ดูรายละเอียดเพิ่มเติมเกี่ยวกับค่าที่อาจระบุไว้ในวิธีการเหล่านี้ได้ที่รายละเอียดการใช้งาน CCPA ของ AdColony
ขั้นตอนที่ 5: เพิ่มโค้ดที่จำเป็น
และไม่ต้องใช้โค้ดเพิ่มเติมสำหรับการผสานรวม AdColony
ขั้นตอนที่ 6: ทดสอบการใช้งาน
เปิดใช้โฆษณาทดสอบ
อย่าลืม ลงทะเบียนอุปกรณ์ทดสอบ สำหรับ Ad Manager และเปิดใช้โหมดทดสอบใน AdColony UI
ยืนยันโฆษณาทดสอบ
ในการยืนยันว่าคุณได้รับโฆษณาทดสอบจาก AdColony ให้เปิดใช้ การทดสอบแหล่งที่มาของโฆษณาแหล่งเดียว ในเครื่องมือตรวจสอบโฆษณาโดยใช้ AdColony (Bidding) and AdColony (Waterfall) แหล่งที่มาของโฆษณา
ขั้นตอนที่ไม่บังคับ
สิทธิ์
AdColony แนะนำให้เพิ่มสิทธิ์ที่ไม่บังคับต่อไปนี้ลงในไฟล์ AndroidManifest.xml
ของแอป เพื่อประสิทธิภาพที่ดีที่สุด
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />
การใช้โฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัล
พารามิเตอร์เฉพาะเครือข่าย
อะแดปเตอร์ AdColony รองรับพารามิเตอร์คำขอเพิ่มเติมซึ่งส่งผ่านไปยังอะแดปเตอร์ได้โดยใช้คลาส AdColonyBundleBuilder
AdColonyBundleBuilder
ประกอบด้วยวิธีการต่อไปนี้
setShowPrePopup(boolean)
: ตั้งค่าว่าจะแสดงป๊อปอัปก่อนแสดงโฆษณาหรือไม่ ตั้งค่าเป็น "เท็จ" หากไม่ต้องการป๊อปอัปก่อนที่โฆษณาจะแสดงsetShowPostPopup(boolean)
: ตั้งค่าว่าจะแสดงป๊อปอัปหลังจากแสดงโฆษณาหรือไม่ ตั้งค่าเป็น "เท็จ" หากไม่ต้องการป๊อปอัปหลังจากโฆษณาแสดง
ต่อไปนี้คือตัวอย่างโค้ดของวิธีตั้งค่าพารามิเตอร์คำขอโฆษณาเหล่านี้
Java
AdColonyBundleBuilder.setShowPrePopup(true);
AdColonyBundleBuilder.setShowPostPopup(true);
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdColonyAdapter.class, AdColonyBundleBuilder.build())
.build();
rewardedInterstitialAd.loadAd(request);
Kotlin
AdColonyBundleBuilder.setShowPrePopup(true)
AdColonyBundleBuilder.setShowPostPopup(true)
val request = AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(AdColonyAdapter::class.java, AdColonyBundleBuilder.build())
.build()
rewardedInterstitialAd.loadAd(request)
ตรวจสอบเวอร์ชันอะแดปเตอร์และ SDK
หากต้องการบันทึกเวอร์ชันอะแดปเตอร์และ SDK ให้ใช้ข้อมูลโค้ดต่อไปนี้
AdColonyMediationAdapter adapter = new AdColonyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
"Adapter version: %d.%d.%03d",
adapterVersion.getMajorVersion(),
adapterVersion.getMinorVersion(),
adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
"SDK version: %d.%d.%d",
sdkVersion.getMajorVersion(),
sdkVersion.getMinorVersion(),
sdkVersion.getMicroVersion()));
รหัสข้อผิดพลาด
หากอะแดปเตอร์ไม่ได้รับโฆษณาจาก AdColony ผู้เผยแพร่โฆษณาสามารถตรวจสอบข้อผิดพลาดที่มีอยู่จากการตอบกลับโฆษณาได้โดยใช้
ResponseInfo.getAdapterResponse()
ในคลาสต่อไปนี้
com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter
ต่อไปนี้คือรหัสและข้อความประกอบที่อะแดปเตอร์ AdColony ส่งไว้เมื่อโฆษณาโหลดไม่สำเร็จ
รหัสข้อผิดพลาด | เหตุผล |
---|---|
100 | AdColony SDK แสดงผลข้อผิดพลาด |
101 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสโซน) |
102 | มีการขอโฆษณารหัสโซนเดียวกันแล้ว |
103 | AdColony SDK แสดงผลข้อผิดพลาดในการเริ่มต้น |
104 | ขนาดแบนเนอร์ที่ขอไม่ได้จับคู่กับขนาดโฆษณา AdColony ที่ถูกต้อง |
105 | ข้อผิดพลาดในการนำเสนอเนื่องจากโหลดโฆษณาไม่ได้ |
106 | บริบทที่ใช้ในการเริ่มต้น AdColony SDK ไม่ใช่อินสแตนซ์ Activity |
0 - 3 | AdColony SDK แสดงผลข้อผิดพลาด ดูรายละเอียดเพิ่มเติมในเอกสารประกอบ |
101 | พารามิเตอร์เซิร์ฟเวอร์ไม่ถูกต้อง (เช่น ไม่มีรหัสโซน) |
102 | ตัวควบคุม Root View ที่กำลังแสดงโฆษณาคือ nil |
103 | AdColony SDK แสดงผลข้อผิดพลาดในการเริ่มต้น |
104 | AdColony SDK ไม่รองรับการกำหนดค่า 2 ครั้งภายในช่วงเวลา 5 วินาที |
105 | แสดงโฆษณาไม่สำเร็จ |
106 | โซนที่มีการให้รางวัลไม่ใช่โซนที่มีการให้รางวัลในพอร์ทัล AdColony |
บันทึกการเปลี่ยนแปลงอะแดปเตอร์สื่อกลาง Android ของ AdColony
เวอร์ชันถัดไป
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 22.4.0
เวอร์ชัน 4.8.0.2
- อัปเดตอะแดปเตอร์ให้ใช้คลาส
VersionInfo
ใหม่แล้ว - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 22.0.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 22.0.0
- AdColony SDK เวอร์ชัน 4.8.0
เวอร์ชัน 4.8.0.1
- เพิ่มการรองรับในการส่งต่อข้อมูล COPPA ไปยัง AdColony SDK
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 21.5.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 21.5.0
- AdColony SDK เวอร์ชัน 4.8.0
เวอร์ชัน 4.8.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.8.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 21.0.0
- AdColony SDK เวอร์ชัน 4.8.0
เวอร์ชัน 4.7.1.1
- อัปเดต
compileSdkVersion
และtargetSdkVersion
เป็น API 31 แล้ว - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 21.0.0
- อัปเดตระดับ API ขั้นต่ำของ Android เป็น 19 แล้ว
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 21.0.0
- AdColony SDK เวอร์ชัน 4.7.1
เวอร์ชัน 4.7.1.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.7.1
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- AdColony SDK เวอร์ชัน 4.7.1
เวอร์ชัน 4.7.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.7.0
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 20.6.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.6.0
- AdColony SDK เวอร์ชัน 4.7.0
เวอร์ชัน 4.6.5.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.6.5
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.4.0
- AdColony SDK เวอร์ชัน 4.6.5
เวอร์ชัน 4.6.4.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.6.4
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.4.0
- AdColony SDK เวอร์ชัน 4.6.4
เวอร์ชัน 4.6.3.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.6.3
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 20.4.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.4.0
- AdColony SDK เวอร์ชัน 4.6.3
เวอร์ชัน 4.6.2.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.6.2
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.3.0
- AdColony SDK เวอร์ชัน 4.6.2
เวอร์ชัน 4.6.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.6.0
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 20.3.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.3.0
- AdColony SDK เวอร์ชัน 4.6.0
เวอร์ชัน 4.5.0.0
- เพิ่มการรองรับการเสนอราคาขั้นสูงของแบนเนอร์
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.5.0
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 20.0.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 20.0.0
- AdColony SDK เวอร์ชัน 4.5.0
เวอร์ชัน 4.4.1.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.4.1
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.7.0
- AdColony SDK เวอร์ชัน 4.4.1
เวอร์ชัน 4.4.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.4.0
- เพิ่มการรองรับวิธีการเสนอราคา
collectSignals()
ของ AdColony - อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กำหนดเป็น 19.7.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.7.0
- AdColony SDK เวอร์ชัน 4.4.0
เวอร์ชัน 4.3.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.3.0
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 19.5.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.5.0
- AdColony SDK เวอร์ชัน 4.3.0
เวอร์ชัน 4.2.4.0
- แก้ไขข้อบกพร่องที่
onUserEarnedReward()
ไม่มีการส่งต่อโฆษณาที่มีการให้รางวัล - เพิ่มรหัสข้อผิดพลาดสําหรับข้อผิดพลาดในการเริ่มต้น AdColony SDK
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กำหนดเป็น 19.4.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.4.0
- AdColony SDK เวอร์ชัน 4.2.4
เวอร์ชัน 4.2.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.2.0
- อัปเดตอะแดปเตอร์ให้รองรับคำขอแบนเนอร์แบบปรับขนาดได้ในบรรทัดแล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 19.2.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.2.0
- AdColony SDK เวอร์ชัน 4.2.0
เวอร์ชัน 4.1.4.1
- เพิ่มรหัสข้อผิดพลาดที่สื่อความหมายและเหตุผลที่โหลด/แสดงอะแดปเตอร์ไม่สำเร็จ
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กําหนดเป็น 19.0.1
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 19.0.1
- AdColony SDK เวอร์ชัน 4.1.4
เวอร์ชัน 4.1.4.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.1.4
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- AdColony SDK เวอร์ชัน 4.1.4
เวอร์ชัน 4.1.3.1
- แก้ไขปัญหาที่อะแดปเตอร์ไม่ส่งต่อการโทรกลับของ
onRewardedAdLoaded()
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- AdColony SDK เวอร์ชัน 4.1.3
เวอร์ชัน 4.1.3.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.1.3
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- AdColony SDK เวอร์ชัน 4.1.3
เวอร์ชัน 4.1.2.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.1.2
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กำหนดเป็น 18.3.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 18.3.0
- AdColony SDK เวอร์ชัน 4.1.2
เวอร์ชัน 4.1.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 4.1.0
- เพิ่มการรองรับโฆษณาแบนเนอร์
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 18.2.0
สร้างและทดสอบกับ
- Google Mobile Ads SDK เวอร์ชัน 18.2.0
- AdColony SDK เวอร์ชัน 4.1.0
เวอร์ชัน 3.3.11.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.11
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่จําเป็นเป็น 18.1.1
เวอร์ชัน 3.3.10.1
- เพิ่มความสามารถในการเสนอราคาให้กับอะแดปเตอร์ สำหรับโฆษณาคั่นระหว่างหน้าและโฆษณาที่มีการให้รางวัล
เวอร์ชัน 3.3.10.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.10
เวอร์ชัน 3.3.9.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.9
- นำวิธี
setGdprRequired()
และsetGdprConsentString()
ออกแล้วในAdColonyBundleBuilder
- เพิ่มเมธอด
AdColonyMediationAdapter.getAppOptions()
ผู้เผยแพร่โฆษณาต้องส่งข้อมูล GDPR ไปยัง SDK ของ AdColony ผ่านตัวเลือกเหล่านี้ ดูรายละเอียดเพิ่มเติมในเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์
เวอร์ชัน 3.3.8.1
- อัปเดตอะแดปเตอร์ให้รองรับ Rewarded API รุ่นเบต้าแบบเปิดใหม่แล้ว
- อัปเดตเวอร์ชัน SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ขั้นต่ำที่กำหนดเป็น 17.2.0
เวอร์ชัน 3.3.8.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.8
เวอร์ชัน 3.3.7.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.7
เวอร์ชัน 3.3.6.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.6
เวอร์ชัน 3.3.5.1
- อัปเดตอะแดปเตอร์เพื่อเรียกใช้เหตุการณ์โฆษณา
onRewardedVideoComplete()
เวอร์ชัน 3.3.5.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.5
เวอร์ชัน 3.3.4.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.4
- อัปเดตอะแดปเตอร์ด้วย GDPR แล้ว
เวอร์ชัน 3.3.3.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.3
- นำเมธอด
setTestModeEnabled
ออกจากคลาสเครื่องมือสร้างชุดแล้ว ตอนนี้ผู้เผยแพร่โฆษณาสามารถขอโฆษณาทดสอบจาก AdColony ได้แล้วโดยระบุอุปกรณ์ทดสอบผ่านเมธอดaddTestDevice()
จากคลาสเครื่องมือสร้าง AdRequest
เวอร์ชัน 3.3.2.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.2
เวอร์ชัน 3.3.0.1
- แก้ปัญหาที่อะแดปเตอร์จ่ายไฟไม่ได้เมื่อเริ่มอะแดปเตอร์อีกครั้ง
- แก้ไขปัญหาที่ส่งการเรียกกลับรางวัลไม่ถูกต้อง
เวอร์ชัน 3.3.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.3.0
- อัปเดตโปรเจ็กต์อะแดปเตอร์สำหรับ Android Studio 3.0
เวอร์ชัน 3.2.1.1
- เพิ่มเมธอด
setTestModeEnabled
ลงในคลาสเครื่องมือสร้างชุดแล้ว ผู้เผยแพร่โฆษณาใช้วิธีการนี้เพื่อทำเครื่องหมายคำขอ AdColony เป็นคำขอทดสอบได้
เวอร์ชัน 3.2.1.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.2.1
เวอร์ชัน 3.2.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.2.0
เวอร์ชัน 3.1.2.0
- แก้ไข NullPointerException ที่เป็นไปได้
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.1.2
เวอร์ชัน 3.1.1.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.1.1
เวอร์ชัน 3.1.0.0
- ยืนยันความเข้ากันได้กับ AdColony SDK เวอร์ชัน 3.1.0
เวอร์ชัน 3.0.6.0
- เปลี่ยนระบบการตั้งชื่อเวอร์ชันเป็น [เวอร์ชัน SDK ของ AdColony][เวอร์ชันแพตช์ของอะแดปเตอร์]
- อัปเดต AdColony SDK ขั้นต่ำที่จําเป็นสําหรับ v3.0.6 แล้ว
เวอร์ชันก่อนหน้า
- รองรับโฆษณาวิดีโอที่มีการให้รางวัลและโฆษณาคั่นระหว่างหน้า