Metadane reklamy

Wybierz platformę: Android Nowy Android iOS

Ten przewodnik jest przeznaczony dla wydawców, którzy integrują metadane reklam z Google Mobile Ads SDK na iOS.

Wymagania wstępne

Pobieranie metadanych reklam

Aby aplikacja mogła dowiedzieć się więcej o wyświetlanych reklamach, ustaw ją jako własną GADAdMetadataDelegate. Następnie możesz monitorować zmiany metadanych reklam, implementując metodę adMetadataDidChange: w GADAdMetadataDelegate. Gdy to delegowanie zostanie wywołane, sprawdź właściwość adMetadata w reklamie.

Metoda adMetadataDidChange: jest wywoływana zaraz po wczytaniu reklamy lub gdy metadane reklamy zmienią się asynchronicznie po jej wczytaniu. Nie ma gwarancji, że metadane reklamy będą dostępne w momencie wczytania, dlatego zalecamy poczekanie na to wywołanie zwrotne przed uzyskaniem dostępu do metadanych reklamy.

Oto przykładowy kod pokazujący, jak pobrać metadane reklamy z nagrodą:

@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"];
}

Po pobraniu metadanych możesz sprawdzić pakiet pod kątem kluczy, które Cię interesują. Różne typy reklam mogą mieć powiązane z nimi różne klucze metadanych reklam. Reklamy wideo VAST mają te klucze:

Klucz Typ Opis
AdId Ciąg znaków Identyfikator reklamy lub pusty ciąg znaków, jeśli nie jest dostępny.
AdTitle Ciąg znaków Tytuł, pusty, jeśli nie został określony.
CreativeDurationMs Liczba całkowita Czas trwania wybranej kreacji w milisekundach, -1 jeśli kreacja jest nielinearna.
TraffickingParameters Ciąg znaków Parametry wyświetlania reklam lub pusty ciąg znaków, jeśli nie są dostępne.
DealId Ciąg znaków Pierwszy identyfikator umowy w łańcuchu otoki bieżącej reklamy, zaczynając od góry, lub pusty ciąg znaków, jeśli te informacje nie są dostępne.
AdSystem Ciąg znaków Źródłowy serwer reklam, pusty, jeśli nie jest dostępny.
CreativeId Ciąg znaków Identyfikator wybranej kreacji reklamy, pusty, jeśli nie jest dostępny.
MediaURL Ciąg znaków Adres URL wybranych multimediów.
Wrappers Tablica Tablica jest wypełniana elementami zaczynającymi się od najbardziej wewnętrznej reklamy otoki (blisko reklamy wbudowanej) i przechodzącymi na zewnątrz do najbardziej zewnętrznej reklamy otoki. Każdy element w tablicy jest słownikiem zawierającym te klucze i wartości.
AdId
Ciąg znaków. Identyfikator reklamy używany w przypadku reklamy otoki, pusty, jeśli nie jest dostępny.
AdSystem
Ciąg znaków. System reklamowy używany w przypadku reklamy otoki, pusty, jeśli nie jest dostępny.
CreativeId
Ciąg znaków. Identyfikator kreacji używany w przypadku reklamy otoki, pusty, jeśli nie jest dostępny.