راه اندازی

پلتفرم مورد نظر: اندروید، iOS و یونیتی

رویدادهای سفارشی به شما امکان می‌دهند میانجیگری آبشاری را برای یک شبکه تبلیغاتی که یک شبکه تبلیغاتی پشتیبانی‌شده نیست، اضافه کنید. شما این کار را با پیاده‌سازی یک آداپتور رویداد سفارشی برای شبکه تبلیغاتی که می‌خواهید ادغام کنید، انجام می‌دهید.

پیش‌نیازها

قبل از اینکه بتوانید رویدادهای سفارشی ایجاد کنید، ابتدا باید یکی از قالب‌های تبلیغاتی زیر را در برنامه خود ادغام کنید:

ایجاد یک رویداد سفارشی در رابط کاربری

ابتدا باید یک رویداد سفارشی در رابط کاربری مدیر تبلیغات ایجاد شود. به دستورالعمل‌های موجود در ایجاد و مدیریت گروه‌های بازده مراجعه کنید.

شما باید موارد زیر را ارائه دهید:

نام کلاس

نام کامل کلاسی که آداپتور رویداد سفارشی را پیاده‌سازی می‌کند - برای مثال، com.google.ads.mediation.sample.customevent.SampleCustomEvent . به عنوان یک روش بهینه، توصیه می‌کنیم از یک کلاس آداپتور واحد برای همه قالب‌های تبلیغات رویداد سفارشی استفاده کنید.

برچسب

یک نام منحصر به فرد که منبع تبلیغ را تعریف می‌کند.

پارامتر

یک آرگومان رشته‌ای اختیاری که به آداپتور رویداد سفارشی شما ارسال می‌شود.

مقداردهی اولیه آداپتور

وقتی SDK تبلیغات موبایلی گوگل مقداردهی اولیه می‌شود، initialize() روی تمام آداپتورهای شخص ثالث پشتیبانی‌شده و رویدادهای سفارشی پیکربندی‌شده برای برنامه در رابط کاربری Ad Manager فراخوانی می‌شود. از این روش برای انجام هرگونه تنظیم یا مقداردهی اولیه لازم روی SDK شخص ثالث مورد نیاز برای رویداد سفارشی خود استفاده کنید.

جاوا

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();
  }
}

کاتلین

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 شخص ثالثی که رویداد سفارشی با آن ارتباط برقرار می‌کند را به SDK تبلیغات موبایل گوگل گزارش دهند. نسخه‌ها به عنوان اشیاء VersionInfo گزارش می‌شوند:

جاوا

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);
  }
}

کاتلین

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)
  }
}

درخواست تبلیغ

برای درخواست آگهی، به دستورالعمل‌های مربوط به قالب آگهی مراجعه کنید: