Configuration

Les événements personnalisés vous permettent d'ajouter une médiation en cascade pour un réseau publicitaire qui n'est pas un réseau publicitaire compatible. Pour ce faire, implémentez un adaptateur d'événement personnalisé pour le réseau publicitaire que vous souhaitez intégrer.

Vous trouverez un exemple complet de projet d'événement personnalisé sur notre page GitHub repo.

Prérequis

Avant de pouvoir créer des événements personnalisés, vous devez d'abord intégrer l'un des formats d'annonces suivants dans votre application :

Créer un événement personnalisé dans l'interface utilisateur

Vous devez d'abord créer un événement personnalisé dans AdMob UI. Consultez les instructions fournies dans l'article Ajoutez un événement personnalisé.

Vous devez fournir les éléments suivants :

Nom de la classe

Nom complet de la classe qui implémente l'événement personnalisé. adaptateur secteur, par exemple SampleCustomEvent; ou si votre classe est implémentée en Swift, MediationExample.SampleCustomEventSwift

Le nom de la cible est obligatoire si votre projet comporte plusieurs cibles ou si le nom du projet est différent du nom de la cible. Avec le nom de la cible, ressemblerait à ceci: appName_targetName.className. De plus, n'oubliez pas pour remplacer tous les caractères non alphanumériques tels que les tirets par des traits de soulignement. Exemple :

Libellé

Nom unique définissant la source d'annonces.

Paramètre

Argument de chaîne facultatif transmis à votre adaptateur d'événement personnalisé.

Implémenter GADMediationAdapter

Pour créer un événement personnalisé, la première étape consiste à implémenter Protocole GADMediationAdapter, comme indiqué par la classe SampleCustomEvent dans notre exemple.

Cette classe est chargée de recevoir les messages d'AdMob et de déléguer la création du bon format d'annonce.

Initialiser l'adaptateur

Lorsque le SDK Google Mobile Ads s'initialise, setUpWithConfiguration:completionHandler: est appelé sur tous les adaptateurs tiers compatibles et les événements personnalisés configurés pour l'application dans l'interface utilisateur AdMob. Utilisez cette méthode pour effectuer toute configuration ou initialisation nécessaire sur le SDK tiers requis pour votre événement personnalisé.

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

Numéros de version des rapports

Tous les événements personnalisés doivent indiquer au SDK Google Mobile Ads à la fois la version de l'adaptateur d'événement personnalisé et la version du SDK tiers avec lequel l'événement personnalisé interagit. Les versions sont signalées comme GADVersionNumber Objets:

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

Demander une annonce

Pour demander une annonce, reportez-vous aux instructions spécifiques au format d'annonce :