Konfiguracja

Zdarzenia niestandardowe pozwalają dodać zapośredniczenie kaskadowe dla sieci reklamowej, która nie jest obsługiwanej sieci reklamowej. Ty to poprzez wdrożenie adaptera zdarzenia niestandardowego dla sieci reklamowej, którą chcesz i integrację.

Wymagania wstępne

Zanim utworzysz zdarzenia niestandardowe, musisz zintegrować ten format reklamy do aplikacji:

Tworzenie zdarzenia niestandardowego w interfejsie

Zdarzenie niestandardowe należy najpierw utworzyć w usłudze Ad Manager Interfejs. Zapoznaj się z instrukcjami w sekcji Generowanie zysków i zarządzanie nimi grup.

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 z 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.

Wdrażanie narzędzia 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 Ad Managera 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 Ad Managera. Użyj tej metody, aby: przeprowadź niezbędną konfigurację lub zainicjowanie wymaganego pakietu SDK innej firmy. dla swojego 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 raportu

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 jako GADVersionNumber obiekty:

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ę, zapoznaj się z instrukcjami dotyczącymi danego formatu reklamy: