Metadaten der Anzeige

Plattform auswählen:Android iOS

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

Vorbereitung

Anzeigenmetadaten werden abgerufen

Damit eine App mehr über die ausgelieferten Anzeigen erfahren kann, muss die Anzeige als eigener GADAdMetadataDelegate festgelegt werden. Anschließend können Sie auf Änderungen an Anzeigenmetadaten warten, indem Sie die Methode adMetadataDidChange: für GADAdMetadataDelegate implementieren. Prüfen Sie nach dem Aufrufen dieses Delegates das Attribut adMetadata der Anzeige.

adMetadataDidChange: wird direkt nach dem Laden einer Anzeige oder wenn sich die Metadaten einer Anzeige asynchron nach dem Laden ändern, aufgerufen. Es kann nicht garantiert werden, dass Anzeigenmetadaten beim Laden verfügbar sind. Wir empfehlen daher, vor dem Zugriff auf die Metadaten einer Anzeige auf diesen Callback zu warten.

Hier ist 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 = [ 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 nach den gewünschten Schlüsseln durchsuchen. Verschiedene Anzeigentypen können unterschiedliche Schlüssel für Anzeigenmetadaten haben. VAST-Videoanzeigen haben die folgenden Schlüssel:

Schlüssel Typ Beschreibung
AdId String Die ID der Anzeige oder der leere String, wenn nicht verfügbar.
AdTitle String Der Titel, leer, wenn nicht angegeben.
CreativeDurationMs Ganzzahl Die Dauer des ausgewählten Creatives in Millisekunden, -1 bei nicht linearen Creatives.
TraffickingParameters String Trafficing-Parameter oder der leere String, falls nicht verfügbar.
DealId String Die erste Deal-ID in der Wrapper-Kette für die aktuelle Anzeige, beginnend oben, oder der leere String, wenn diese Informationen nicht verfügbar sind.
AdSystem String Der Quell-Ad-Server der Anzeige. Ist nicht verfügbar, ist das Feld leer.
CreativeId String Die ID des ausgewählten Creatives für die Anzeige. Ist nicht verfügbar, ist das Feld leer.
MediaURL String Die URL der ausgewählten Medien.
Wrappers Array Das Array wird mit Elementen ab der innersten Wrapper-Anzeige (in der Nähe der Inline-Anzeige) bis zur äußersten Wrapper-Anzeige gefüllt. Jedes Element im Array ist ein Dictionary mit den folgenden Schlüsseln und Werten.
AdId
String Anzeigen-ID, die für die Wrapper-Anzeige verwendet wird. Ist leer, wenn sie nicht verfügbar ist.
AdSystem
String Für die Wrapper-Anzeige verwendetes Anzeigensystem. Ist leer, wenn nicht verfügbar.
CreativeId
String Die Creative-ID, die für die Wrapper-Anzeige verwendet wird. Ist leer, wenn sie nicht verfügbar ist.