Metadaten der Anzeige

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

Voraussetzungen

Anzeigenmetadaten werden abgerufen

Damit eine App mehr über die ausgelieferten Anzeigen weiß, legen Sie die Anzeige als eigene GADAdMetadataDelegate fest. Anschließend können Sie die Methode adMetadataDidChange: für GADAdMetadataDelegate implementieren, um auf Änderungen der Anzeigenmetadaten zu warten. Prüfen Sie nach dem Aufrufen dieses Delegaten die Eigenschaft adMetadata der Anzeige.

adMetadataDidChange: wird unmittelbar nach dem Laden einer Anzeige aufgerufen oder wenn sich die Metadaten der Anzeige nach dem Laden asynchron ändern. Es kann nicht garantiert werden, dass die Metadaten der Anzeige zum Zeitpunkt der Ladezeit verfügbar sind. Wir empfehlen daher, auf diesen Callback zu warten, bevor Sie auf die Metadaten einer Anzeige zugreifen.

Das folgende Codebeispiel zeigt, wie die Metadaten einer Anzeige mit Prämie abgerufen werden:

@interface ViewController () <GADFullScreenContentDelegate, GADAdMetadataDelegate>

@end

@implementation ViewController
- (void)loadRewardedAd {
   *request = [ 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 das Bundle auf die Schlüssel prüfen, die Ihnen wichtig sind. Unterschiedliche Arten von Anzeigen können unterschiedliche Metadatenschlüssel haben. VAST-Videoanzeigen haben folgende Schlüssel:

Schlüssel Typ Beschreibung
AdId String Die ID der Anzeige oder der leere String, falls nicht verfügbar.
AdTitle String Der Titel, leer, falls nicht angegeben.
CreativeDurationMs Ganzzahl Die ausgewählte Creative-Dauer in Millisekunden (-1 wenn nicht linear)
TraffickingParameters String Trafficking-Parameter oder den leeren String, falls nicht verfügbar.
DealId String Die erste Deal-ID, die in der Wrapper-Kette für die aktuelle Anzeige vorhanden ist, beginnend am Anfang, oder der leere String, falls diese Informationen nicht verfügbar sind.
AdSystem String Der Quell-Ad-Server der Anzeige; leer, falls nicht verfügbar.
CreativeId String Die ID des ausgewählten Creatives für die Anzeige; leer, falls nicht verfügbar.
MediaURL String Die URL der ausgewählten Medien.
Wrappers Array Das Array wird mit Elementen gefüllt, die von der innersten Wrapper-Anzeige (nahe der Inline-Anzeige) beginnen und dann zur äußersten Wrapper-Anzeige führen. Jedes Element im Array ist ein Wörterbuch, das die folgenden Schlüssel und Werte enthält.
AdId
String: Für die Wrapper-Anzeige verwendete Anzeigen-ID. Ist leer, falls nicht verfügbar.
AdSystem
String: Für die Wrapper-Anzeige verwendetes Anzeigensystem; leer, falls nicht verfügbar.
CreativeId
String: Für die Wrapper-Anzeige verwendete Creative-ID. Ist leer, falls nicht verfügbar.