使用自訂事件,即可為不受支援的廣告聯播網的廣告聯播網新增刊登序列中介服務。方法是針對要整合的廣告聯播網導入自訂事件轉接程式。
您可以在 GitHub 存放區中找到完整的自訂事件專案範例。
必要條件
建立自訂事件之前,必須先將下列廣告格式整合至應用程式:
在使用者介面中建立自訂事件
您必須先在 AdMobUI 中建立自訂事件。請參閱 新增自訂事件中的操作說明。
您必須提供以下資訊:
- 類別名稱
實作自訂事件轉接程式的類別完整名稱,例如
com.google.ads.mediation.sample.customevent.SampleCustomEvent
。最佳做法是為所有自訂事件廣告格式,使用單一轉接程式類別。- 標籤
定義廣告來源的專屬名稱。
- 參數
傳送至自訂事件轉接程式的選用字串引數。
初始化轉接器
Google Mobile Ads SDK 初始化時,系統會針對 AdMob UI 內為應用程式設定的所有支援第三方轉接程式和自訂事件叫用
initialize()
。此方法可為自訂事件所需的第三方 SDK,執行任何必要的設定或初始化作業。
Java
package com.google.ads.mediation.sample.customevent; import com.google.android.gms.ads.AdFormat; 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"; private InitializationCompleteCallback initializationCallback; @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(); } }
回報版本號碼
所有自訂事件都必須向 Google Mobile Ads SDK 回報的自訂事件轉接程式本身,以及自訂事件介面所用的第三方 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); } }
請求廣告
如要提出廣告請求,請參閱該廣告格式的專屬操作說明: