Kurulum

Özel etkinlikler, desteklenen reklam ağı olmayan bir reklam ağı için şelale uyumlulaştırması eklemenize olanak tanır. Bunu, Arkadaş Bitkiler projesinin entegre etmek istediğiniz reklam ağı için özel bir etkinlik bağdaştırıcısı oluşturun.

Ön koşullar

Özel etkinlikler oluşturabilmek için önce aşağıdaki reklam biçimini uygulamanıza ekleyin:

Kullanıcı arayüzünde özel etkinlik oluşturma

Öncelikle Ad Manager kullanıcı arayüzünde bir özel etkinlik oluşturulmalıdır. Talimatları şurada bulabilirsiniz: Getiri oluşturma ve yönetme grupları oluşturun.

Aşağıdakileri sağlamanız gerekir:

Sınıf Adı

Özel etkinliği uygulayan sınıfın tam adı bağdaştırıcısı (örneğin, SampleCustomEvent; sınıfınız Swift'te uygulandıysa MediationExample.SampleCustomEventSwift.

Projenizde birden fazla hedef varsa veya projenizde birden çok hedef varsa hedef ad gereklidir Proje adı, hedef addan farklı. Hedef adla birlikte şu şekilde görünür: appName_targetName.className. Ayrıca, kullanın. Örnek.

Şirket

Reklam kaynağını tanımlayan benzersiz bir ad.

Parametre

Özel etkinlik bağdaştırıcınıza iletilen isteğe bağlı bir dize bağımsız değişkeni.

GADUyumlulaştırmaAdapter'ı uygulama

Özel etkinlik oluşturmanın ilk adımı, örnekteki SampleCustomEvent sınıfında gösterildiği gibi GADMediationAdapter protokolünü uygulamaktır.

Ad Manager'dan mesaj almak ve doğru reklam biçimini oluşturma sorumluluğunu devretmek bu sınıfın sorumluluğundadır.

Adaptörü başlatma

Google Mobile Ads SDK'sı başlatıldığında, setUpWithConfiguration:completionHandler: tüm desteklenen üçüncü taraf bağdaştırıcılar ve Ad Manager kullanıcı arayüzünde uygulama için yapılandırılmış özel etkinliklerde çağrılır. Bu yöntemi şu amaçlarla kullanabilirsiniz: gerekli üçüncü taraf SDK'da gerekli kurulum veya başlatma işlemlerinin gerçekleştirilmesi özel etkinliğiniz için.

Swift

import GoogleMobileAds

class SampleCustomEvent: NSObject, GADMediationAdapter {

  static func setUpWith(
    _ configuration: GADMediationServerConfiguration,
    completionHandler: @escaping GADMediationAdapterSetUpCompletionBlock
  ) {
    // 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.
    completionHandler(nil)
  }
}

Objective-C

#import "SampleCustomEvent.h"

@implementation SampleCustomEvent

+ (void)setUpWithConfiguration:(nonnull GADMediationServerConfiguration *)configuration
             completionHandler:(nonnull GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // This is where you initialize the SDK that this custom event is built
  // for. Upon finishing the SDK initialization, call the completion handler
  // with success.
  completionHandler(nil);
}

Rapor sürüm numaraları

Tüm özel etkinlikler Google Mobile Ads SDK'sına hem üçüncü taraf SDK'nın sürümüne, kendi özel etkinlik bağdaştırıcısının kendisine ait özel etkinlik arayüzleri vardır. Sürümler GADVersionNumber nesneleri olarak raporlanır:

Swift

static func adSDKVersion() -> GADVersionNumber {
  let versionComponents = String(SampleSDKVersion).components(
    separatedBy: ".")

  if versionComponents.count >= 3 {
    let majorVersion = Int(versionComponents[0]) ?? 0
    let minorVersion = Int(versionComponents[1]) ?? 0
    let patchVersion = Int(versionComponents[2]) ?? 0

    return GADVersionNumber(
      majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
  }

  return GADVersionNumber()
}

static func adapterVersion() -> GADVersionNumber {
  let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
    separatedBy: ".")
  var version = GADVersionNumber()
  if versionComponents.count == 4 {
    version.majorVersion = Int(versionComponents[0]) ?? 0
    version.minorVersion = Int(versionComponents[1]) ?? 0
    version.patchVersion = Int(versionComponents[2]) * 100 + Int(versionComponents[3])
  }
  return version
}

Objective-C

+ (GADVersionNumber)adSDKVersion {
  NSArray *versionComponents =
      [SampleSDKVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count >= 3) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue];
  }
  return version;
}

+ (GADVersionNumber)adapterVersion {
  NSArray *versionComponents =
      [SampleCustomEventAdapterVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count == 4) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue] * 100 +
                           [versionComponents[3] integerValue];
  }
  return version;
}

Reklam isteğinde bulunma

Reklam isteğinde bulunmak için reklam biçimine özgü talimatları inceleyin: