Doğal reklamlar özel etkinlikleri

Ön koşullar

Özel etkinlik kurulumunu tamamlayın.

Yerel reklam isteme

Özel etkinlik satır öğesine şelale uyumlulaştırma zincirinde ulaşıldığında, loadNativeAd() yöntemi, özel bir bakın. Böyle durumlarda bu yöntem SampleCustomEvent içindedir ve bu durumda SampleNativeCustomEventLoader içinde loadNativeAd() yöntemi.

Yerel reklam istemek için loadNativeAd()'ü uygulamak üzere Adapter'ü genişleten bir sınıf oluşturun veya mevcut bir sınıfta değişiklik yapın. Adapter sınıfını genişleten bir sınıf zaten varsa loadNativeAd() sınıfını buraya uygulayın. Ayrıca, UnifiedNativeAdMapper özelliğini uygulamak için yeni bir sınıf oluşturun.

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

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.MediationNativeAdCallback;
...
public class SampleCustomEvent extends Adapter {
  private SampleNativeCustomEventLoader nativeLoader;

  @Override
  public void loadNativeAd(
      @NonNull MediationNativeAdConfiguration adConfiguration,
      @NonNull MediationAdLoadCallback<UnifiedNativeAdMapper, MediationNativeAdCallback> callback) {
    nativeLoader = new SampleNativeCustomEventLoader(adConfiguration, callback);
    nativeLoader.loadAd();
  }
}

SampleNativeCustomEventLoader aşağıdaki görevlerden sorumludur:

  • Doğal reklam yükleniyor.

  • UnifiedNativeAdMapper sınıfını uygulama.

  • Google Mobile Ads SDK'sına reklam etkinliği geri çağırma isteklerini alma ve bildirme.

AdMob kullanıcı arayüzünde tanımlanan isteğe bağlı parametre, reklam yapılandırmasına dahil edilir. Parametreye adConfiguration.getServerParameters().getString(MediationConfiguration.CUSTOM_EVENT_SERVER_PARAMETER_FIELD) üzerinden erişilebilir. 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.MediationNativeAdConfiguration;
import com.google.android.gms.ads.mediation.MediationAdLoadCallback;
import com.google.android.gms.ads.mediation.MediationNativeAdCallback;
...

public class SampleNativeCustomEventLoader extends SampleNativeAdListener {
  /** Configuration for requesting the native ad from the third-party network. */
  private final MediationNativeAdConfiguration mediationNativeAdConfiguration;

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

  /** Callback for native ad events. */
  private MediationNativeAdCallback nativeAdCallback;

  /** Constructor */
  public SampleNativeCustomEventLoader(
      @NonNull MediationNativeAdConfiguration mediationNativeAdConfiguration,
      @NonNull MediationAdLoadCallback<MediationNativeAd, MediationNativeAdCallback>
              mediationAdLoadCallback) {
    this.mediationNativeAdConfiguration = mediationNativeAdConfiguration;
    this.mediationAdLoadCallback = mediationAdLoadCallback;
  }

  /** Loads the native ad from the third-party ad network. */
  public void loadAd() {
    // Create one of the Sample SDK's ad loaders to request ads.
    Log.i("NativeCustomEvent", "Begin loading native ad.");
    SampleNativeAdLoader loader =
        new SampleNativeAdLoader(mediationNativeAdConfiguration.getContext());

    // All custom events have a server parameter named "parameter" that returns
    // back the parameter entered into the UI when defining the custom event.
    String serverParameter = mediationNativeAdConfiguration
        .getServerParameters()
        .getString(MediationConfiguration
        .CUSTOM_EVENT_SERVER_PARAMETER_FIELD);
    Log.d("NativeCustomEvent", "Received server parameter.");

    loader.setAdUnit(serverParameter);

    // Create a native request to give to the SampleNativeAdLoader.
    SampleNativeAdRequest request = new SampleNativeAdRequest();
    NativeAdOptions options = mediationNativeAdConfiguration.getNativeAdOptions();
    if (options != null) {
      // If the NativeAdOptions' shouldReturnUrlsForImageAssets is true, the adapter should
      // send just the URLs for the images.
      request.setShouldDownloadImages(!options.shouldReturnUrlsForImageAssets());

      request.setShouldDownloadMultipleImages(options.shouldRequestMultipleImages());
      switch (options.getMediaAspectRatio()) {
        case NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE:
          request.setPreferredImageOrientation(SampleNativeAdRequest.IMAGE_ORIENTATION_LANDSCAPE);
          break;
        case NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_PORTRAIT:
          request.setPreferredImageOrientation(SampleNativeAdRequest.IMAGE_ORIENTATION_PORTRAIT);
          break;
        case NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_SQUARE:
        case NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_ANY:
        case NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_UNKNOWN:
        default:
          request.setPreferredImageOrientation(SampleNativeAdRequest.IMAGE_ORIENTATION_ANY);
      }
    }

    loader.setNativeAdListener(this);

    // Begin a request.
    Log.i("NativeCustomEvent", "Start fetching native ad.");
    loader.fetchAd(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(), MediationNativeAd'u uygulayan sınıfın bir örneği geçirilerek çağrılır.

Bu yöntemler genellikle, bağdaştırıcının uyguladığı üçüncü taraf SDK'dan gelen geri çağırma işlevleri içinde uygulanır. Bu örnekte, Örnek SDK'da alakalı geri çağırmalara sahip bir SampleAdListener vardır:

Java

@Override
public void onNativeAdFetched(SampleNativeAd ad) {
  SampleUnifiedNativeAdMapper mapper = new SampleUnifiedNativeAdMapper(ad);
  mediationNativeAdCallback = mediationAdLoadCallback.onSuccess(mapper);
}

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

Doğal reklamları eşleştirme

Farklı SDK'ların doğal reklamlar için kendine özgü biçimleri vardır. Birisi geri gelebilir "başlık" içeren nesneler bir diğeri ise "başlık". Ayrıca, gösterimleri izlemek ve tıklamaları işlemek için kullanılan yöntemler SDK'ya göre değişiklik gösterebilir.

UnifiedNativeAdMapper, bu farklılıkları uzlaştırmaktan ve aracı SDK'nın yerel reklam nesnesini Google Mobile Ads SDK'sı tarafından beklenen arayüzle eşleşecek şekilde uyarlamaktan sorumludur. Özel etkinlikler, aracı SDK'larına özel kendi eşleyicilerini oluşturmak için bu sınıfı genişletmelidir. Aşağıda, örnek özel etkinlik projemizdeki bir reklam eşleyici örneği verilmiştir:

Java

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

import com.google.android.gms.ads.mediation.UnifiedNativeAdMapper;
import com.google.android.gms.ads.nativead.NativeAd;
...

public class SampleUnifiedNativeAdMapper extends UnifiedNativeAdMapper {

  private final SampleNativeAd sampleAd;

  public SampleUnifiedNativeAdMapper(SampleNativeAd ad) {
    sampleAd = ad;
    setHeadline(sampleAd.getHeadline());
    setBody(sampleAd.getBody());
    setCallToAction(sampleAd.getCallToAction());
    setStarRating(sampleAd.getStarRating());
    setStore(sampleAd.getStoreName());
    setIcon(
        new SampleNativeMappedImage(
            ad.getIcon(), ad.getIconUri(), SampleCustomEvent.SAMPLE_SDK_IMAGE_SCALE));
    setAdvertiser(ad.getAdvertiser());

    List<NativeAd.Image> imagesList = new ArrayList<NativeAd.Image>();
    imagesList.add(new SampleNativeMappedImage(ad.getImage(), ad.getImageUri(),
        SampleCustomEvent.SAMPLE_SDK_IMAGE_SCALE));
    setImages(imagesList);

    if (sampleAd.getPrice() != null) {
      NumberFormat formatter = NumberFormat.getCurrencyInstance();
      String priceString = formatter.format(sampleAd.getPrice());
      setPrice(priceString);
    }

    Bundle extras = new Bundle();
    extras.putString(SampleCustomEvent.DEGREE_OF_AWESOMENESS, ad.getDegreeOfAwesomeness());
    this.setExtras(extras);

    setOverrideClickHandling(false);
    setOverrideImpressionRecording(false);

    setAdChoicesContent(sampleAd.getInformationIcon());
  }

  @Override
  public void recordImpression() {
    sampleAd.recordImpression();
  }

  @Override
  public void handleClick(View view) {
    sampleAd.handleClick(view);
  }

  // The Sample SDK doesn't do its own impression/click tracking, instead relies on its
  // publishers calling the recordImpression and handleClick methods on its native ad object. So
  // there's no need to pass a reference to the View being used to display the native ad. If
  // your mediated network does need a reference to the view, the following method can be used
  // to provide one.

  @Override
  public void trackViews(View containerView, Map<String, View> clickableAssetViews,
      Map<String, View> nonClickableAssetViews) {
    super.trackViews(containerView, clickableAssetViews, nonClickableAssetViews);
    // If your ad network SDK does its own impression tracking, here is where you can track the
    // top level native ad view and its individual asset views.
  }

  @Override
  public void untrackView(View view) {
    super.untrackView(view);
    // Here you would remove any trackers from the View added in trackView.
  }
}

Şimdi, oluşturucu koduna daha yakından bakalım.

Uyumlulaştırılmış yerel reklam nesnesine referans tutma

Oluşturucu, kullanılan yerel reklam sınıfı olan SampleNativeAd parametresini kabul eder tarafından kullanmayı öğreteceğiz. Tıklama ve gösterim etkinliklerini iletebilmesi için eşlenen reklama referans vermesi gerekir. SampleNativeAd yerel değişken olarak saklanır.

Eşlenen öğe özelliklerini ayarlama

Oluşturucu SampleNativeAd nesnesini kullanarak UnifiedNativeAdMapper.

Bu snippet, aracılı reklamın fiyat verilerini alır ve eşleyicinin fiyatını ayarlamak için kullanır:

Java

if (sampleAd.getPrice() != null) {
    NumberFormat formatter = NumberFormat.getCurrencyInstance();
    String priceString = formatter.format(sampleAd.getPrice());
    setPrice(priceString);
}

Bu örnekte, uyumlulaştırılmış reklam, fiyatı double olarak depolarken, uyumlulaştırılmış reklam AdMob aynı öğe için bir String kullanır. Bu tür dönüşümleri işlemekten eşleyici sorumludur.

Resim öğelerini eşleme

Resim öğelerini eşlemek, aşağıdaki gibi veri türlerini eşlemekten daha karmaşıktır: double veya String. Resimler otomatik olarak indirilebilir veya URL değerleri olarak döndürülebilir. Piksel-dpi ölçekleri de değişiklik gösterebilir.

Google Mobile Ads SDK'sı, bu ayrıntıları yönetmenize yardımcı olmak için NativeAd.Image sınıfını sağlar. Alt sınıf oluşturma işlemine benzer şekilde Uyumlulaştırılmış bir yerel reklam eşlemek için UnifiedNativeAdMapper alt sınıfını kullanır.NativeAd.Image

Özel etkinliğin SampleNativeMappedImage sınıfı için bir örnek aşağıda verilmiştir:

Java

public class SampleNativeMappedImage extends NativeAd.Image {

  private Drawable drawable;
  private Uri imageUri;
  private double scale;

  public SampleNativeMappedImage(Drawable drawable, Uri imageUri, double scale) {
    this.drawable = drawable;
    this.imageUri = imageUri;
    this.scale = scale;
  }

  @Override
  public Drawable getDrawable() {
    return drawable;
  }

  @Override
  public Uri getUri() {
    return imageUri;
  }

  @Override
  public double getScale() {
    return scale;
  }
}

SampleNativeAdMapper, haritacı simgesi resim öğesidir:

Java

setIcon(new SampleNativeMappedImage(ad.getAppIcon(), ad.getAppIconUri(),
    SampleCustomEvent.SAMPLE_SDK_IMAGE_SCALE));

Ekstralar paketine alan ekleme

Bazı uyumlulaştırılmış SDK'lar, AdMob yerel reklam biçimi. UnifiedNativeAdMapper sınıfı, bu öğeleri yayıncılara iletmek için kullanılan bir setExtras() yöntemi içerir. SampleNativeAdMapper, bunu Örnek SDK'lar için kullanır. "mükemmellik derecesi" öğe:

Java

Bundle extras = new Bundle();
extras.putString(SampleCustomEvent.DEGREE_OF_AWESOMENESS, ad.getDegreeOfAwesomeness());
this.setExtras(extras);

Yayıncılar, NativeAd sınıfının getExtras() yöntemini kullanarak verileri alabilir.

Reklam Seçenekleri

Özel etkinliğiniz, UnifiedNativeAdMapper üzerinde setAdChoicesContent() yöntemi. Şuradan bir snippet: Reklam Seçenekleri simgesinin nasıl sağlanacağını gösteren SampleNativeAdMapper:

Java

public SampleNativeAdMapper(SampleNativeAd ad) {
    ...
    setAdChoicesContent(sampleAd.getInformationIcon());
}

Gösterim ve tıklama etkinlikleri

Hem Google Mobile Ads SDK'sının hem de aracı SDK'nın bir gösterim veya tıklamanın ne zaman gerçekleştiğini bilmesi gerekir ancak bu etkinliklerin yalnızca bir SDK tarafından izlenmesi gerekir. Aracılıklı SDK'nın gösterimleri ve tıklamaları kendi başına izlemeyi destekleyip desteklemediğine bağlı olarak, özel etkinliklerin kullanabileceği iki farklı yaklaşım vardır.

Tıklamaları ve gösterimleri Google Mobile Ads SDK'sıyla izleme

Uyumlulaştırılmış SDK kendi gösterim ve tıklama izlemeyi gerçekleştirmez, ancak Tıklamaları ve gösterimleri kaydetmeye yönelik yöntemler sağladığında Google Mobile Ads SDK'sı bu etkinlikleri takip edin ve bağdaştırıcıya bildirin. İlgili içeriği oluşturmak için kullanılan UnifiedNativeAdMapper sınıfı iki yöntem içerir: recordImpression() ve handleClick() özel etkinlikler, uyumlulaştırılmış doğal reklam nesnesi:

Java

@Override
public void recordImpression() {
  sampleAd.recordImpression();
}

@Override
public void handleClick(View view) {
  sampleAd.handleClick(view);
}

SampleNativeAdMapper, Örnek SDK'nın yerel öğesine referans içerdiği için bir tıklamayı bildirmek için söz konusu nesnede uygun yöntemi çağırabilir veya gösterimdir. handleClick() yönteminin tek parametre: View nesnesini oluşturan yerel reklam öğesine tıklama almış olabilir.

Uyumlulaştırılmış SDK ile tıklamaları ve gösterimleri izleme

Bazı aracı SDK'lar tıklamaları ve gösterimleri kendi başlarına izlemeyi tercih edebilir. Bu durumda, UnifiedNativeAdMapper sınıfınızın oluşturucuda aşağıdaki iki çağrıyı yaparak varsayılan tıklama ve gösterim izlemeyi geçersiz kılmanız gerekir:

Java

setOverrideClickHandling(true);
setOverrideImpressionRecording(true);

onAdClicked() ve onAdImpression() etkinliklerini Google Mobile Ads SDK'sına bildirmek için tıklama ve gösterim izlemeyi geçersiz kılan özel etkinlikler gereklidir.

Uyumlulaştırılmış SDK'nın, gösterimleri ve tıklamaları izlemek için görüntülemeyi etkinleştirmelisiniz. Özel etkinlik, trackViews() yöntemini kullanın ve yerel reklamın görünümünü uyumlulaştırılmış İzlenecek SDK. Özel etkinlik örnek projemizdeki örnek SDK (burada, bu kılavuzun kod snippet'leri alınmıştır) bu yaklaşımı kullanmamaktadır; ama eğer özel etkinlik kodu şu şekilde görünür:

Java

@Override
public void trackViews(View containerView,
    Map<String, View> clickableAssetViews,
    Map<String, View> nonClickableAssetViews) {
  sampleAd.setNativeAdViewForTracking(containerView);
}

Aracılıklı SDK, tek tek öğelerin izlenmesini destekliyorsa hangi görünümlerin tıklanabilir hale getirileceğini görmek için clickableAssetViews içine bakabilir. Bu harita, NativeAdAssetNames içindeki bir öğe adına göre anahtarlanır. UnifiedNativeAdMapper özel etkinliklerin geçersiz kılabileceği karşılık gelen bir untrackView() yöntemi sunar Görünüme ilişkin referansları serbest bırakma ve bunun yerel reklamla ilişkisini kesme nesnesini tanımlayın.

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

Uyumlulaştırmanın desteklediği tüm geri çağırma işlevlerini MediationNativeAdCallback belgelerinde bulabilirsiniz.

Uygulamanızın Google Mobile Ads SDK'sından bu eşdeğer etkinlikleri alması için özel etkinliğinizin bu geri çağırmalardan mümkün olduğunca fazlasını iletmesi önemlidir. Geri çağırma işlevlerinin kullanımına dair bir örnek aşağıda verilmiştir:

Böylece yerel reklamlar için özel etkinlik uygulaması tamamlanır. Tam örnek şurada kullanılabilir: GitHub'a gidin.