Configuration

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

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'UI

Vous devez d'abord créer un événement personnalisé dans l'UI Ad Manager. Consultez les instructions de la section Créer et gérer des groupes de rendement.

Vous devez fournir les éléments suivants :

Nom de la classe

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

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

Libellé

Nom unique définissant la source de l'annonce.

Paramètre

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

Implémenter GADMediationAdapter

La première étape de la création d'un événement personnalisé consiste à implémenter le protocole GADMediationAdapter, comme le montre la classe SampleCustomEvent dans notre exemple.

Il incombe à cette classe de recevoir les messages d'Ad Manager et de déléguer la responsabilité de la création du format d'annonce approprié.

Initialiser l'adaptateur

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

Swift

import GoogleMobileAds

class SampleCustomEvent: NSObject, MediationAdapter {

  static func setUpWith(
    _ configuration: MediationServerConfiguration,
    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 être signalés au SDK Google Mobile Ads, à la fois la version de l'adaptateur d'événement personnalisé lui-même et la version du SDK tiers avec lequel les interfaces d'événement personnalisé interagissent. Les versions sont signalées comme des objets GADVersionNumber :

Swift

static func adSDKVersion() -> VersionNumber {
  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 VersionNumber(
      majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
  }

  return VersionNumber()
}

static func adapterVersion() -> VersionNumber {
  let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
    separatedBy: ".")
  var version = VersionNumber()
  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, suivez les instructions spécifiques au format d'annonce :