Metadane reklamy

Wybierz platformę: Android iOS

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

Wymagania wstępne

Pobieranie metadanych reklamy

Aby aplikacja miała więcej informacji o wyświetlanych reklamach, ustaw ją jako własną GADAdMetadataDelegate. Następnie możesz nasłuchiwać zmian metadanych reklamy, implementując metodę adMetadataDidChange: w obiekcie GADAdMetadataDelegate. Gdy wywołana zostanie ta funkcja delegowana, sprawdź właściwość adMetadata w reklamie.

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

Oto przykładowy kod, który pokazuje, 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 interesujących Cię kluczy. Różne typy reklam mogą mieć powiązane z nimi 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 znaków, jeśli nie jest dostępny.
AdTitle Ciąg znaków Tytuł, który jest pusty, jeśli nie został podany.
CreativeDurationMs Liczba całkowita Czas trwania wybranej kreacji w milisekundach, -1 jeśli jest nielinearna.
TraffickingParameters Ciąg znaków Parametry kierowania reklam lub pusty ciąg znaków, jeśli nie są dostępne.
DealId Ciąg znaków Pierwszy identyfikator umowy w łańcuchu opakowania bieżącej reklamy, zaczynając od góry, lub pusty ciąg znaków, jeśli te informacje są niedostępne.
AdSystem Ciąg znaków Serwer reklam źródłowych reklamy. Jeśli nie jest dostępny, pole jest puste.
CreativeId Ciąg znaków Identyfikator wybranej kreacji reklamy. Jeśli nie jest dostępny, pole jest puste.
MediaURL Ciąg znaków Adres URL wybranego pliku multimedialnego.
Wrappers Tablica Tablica jest wypełniana elementami, zaczynając od najbardziej wewnętrznej reklamy z kodem VAST (blisko reklamy wstawionej) i przechodząc na zewnątrz do najbardziej zewnętrznej reklamy z kodem VAST. Każdy element w tablicy to słownik zawierający te klucze i wartości:
AdId
Ciąg znaków Identyfikator reklamy używany w reklamie opakowującej. Jeśli nie jest dostępny, pole jest puste.
AdSystem
Ciąg znaków System reklamowy używany w przypadku reklamy opakowującej. Jeśli nie jest dostępny, pole jest puste.
CreativeId
Ciąg znaków Identyfikator kreacji użytej w reklamie z kodem towarzyszącym. Jeśli nie jest dostępny, pole jest puste.
.