배너 광고 맞춤 이벤트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
기본 요건
맞춤 이벤트 설정을 완료합니다.
배너 광고 요청
폭포식 구조 미디에이션 체인에서 맞춤 이벤트 광고 항목에 도달하면 맞춤 이벤트를 만들 때 제공한 클래스 이름에 loadBannerAd() 메서드가 호출됩니다. 이 경우 이 메서드는 SampleCustomEvent에 있고 SampleBannerCustomEventLoader에서 loadBannerAd() 메서드를 호출합니다.
배너 광고를 요청하려면 Adapter를 확장하여 loadBannerAd()를 구현하는 클래스를 만들거나 수정하세요. 또한 MediationBannerAd를 구현할 새 클래스를 만듭니다.
맞춤 이벤트 예에서 SampleCustomEvent는 Adapter 클래스를 확장한 다음 SampleBannerCustomEventLoader에 위임합니다.
자바
package com.google.ads.mediation.sample.customevent;
import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.MediationAdConfiguration;
import com.google.android.gms.ads.mediation.MediationAdLoadCallback;
import com.google.android.gms.ads.mediation.MediationBannerAd;
import com.google.android.gms.ads.mediation.MediationBannerAdCallback;
...
public class SampleCustomEvent extends Adapter {
private SampleBannerCustomEventLoader bannerLoader;
@Override
public void loadBannerAd(
@NonNull MediationBannerAdConfiguration adConfiguration,
@NonNull MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback> callback) {
bannerLoader = new SampleBannerCustomEventLoader(adConfiguration, callback);
bannerLoader.loadAd();
}
}SampleBannerCustomEventLoader는 다음 작업을 담당합니다.
배너 광고를 로드하고 로드가 완료되면 MediationAdLoadCallback 메서드 호출
MediationBannerAd 인터페이스 구현
Google 모바일 광고 SDK에 광고 이벤트 콜백 수신 및 보고
UI에 정의된 선택적 매개변수는 광고 구성에 포함됩니다. adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD)를 통해 매개변수에 액세스할 수 있습니다.
이 매개변수는 일반적으로 광고 네트워크 SDK가 광고 객체를 인스턴스화할 때 요구하는 광고 단위 식별자입니다.
자바
package com.google.ads.mediation.sample.customevent;
import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.MediationBannerAdConfiguration;
import com.google.android.gms.ads.mediation.MediationAdLoadCallback;
import com.google.android.gms.ads.mediation.MediationBannerAd;
import com.google.android.gms.ads.mediation.MediationBannerAdCallback;
...
public class SampleBannerCustomEventLoader extends SampleAdListener implements MediationBannerAd {
/** View to contain the sample banner ad. */
private SampleAdView sampleAdView;
/** Configuration for requesting the banner ad from the third-party network. */
private final MediationBannerAdConfiguration mediationBannerAdConfiguration;
/** Callback that fires on loading success or failure. */
private final MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback>
mediationAdLoadCallback;
/** Callback for banner ad events. */
private MediationBannerAdCallback bannerAdCallback;
/** Constructor. */
public SampleBannerCustomEventLoader(
@NonNull MediationBannerAdConfiguration mediationBannerAdConfiguration,
@NonNull MediationAdLoadCallback<MediationBannerAd, MediationBannerAdCallback>
mediationAdLoadCallback) {
this.mediationBannerAdConfiguration = mediationBannerAdConfiguration;
this.mediationAdLoadCallback = mediationAdLoadCallback;
}
/** Loads a banner ad from the third-party ad network. */
public void loadAd() {
// All custom events have a server parameter named "parameter" that returns
// back the parameter entered into the UI when defining the custom event.
Log.i("BannerCustomEvent", "Begin loading banner ad.");
String serverParameter =
mediationBannerAdConfiguration.getServerParameters().getString(
MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD);
Log.d("BannerCustomEvent", "Received server parameter.");
Context context = mediationBannerAdConfiguration.getContext();
sampleAdView = new SampleAdView(context);
// Assumes that the serverParameter is the ad unit of the Sample Network.
sampleAdView.setAdUnit(serverParameter);
AdSize size = mediationBannerAdConfiguration.getAdSize();
// Internally, smart banners use constants to represent their ad size, which
// means a call to AdSize.getHeight could return a negative value. You can
// accommodate this by using AdSize.getHeightInPixels and
// AdSize.getWidthInPixels instead, and then adjusting to match the device's
// display metrics.
int widthInPixels = size.getWidthInPixels(context);
int heightInPixels = size.getHeightInPixels(context);
DisplayMetrics displayMetrics = Resources.getSystem().getDisplayMetrics();
int widthInDp = Math.round(widthInPixels / displayMetrics.density);
int heightInDp = Math.round(heightInPixels / displayMetrics.density);
sampleAdView.setSize(new SampleAdSize(widthInDp, heightInDp));
sampleAdView.setAdListener(this);
SampleAdRequest request = createSampleRequest(mediationBannerAdConfiguration);
Log.i("BannerCustomEvent", "Start fetching banner ad.");
sampleAdView.fetchAd(request);
}
public SampleAdRequest createSampleRequest(
MediationAdConfiguration mediationAdConfiguration) {
SampleAdRequest request = new SampleAdRequest();
request.setTestMode(mediationAdConfiguration.isTestRequest());
request.setKeywords(mediationAdConfiguration.getMediationExtras().keySet());
return request;
}
}광고를 성공적으로 가져왔는지 아니면 오류가 발생했는지에 따라 onSuccess() 또는 onFailure()를 호출합니다.
MediationBannerAd를 구현하는 클래스의 인스턴스를 전달하여 onSuccess()가 호출됩니다.
일반적으로 이러한 메서드는 어댑터가 구현하는 서드 파티 SDK의 콜백 내에서 구현됩니다. 다음 예시의 샘플 SDK에는 관련 콜백이 있는 SampleAdListener가 있습니다.
자바
@Override
public void onAdFetchSucceeded() {
bannerAdCallback = mediationAdLoadCallback.onSuccess(this);
}
@Override
public void onAdFetchFailed(SampleErrorCode errorCode) {
mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode));
}MediationBannerAd에서는 View getter 메서드를 구현해야 합니다.
자바
@Override
@NonNull
public View getView() {
return sampleAdView;
}onSuccess()가 호출되면 어댑터가 반환된 MediationBannerAdCallback 객체를 사용하여 프레젠테이션 이벤트를 서드 파티 SDK에서 Google 모바일 광고 SDK로 전달할 수 있습니다. SampleBannerCustomEventLoader 클래스는 SampleAdListener 인터페이스를 확장하여 샘플 광고 네트워크의 콜백을 Google 모바일 광고 SDK에 전달합니다.
맞춤 이벤트가 이러한 콜백을 최대한 많이 전달하여 앱이 Google 모바일 광고 SDK에서 동등한 이벤트를 수신하도록 하는 것이 중요합니다. 다음은 콜백을 사용하는 방법의 예시입니다.
자바
@Override
public void onAdFullScreen() {
bannerAdCallback.onAdOpened();
bannerAdCallback.reportAdClicked();
}
@Override
public void onAdClosed() {
bannerAdCallback.onAdClosed();
}배너 광고용 맞춤 이벤트 구현이 완료되었습니다. 전체 예시는 GitHub에서 확인할 수 있습니다.
이미 지원되는 광고 네트워크에 예시를 사용하거나 예시를 수정하여 맞춤 이벤트 배너 광고를 게재할 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eTo request banner ads with custom events, extend the \u003ccode\u003eAdapter\u003c/code\u003e class and implement the \u003ccode\u003eloadBannerAd()\u003c/code\u003e method, delegating the ad loading process to a separate loader class.\u003c/p\u003e\n"],["\u003cp\u003eThe loader class is responsible for fetching the ad, handling ad events, and implementing the \u003ccode\u003eMediationBannerAd\u003c/code\u003e interface to interact with the Google Mobile Ads SDK.\u003c/p\u003e\n"],["\u003cp\u003eCustom events receive server parameters from Ad Manager, allowing them to be configured with ad unit IDs or other necessary information.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful ad fetch, the loader class invokes \u003ccode\u003eonSuccess()\u003c/code\u003e on the \u003ccode\u003eMediationAdLoadCallback\u003c/code\u003e, providing an instance of the \u003ccode\u003eMediationBannerAd\u003c/code\u003e implementation.\u003c/p\u003e\n"],["\u003cp\u003eIt's crucial for custom events to forward relevant ad events from the third-party ad network to the Google Mobile Ads SDK using the \u003ccode\u003eMediationBannerAdCallback\u003c/code\u003e.\u003c/p\u003e\n"]]],["To request a banner ad, extend the `Adapter` class, implementing `loadBannerAd()`, and create a new class implementing `MediationBannerAd`. The `loadBannerAd()` method calls a loader class (e.g., `SampleBannerCustomEventLoader`) to load the ad, manage configuration, and handle callbacks. This loader class also implements `MediationBannerAd`, loading the banner and invoking `MediationAdLoadCallback` methods. The UI-defined custom event parameters are accessed via ad configuration. Upon success or failure, `onSuccess()` or `onFailure()` are invoked, and the `MediationBannerAdCallback` is utilized to forward third-party SDK presentation events.\n"],null,["Prerequisites\n\nComplete the [custom events setup](/ad-manager/mobile-ads-sdk/android/custom-events/setup).\n\nRequest a banner ad\n\nWhen the custom event line item is reached in the waterfall mediation chain,\nthe `loadBannerAd()` method is called on the class name you provided when\n[creating a custom\nevent](custom-events/setup#create). In this case,\nthat method is in `SampleCustomEvent`, which then calls the `loadBannerAd()`\nmethod in `SampleBannerCustomEventLoader`.\n\nTo request a banner ad, create or modify a class that extends `Adapter` to\nimplement `loadBannerAd()`. Additionally, create a new class to implement\n`MediationBannerAd`.\n\nIn our [custom event example](//github.com/googleads/googleads-mobile-android-mediation/blob/main/Example/customevent/src/main/java/com/google/ads/mediation/sample/customevent/SampleCustomEvent.java),\n`SampleCustomEvent` extends the `Adapter` class and then delegates to\n`SampleBannerCustomEventLoader`. \n\nJava \n\n```java\npackage com.google.ads.mediation.sample.customevent;\n\nimport com.google.android.gms.ads.mediation.Adapter;\nimport com.google.android.gms.ads.mediation.MediationAdConfiguration;\nimport com.google.android.gms.ads.mediation.MediationAdLoadCallback;\nimport com.google.android.gms.ads.mediation.MediationBannerAd;\nimport com.google.android.gms.ads.mediation.MediationBannerAdCallback;\n...\n\npublic class SampleCustomEvent extends Adapter {\n private SampleBannerCustomEventLoader bannerLoader;\n @Override\n public void loadBannerAd(\n @NonNull MediationBannerAdConfiguration adConfiguration,\n @NonNull MediationAdLoadCallback\u003cMediationBannerAd, MediationBannerAdCallback\u003e callback) {\n bannerLoader = new SampleBannerCustomEventLoader(adConfiguration, callback);\n bannerLoader.loadAd();\n }\n}\n```\n\n`SampleBannerCustomEventLoader` is responsible for the following tasks:\n\n- Loading the banner ad and invoking a\n [`MediationAdLoadCallback`](/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/mediation/MediationAdLoadCallback)\n method once loading completes.\n\n- Implementing the `MediationBannerAd` interface.\n\n- Receiving and reporting ad event callbacks to Google Mobile Ads SDK.\n\nThe optional parameter defined in the UI is\nincluded in the ad configuration. The parameter can be accessed through\n`adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD)`.\nThis parameter is typically an ad unit identifier that an ad network SDK\nrequires when instantiating an ad object. \n\nJava \n\n```java\npackage com.google.ads.mediation.sample.customevent;\n\nimport com.google.android.gms.ads.mediation.Adapter;\nimport com.google.android.gms.ads.mediation.MediationBannerAdConfiguration;\nimport com.google.android.gms.ads.mediation.MediationAdLoadCallback;\nimport com.google.android.gms.ads.mediation.MediationBannerAd;\nimport com.google.android.gms.ads.mediation.MediationBannerAdCallback;\n...\n\npublic class SampleBannerCustomEventLoader extends SampleAdListener implements MediationBannerAd {\n\n /** View to contain the sample banner ad. */\n private SampleAdView sampleAdView;\n\n /** Configuration for requesting the banner ad from the third-party network. */\n private final MediationBannerAdConfiguration mediationBannerAdConfiguration;\n\n /** Callback that fires on loading success or failure. */\n private final MediationAdLoadCallback\u003cMediationBannerAd, MediationBannerAdCallback\u003e\n mediationAdLoadCallback;\n\n /** Callback for banner ad events. */\n private MediationBannerAdCallback bannerAdCallback;\n\n /** Constructor. */\n public SampleBannerCustomEventLoader(\n @NonNull MediationBannerAdConfiguration mediationBannerAdConfiguration,\n @NonNull MediationAdLoadCallback\u003cMediationBannerAd, MediationBannerAdCallback\u003e\n mediationAdLoadCallback) {\n this.mediationBannerAdConfiguration = mediationBannerAdConfiguration;\n this.mediationAdLoadCallback = mediationAdLoadCallback;\n }\n\n /** Loads a banner ad from the third-party ad network. */\n public void loadAd() {\n // All custom events have a server parameter named \"parameter\" that returns\n // back the parameter entered into the UI when defining the custom event.\n Log.i(\"BannerCustomEvent\", \"Begin loading banner ad.\");\n String serverParameter =\n mediationBannerAdConfiguration.getServerParameters().getString(\n MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD);\n\n Log.d(\"BannerCustomEvent\", \"Received server parameter.\");\n\n Context context = mediationBannerAdConfiguration.getContext();\n sampleAdView = new SampleAdView(context);\n\n // Assumes that the serverParameter is the ad unit of the Sample Network.\n sampleAdView.setAdUnit(serverParameter);\n AdSize size = mediationBannerAdConfiguration.getAdSize();\n\n // Internally, smart banners use constants to represent their ad size, which\n // means a call to AdSize.getHeight could return a negative value. You can\n // accommodate this by using AdSize.getHeightInPixels and\n // AdSize.getWidthInPixels instead, and then adjusting to match the device's\n // display metrics.\n int widthInPixels = size.getWidthInPixels(context);\n int heightInPixels = size.getHeightInPixels(context);\n DisplayMetrics displayMetrics = Resources.getSystem().getDisplayMetrics();\n int widthInDp = Math.round(widthInPixels / displayMetrics.density);\n int heightInDp = Math.round(heightInPixels / displayMetrics.density);\n\n sampleAdView.setSize(new SampleAdSize(widthInDp, heightInDp));\n sampleAdView.setAdListener(this);\n\n SampleAdRequest request = createSampleRequest(mediationBannerAdConfiguration);\n Log.i(\"BannerCustomEvent\", \"Start fetching banner ad.\");\n sampleAdView.fetchAd(request);\n }\n\n public SampleAdRequest createSampleRequest(\n MediationAdConfiguration mediationAdConfiguration) {\n SampleAdRequest request = new SampleAdRequest();\n request.setTestMode(mediationAdConfiguration.isTestRequest());\n request.setKeywords(mediationAdConfiguration.getMediationExtras().keySet());\n return request;\n }\n}\n```\n\nDepending on whether the ad is successfully fetched or encounters an error, you\nwould call either\n[`onSuccess()`](/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/mediation/MediationAdLoadCallback#onSuccess(MediationAdT))\nor\n[`onFailure()`](/ad-manager/mobile-ads-sdk/android/reference/com/google/android/gms/ads/mediation/MediationAdLoadCallback#onFailure(com.google.android.gms.ads.AdError)).\n`onSuccess()` is called by passing in an instance of the class that implements\n`MediationBannerAd`.\n\nTypically, these methods are implemented inside callbacks from the\nthird-party SDK your adapter implements. For this example, the Sample SDK\nhas a `SampleAdListener` with relevant callbacks: \n\nJava \n\n```java\n@Override\npublic void onAdFetchSucceeded() {\n bannerAdCallback = mediationAdLoadCallback.onSuccess(this);\n}\n\n@Override\npublic void onAdFetchFailed(SampleErrorCode errorCode) {\n mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode));\n}\n```\n\n`MediationBannerAd` requires implementing a `View` getter method: \n\nJava \n\n```java\n@Override\n@NonNull\npublic View getView() {\n return sampleAdView;\n}\n```\n\nForward mediation events to Google Mobile Ads SDK\n\nOnce `onSuccess()` is called, the returned `MediationBannerAdCallback` object\ncan then be used by the adapter to forward presentation events from the\nthird-party SDK to Google Mobile Ads SDK. The\n`SampleBannerCustomEventLoader` class extends the `SampleAdListener` interface\nto forward callbacks from the sample ad network to Google Mobile Ads SDK.\n\nIt's important that your custom event forwards as many of these callbacks as\npossible, so that your app receives these equivalent events from the Google\nMobile Ads SDK. Here's an example of using callbacks: \n\nJava \n\n```java\n@Override\npublic void onAdFullScreen() {\n bannerAdCallback.onAdOpened();\n bannerAdCallback.reportAdClicked();\n}\n\n@Override\npublic void onAdClosed() {\n bannerAdCallback.onAdClosed();\n}\n```\n\nThis completes the custom events implementation for banner ads. The full example\nis available on\n[GitHub](//github.com/googleads/googleads-mobile-android-mediation/tree/master/Example/customevent/src/main/java/com/google/ads/mediation/sample/customevent).\nYou can use it with an ad network that is already supported or modify it to\ndisplay custom event banner ads."]]
