Anzeigenmetadaten

Plattform auswählen: Android Neu Android iOS

Diese Anleitung richtet sich an Publisher, die Anzeigenmetadaten in das Google Mobile Ads SDK für iOS einbinden.

Vorbereitung

Anzeigenmetadaten abrufen

Wenn eine App mehr über die ausgelieferten Anzeigen erfahren soll, legen Sie die Anzeige als eigenen GADAdMetadataDelegate fest. Anschließend können Sie auf Änderungen der Anzeigenmetadaten warten, indem Sie die Methode adMetadataDidChange: in GADAdMetadataDelegate implementieren. Sobald dieser Delegat aufgerufen wird, prüfen Sie das Attribut adMetadata in der Anzeige.

adMetadataDidChange: wird direkt nach dem Laden einer Anzeige oder nach einer asynchronen Änderung der Metadaten einer Anzeige nach dem Laden aufgerufen. Es ist nicht garantiert, dass Anzeigenmetadaten zur Ladezeit verfügbar sind. Wir empfehlen daher, auf diesen Callback zu warten, bevor Sie auf die Metadaten einer Anzeige zugreifen.

Hier ein Codebeispiel, das zeigt, wie Sie die Anzeigenmetadaten für eine Anzeige mit Prämie abrufen:

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [GAMRequest request];
  [GADRewardedAd
       loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        self.rewardedAd.fullScreenContentDelegate = self;

        /// Set the ad to be the delegate of its ad metadata.
        self.rewardedAd.adMetadataDelegate = self;

        NSLog(@"Rewarded ad loaded.");
      }];
}

/#pragma mark GADAdMetadataDelegate implementation

- (void)adMetadataDidChange:(id<GADAdMetadataProvider>)ad {
  NSDictionary<NSString*, id> *adMetadata = _rewardedAd.adMetadata;
  NSString *adId = adMetadata[@"AdId"];
}

Nachdem Sie die Metadaten abgerufen haben, können Sie im Bundle nach den gewünschten Schlüsseln suchen. Verschiedene Anzeigentypen können unterschiedliche Anzeigenmetadatenschlüssel haben. VAST-Videoanzeigen haben die folgenden Schlüssel:

Schlüssel Typ Beschreibung
AdId String Die ID der Anzeige oder ein leerer String, falls nicht verfügbar.
AdTitle String Der Titel oder leer, falls nicht angegeben.
CreativeDurationMs Ganzzahl Die Dauer des ausgewählten Creatives in Millisekunden oder -1, falls nicht linear.
TraffickingParameters String Trafficking-Parameter oder ein leerer String, falls nicht verfügbar.
DealId String Die erste Deal-ID in der Wrapper-Kette für die aktuelle Anzeige, beginnend oben, oder ein leerer String, falls diese Informationen nicht verfügbar sind.
AdSystem String Der Ad-Server der Quelle der Anzeige oder leer, falls nicht verfügbar.
CreativeId String Die ID des ausgewählten Creatives für die Anzeige oder leer, falls nicht verfügbar.
MediaURL String Die URL der ausgewählten Medien.
Wrappers Array Das Array wird mit Elementen gefüllt, beginnend mit der innersten Wrapper-Anzeige (in der Nähe der Inline-Anzeige) bis zur äußersten Wrapper-Anzeige. Jedes Element im Array ist ein Dictionary, das die folgenden Schlüssel und Werte enthält.
AdId
String. Anzeigen-ID, die für die Wrapper-Anzeige verwendet wird, oder leer, falls nicht verfügbar.
AdSystem
String. Ad-System, das für die Wrapper-Anzeige verwendet wird, oder leer, falls nicht verfügbar.
CreativeId
String. Creative-ID, die für die Wrapper-Anzeige verwendet wird, oder leer, falls nicht verfügbar.