Konfiguracja

Zdarzenia niestandardowe umożliwiają dodanie zapośredniczenia kaskadowego w przypadku sieci reklamowej, która nie jest obsługiwana przez AdMob. Robisz to, implementując adapter zdarzenia niestandardowego na potrzeby sieci reklamowej, którą chcesz zintegrować;

Pełny przykładowy projekt zdarzenia niestandardowego znajdziesz w naszym repozytorium GitHub.

Wymagania wstępne

Zanim utworzysz zdarzenia niestandardowe, musisz najpierw zintegrować w aplikacji jeden z tych formatów reklam:

Tworzenie zdarzenia niestandardowego w interfejsie

Zdarzenie niestandardowe musi zostać utworzone w interfejsie AdMob. Zapoznaj się z instrukcjami w sekcji Dodaj zdarzenie niestandardowe.

Musisz dostarczyć:

Nazwa zajęć

Pełna nazwa klasy, która implementuje zdarzenie niestandardowe np. SampleCustomEvent; lub jeśli klasa jest zaimplementowana w kodzie Swift, MediationExample.SampleCustomEventSwift

Nazwa miejsca docelowego jest wymagana, jeśli w projekcie masz wiele celów lub jeśli nazwa projektu jest inna niż nazwa miejsca docelowego. Dzięki nazwie elementu docelowego wygląda tak: appName_targetName.className. Pamiętaj też, , aby zastąpić wszystkie znaki niealfanumeryczne, na przykład łączniki, podkreśleniami. Przykład:

Etykieta

Unikalna nazwa określająca źródło reklam.

Parametr

Opcjonalny argument w postaci ciągu przekazywany do adaptera zdarzeń niestandardowych.

Implementacja klasy GADMediationAdapter

Pierwszym krokiem do utworzenia zdarzenia niestandardowego jest zaimplementowanie tagu Protokół GADMediationAdapter pokazany przez klasę SampleCustomEvent w naszym przykładzie.

Te zajęcia odpowiadają za otrzymywanie wiadomości od AdMob i przekazywać odpowiedzialność za tworzenie z prawidłowym formatem reklamy.

Zainicjuj adapter

Po uruchomieniu pakietu SDK do reklam mobilnych Google setUpWithConfiguration:completionHandler: jest wywoływana w przypadku wszystkich obsługiwanych adapterów innych firm i zdarzeń niestandardowych dla aplikacji w interfejsie AdMob. Użyj tej metody, aby przeprowadzić niezbędną konfigurację lub inicjowanie wymaganego pakietu SDK innej firmy w przypadku zdarzenia niestandardowego.

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

Numery wersji w raporcie

Wszystkie zdarzenia niestandardowe muszą raportować do pakietu SDK do reklam mobilnych Google zarówno wersję samego adaptera zdarzeń niestandardowych oraz wersji pakietu SDK firmy zewnętrznej, niestandardowych zdarzeń. Wersje są raportowane jakoGADVersionNumberobiekty:

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

Żądanie reklamy

Aby poprosić o reklamę, postępuj zgodnie z instrukcjami dotyczącymi danego formatu reklamy: