เหตุการณ์ที่กําหนดเองช่วยให้คุณเพิ่มการแสดงโฆษณาสื่อกลางตามลําดับขั้นสําหรับเครือข่ายโฆษณาที่ไม่ใช่เครือข่ายโฆษณาที่รองรับได้ ซึ่งทําได้โดยใช้อะแดปเตอร์เหตุการณ์ที่กําหนดเองสําหรับเครือข่ายโฆษณาที่ต้องการผสานรวม
ดูตัวอย่างโปรเจ็กต์เหตุการณ์ที่กําหนดเองแบบเต็มได้ใน GitHub repo
ข้อกำหนดเบื้องต้น
คุณต้องผสานรวมรูปแบบโฆษณารูปแบบใดรูปแบบหนึ่งต่อไปนี้ลงในแอปก่อนจึงจะสร้างเหตุการณ์ที่กําหนดเองได้
สร้างเหตุการณ์ที่กําหนดเองใน UI
คุณต้องสร้างเหตุการณ์ที่กําหนดเองใน UI ของ AdMob ก่อน ดูวิธีการในหัวข้อเพิ่มเหตุการณ์ที่กําหนดเอง
คุณต้องระบุข้อมูลต่อไปนี้
- ชื่อคลาส
ชื่อที่มีคุณสมบัติครบถ้วนของคลาสที่ใช้อะแดปเตอร์เหตุการณ์ที่กําหนดเอง เช่น
com.google.ads.mediation.sample.customevent.SampleCustomEvent
แนวทางปฏิบัติแนะนำคือให้ใช้คลาสอะแดปเตอร์เดียวสำหรับรูปแบบโฆษณาเหตุการณ์ที่กำหนดเองทั้งหมด- ป้ายกำกับ
ชื่อที่ไม่ซ้ำกันซึ่งกําหนดแหล่งที่มาของโฆษณา
- พารามิเตอร์
อ argu สตริงที่ไม่บังคับซึ่งส่งไปยังอะแดปเตอร์เหตุการณ์ที่กําหนดเอง
เริ่มต้นอะแดปเตอร์
เมื่อ Google Mobile Ads SDK เริ่มต้น ระบบจะเรียกใช้ initialize()
ในอะแดปเตอร์ของบุคคลที่สามและเหตุการณ์ที่กําหนดเองทั้งหมดที่รองรับซึ่งกําหนดค่าไว้สําหรับแอปภายใน UI ของ AdMob ใช้วิธีการนี้เพื่อดำเนินการตั้งค่าหรือเริ่มต้นที่จำเป็นใน SDK ของบุคคลที่สามที่จําเป็นสําหรับเหตุการณ์ที่กําหนดเอง
Java
package com.google.ads.mediation.sample.customevent;
import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.InitializationCompleteCallback;
import com.google.android.gms.ads.mediation.MediationConfiguration;
public class SampleAdNetworkCustomEvent extends Adapter {
private static final String SAMPLE_AD_UNIT_KEY = "parameter";
@Override
public void initialize(Context context,
InitializationCompleteCallback initializationCompleteCallback,
List<MediationConfiguration> mediationConfigurations) {
// This is where you will initialize the SDK that this custom
// event is built for. Upon finishing the SDK initialization,
// call the completion handler with success.
initializationCompleteCallback.onInitializationSucceeded();
}
}
Kotlin
package com.google.ads.mediation.sample.customevent
import com.google.android.gms.ads.mediation.Adapter
import com.google.android.gms.ads.mediation.InitializationCompleteCallback
import com.google.android.gms.ads.mediation.MediationConfiguration
class SampleCustomEvent : Adapter() {
private val SAMPLE_AD_UNIT_KEY = "parameter"
override fun initialize(
context: Context,
initializationCompleteCallback: InitializationCompleteCallback,
mediationConfigurations: List<MediationConfiguration>
) {
// This is where you will initialize the SDK that this custom
// event is built for. Upon finishing the SDK initialization,
// call the completion handler with success.
initializationCompleteCallback.onInitializationSucceeded()
}
}
หมายเลขเวอร์ชันรายงาน
เหตุการณ์ที่กําหนดเองทั้งหมดต้องรายงานทั้งเวอร์ชันของอะแดปเตอร์เหตุการณ์ที่กําหนดเองและเวอร์ชันของ SDK ของบุคคลที่สามที่เหตุการณ์ที่กําหนดเองโต้ตอบด้วยไปยัง Google Mobile Ads SDK ระบบจะรายงานเวอร์ชันเป็นออบเจ็กต์ VersionInfo
ดังนี้
Java
package com.google.ads.mediation.sample.customevent;
public class SampleCustomEvent extends Adapter {
@Override
public VersionInfo getVersionInfo() {
String versionString = new VersionInfo(1, 2, 3);
String[] splits = versionString.split("\\.");
if (splits.length >= 4) {
int major = Integer.parseInt(splits[0]);
int minor = Integer.parseInt(splits[1]);
int micro = Integer.parseInt(splits[2]) * 100 + Integer.parseInt(splits[3]);
return new VersionInfo(major, minor, micro);
}
return new VersionInfo(0, 0, 0);
}
@Override
public VersionInfo getSDKVersionInfo() {
String versionString = SampleAdRequest.getSDKVersion();
String[] splits = versionString.split("\\.");
if (splits.length >= 3) {
int major = Integer.parseInt(splits[0]);
int minor = Integer.parseInt(splits[1]);
int micro = Integer.parseInt(splits[2]);
return new VersionInfo(major, minor, micro);
}
return new VersionInfo(0, 0, 0);
}
}
Kotlin
package com.google.ads.mediation.sample.customevent
class SampleCustomEvent : Adapter() {
override fun getVersionInfo(): VersionInfo {
val versionString = VersionInfo(1,2,3).toString()
val splits: List<String> = versionString.split("\\.")
if (splits.count() >= 4) {
val major = splits[0].toInt()
val minor = splits[1].toInt()
val micro = (splits[2].toInt() * 100) + splits[3].toInt()
return VersionInfo(major, minor, micro)
}
return VersionInfo(0, 0, 0)
}
override fun getSDKVersionInfo(): VersionInfo {
val versionString = VersionInfo(1,2,3).toString()
val splits: List<String> = versionString.split("\\.")
if (splits.count() >= 3) {
val major = splits[0].toInt()
val minor = splits[1].toInt()
val micro = splits[2].toInt()
return VersionInfo(major, minor, micro)
}
return VersionInfo(0, 0, 0)
}
}
ส่งคำขอโฆษณา
หากต้องการขอโฆษณา โปรดดูวิธีการเฉพาะสำหรับรูปแบบโฆษณาต่อไปนี้