Geçiş reklamları özel etkinlikleri

Ön koşullar

Özel etkinlik ayarlarını tamamlayın.

Geçiş reklamı isteme

Özel etkinlik satır öğesine şelale uyumlulaştırma zincirinde ulaşıldığında, loadInterstitialAd() yöntemi, özel bakın. Böyle durumlarda bu yöntem SampleCustomEvent içindedir; bu yöntem de SampleInterstitialCustomEventLoader konumunda loadInterstitialAd() yöntemi.

Geçiş reklamı istemek için Adapter uzantısını genişleten bir sınıf oluşturun veya mevcut sınıfınızda değişiklik yapın loadInterstitialAd() uygulamak için. Ayrıca, yeni bir sınıf oluşturarak MediationInterstitialAd uygulayın.

Özel etkinlik örneğimizde, SampleCustomEvent, Adapter sınıfını genişletir ve ardından şuna yetki verir: SampleInterstitialCustomEventLoader.

Java

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.MediationInterstitialAd;
import com.google.android.gms.ads.mediation.MediationInterstitialAdCallback;
...

public class SampleCustomEvent extends Adapter {
  private SampleInterstitialCustomEventLoader interstitialLoader;
  @Override
  public void loadInterstitialAd(
      @NonNull MediationInterstitialAdConfiguration adConfiguration,
      @NonNull
          MediationAdLoadCallback<MediationInterstitialAd, MediationInterstitialAdCallback>
              callback) {
    interstitialLoader = new SampleInterstitialCustomEventLoader(adConfiguration, callback);
    interstitialLoader.loadAd();
  }
}

SampleInterstitialCustomEventLoader şu görevlerden sorumludur:

  • Geçiş reklamını yükleme ve MediationAdLoadCallback yöntemini kullanın.

  • MediationInterstitialAd arayüzü kullanımı.

  • Google Mobile Ads SDK'sına reklam etkinliği geri çağırmaları alma ve raporlama

AdMob kullanıcı arayüzünde tanımlanan isteğe bağlı parametre dahil edilir. Parametreye adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD) Bu parametre, genellikle bir reklam ağı SDK'sının etkinleştirdiği reklam birimi tanımlayıcısıdır örnek oluştururken gerekir.

Java

package com.google.ads.mediation.sample.customevent;

import com.google.android.gms.ads.mediation.Adapter;
import com.google.android.gms.ads.mediation.MediationInterstitialAdConfiguration;
import com.google.android.gms.ads.mediation.MediationAdLoadCallback;
import com.google.android.gms.ads.mediation.MediationInterstitialAd;
import com.google.android.gms.ads.mediation.MediationInterstitialAdCallback;
...

public class SampleInterstitialCustomEventLoader extends SampleAdListener
    implements MediationInterstitialAd {

  /** A sample third-party SDK interstitial ad. */
  private SampleInterstitial sampleInterstitialAd;

  /** Configuration for requesting the interstitial ad from the third-party network. */
  private final MediationInterstitialAdConfiguration mediationInterstitialAdConfiguration;

  /** Callback for interstitial ad events. */
  private MediationInterstitialAdCallback interstitialAdCallback;

  /** Callback that fires on loading success or failure. */
  private final MediationAdLoadCallback<MediationInterstitialAd, MediationInterstitialAdCallback>
      mediationAdLoadCallback;

  /** Constructor. */
  public SampleInterstitialCustomEventLoader(
      @NonNull MediationInterstitialAdConfiguration mediationInterstitialAdConfiguration,
      @NonNull MediationAdLoadCallback<MediationInterstitialAd, MediationInterstitialAdCallback>
              mediationAdLoadCallback) {
    this.mediationInterstitialAdConfiguration = mediationInterstitialAdConfiguration;
    this.mediationAdLoadCallback = mediationAdLoadCallback;
  }

  /** Loads the interstitial 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("InterstitialCustomEvent", "Begin loading interstitial ad.");
    String serverParameter = mediationInterstitialAdConfiguration.getServerParameters().getString(
        MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD);
    Log.d("InterstitialCustomEvent", "Received server parameter.");

    sampleInterstitialAd =
        new SampleInterstitial(mediationInterstitialAdConfiguration.getContext());
    sampleInterstitialAd.setAdUnit(serverParameter);

    // Implement a SampleAdListener and forward callbacks to mediation.
    sampleInterstitialAd.setAdListener(this);

    // Make an ad request.
    Log.i("InterstitialCustomEvent", "start fetching interstitial ad.");
    sampleInterstitialAd.fetchAd(
        SampleCustomEvent.createSampleRequest(mediationInterstitialAdConfiguration));
  }

public SampleAdRequest createSampleRequest(
      MediationAdConfiguration mediationAdConfiguration) {
    SampleAdRequest request = new SampleAdRequest();
    request.setTestMode(mediationAdConfiguration.isTestRequest());
    request.setKeywords(mediationAdConfiguration.getMediationExtras().keySet());
    return request;
  }
}

Reklamın başarılı bir şekilde getirilmesine veya bir hatayla karşılaşmasına bağlı olarak ondan birini onSuccess() veya onFailure(). onSuccess(), şunu uygulayan sınıfın bir örneğini geçirerek çağrılır: MediationInterstitialAd.

Genellikle bu yöntemler üçüncü taraf SDK'sı oluşturun. Bu örnekte, örnek SDK alakalı geri çağırmaları içeren bir SampleAdListener içeriyor:

Java

@Override
public void onAdFetchSucceeded() {
  interstitialAdCallback = mediationAdLoadCallback.onSuccess(this);
}

@Override
public void onAdFetchFailed(SampleErrorCode errorCode) {
  mediationAdLoadCallback.onFailure(SampleCustomEventError.createSampleSdkError(errorCode));
}

MediationInterstitialAd, görüntüleme için showAd() yönteminin uygulanmasını gerektiriyor reklam:

Java

@Override
public void showAd(@NonNull Context context) {
  sampleInterstitialAd.show();
}

Uyumlulaştırma etkinliklerini Google Mobile Ads SDK'sına yönlendirme

onSuccess() çağrıldığında, MediationInterstitialAdCallback değeri döndürülür. nesne, daha sonra bağdaştırıcı tarafından Google Mobile Ads SDK'sına üçüncü taraf SDK'sı eklemek için kullanılır. İlgili içeriği oluşturmak için kullanılan SampleInterstitialCustomEventLoader sınıfı SampleAdListener kapsamına girer örnek reklam ağından Google Mobil Ads SDK'sı.

Özel etkinliğinizin bu geri çağırmalardan mümkün olduğunca çoğunu yönlendirmesi Böylece uygulamanız, Google Ads'den bu eşdeğer etkinlikleri Mobile Ads SDK'sı. Aşağıda, geri çağırma işlevinin kullanımına dair bir örnek verilmiştir:

Java

@Override
public void onAdFullScreen() {
  interstitialAdCallback.reportAdImpression();
  interstitialAdCallback.onAdOpened();
}

@Override
public void onAdClosed() {
  interstitialAdCallback.onAdClosed();
}

Böylece geçiş reklamları için özel etkinlik uygulaması tamamlanır. Tam örneğin şurada mevcuttur: GitHub'a gidin. Bunu zaten desteklenen bir reklam ağıyla kullanabilir veya şuna göre değiştirebilirsiniz: Görüntülü reklam özel etkinlik geçiş reklamları.