Metadane reklamy

Ten przewodnik jest przeznaczony dla wydawców integrujących metadane reklam z pakietem SDK do reklam mobilnych Google na iOS.

Wymagania wstępne

Pobieranie metadanych reklamy

Jeśli chcesz, aby aplikacja dowiedziała się więcej o wyświetlanych reklamach, ustaw tę reklamę jako własną GADAdMetadataDelegate. Następnie możesz nasłuchiwać zmian metadanych reklamy, implementując metodę adMetadataDidChange: w GADAdMetadataDelegate. Po wywołaniu tego przedstawiciela sprawdź właściwość adMetadata w reklamie.

Parametr adMetadataDidChange: jest wywoływany tuż po wczytaniu reklamy lub gdy jej metadane zmienią się asynchronicznie po wczytaniu reklamy. Nie gwarantujemy, że metadane reklam będą dostępne podczas wczytywania, więc najlepiej poczekać na to wywołanie zwrotne przed uzyskaniem dostępu do metadanych reklamy.

Oto przykład kodu pokazujący, jak pobrać metadane reklamy z nagrodą:

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

Po pobraniu metadanych możesz sprawdzić pakiet pod kątem kluczy, które są dla Ciebie ważne. Z różnymi typami reklam mogą być powiązane różne klucze metadanych reklamy. Reklamy wideo VAST mają te klucze:

Klucz Typ Opis
AdId Ciąg znaków Identyfikator reklamy lub pusty ciąg, jeśli jest niedostępny.
AdTitle Ciąg znaków Tytuł jest pusty, jeśli nie podano innego tytułu.
CreativeDurationMs Liczba całkowita Wybrany czas trwania kreacji w milisekundach, -1 w przypadku kreacji nielinearnych.
TraffickingParameters Ciąg znaków Parametry trafikowania lub pusty ciąg, jeśli jest niedostępny.
DealId Ciąg znaków Pierwszy identyfikator umowy obecny w łańcuchu kodu bieżącej reklamy, zaczynający się od góry, lub pusty ciąg, jeśli ta informacja jest niedostępna.
AdSystem Ciąg znaków Źródłowy serwer reklam danej reklamy jest pusty, jeśli jest niedostępny.
CreativeId Ciąg znaków Identyfikator wybranej kreacji na potrzeby reklamy. Jeśli pole jest niedostępne, identyfikator wybranej kreacji jest pusty.
MediaURL Ciąg znaków Adres URL wybranych multimediów.
Wrappers Tablica Tablica jest wypełniana elementami, których początek znajduje się w reklamie z kodem towarzyszącym najbardziej wewnętrznym (blisko reklamy wbudowanej), i porusza się na zewnątrz do najbardziej zewnętrznej reklamy z kodem. Każdy element w tablicy jest słownikiem, który zawiera następujące klucze i wartości.
AdId
Ciąg znaków. Identyfikator reklamy używany na potrzeby reklamy z kodem. Jeśli identyfikator reklamy jest niedostępny, pusty.
AdSystem
Ciąg znaków. System reklam używany na potrzeby reklamy towarzyszącej. Pole jest puste, jeśli jest niedostępne.
CreativeId
Ciąg znaków. Identyfikator kreacji używany na potrzeby reklamy towarzyszącej. Pole jest puste, jeśli jest niedostępne.