Pakiet SDK do reklam mobilnych Google obsługuje też niestandardowe style reklam w wyszukiwarce. Jeśli Twoja aplikacja korzysta już z pakietu SDK do reklam mobilnych Google, zalecamy użycie pakietu SDK do reklam mobilnych Google w jego wersji.
Wymagania wstępne
- Użyj Xcode 8.0 lub nowszego
- Kieruj na iOS 8.0 lub nowszy
- Prawidłowy kod usługi internetowej wydawcy (np. vert-ppa-test1-srp)
- CocoaPods
Zaimportuj natywny pakiet SDK AdSense dla wyszukiwania
CocoaPods
Zaimportuj pakiet Google-AFSNative do projektu iOS za pomocą CocoaPods. Otwórz plik Podfile projektu i dodaj ten wiersz do miejsca docelowego aplikacji:
pod 'Google-AFSNative'
Następnie uruchom wiersz poleceń:
pod install --repo-update
Jeśli nie masz doświadczenia z CocoaPods, zapoznaj się z ich oficjalną dokumentacją, aby dowiedzieć się, jak tworzyć i korzystać z podplików.
Opis
Jeśli przechodzisz z 2.0.8 lub starszej wersji na wersję 4.0 lub nowszą, przeczytaj nasz przewodnik po migracji.
Ten dokument opisuje proces integracji reklam natywnych AdSense dla wyszukiwania z aplikacją mobilną na iOS.
- W konstruktorze
GANSearchAdController
należy podać kod usługi internetowej wydawcy, identyfikator ustawień i powiązany obiektGANSearchAdControllerOptions
. - Każde wywołanie
loadAds()
wskazuje nowe wyszukiwanie i spowoduje odrzucenie i unieważnienie bieżącego zestawu reklam. - Kreacje reklamowe są przechowywane w usłudze
GANAdView
. - Reklamy są wstawiane do reklamy
GANAdView
za pomocą metodypopulateAdView
. Oprócz uzupełnionego elementuGANAdView
element wywołujący udostępnia parametradIdentifier
– dowolny ciąg znaków, który powinien jednoznacznie identyfikować reklamę. W interfejsie API do każdego przekazywanego identyfikatora adIdentifier przypisana jest konkretna reklama. Dzięki temu po każdym przesłaniu tego klucza adKey w przyszłości zostanie zwrócona ta sama reklama. Jeśli na przykład elementpopulateAdView
zostanie wywołany po raz pierwszy z identyfikatorem adIdentifier „keyA”, każde kolejne wywołanie funkcjipopulateAdView
z przekazaniem „keyA” jakoadIdentifier
spowoduje wyświetlenie tej samej reklamy.
- Jest to element UIView zawierający tę kreację.
- Wypełnij ten widok reklamą za pomocą metody
populateAdView
w:GANSearchAdController
.
- Przekaż ten obiekt do konstruktora
GANSearchAdController
, by określić sposób żądania i wyświetlania reklam.
- Wywołaj metodę
loadAds
w instancjiGANSearchAdController
za pomocą tego obiektu, aby wysłać żądanie reklamy.
- Zaimplementuj ten interfejs i udostępnij go
GANSearchAdController
, aby zarejestrować wywołania zwrotne dla kilku stanów.
Przykładowa implementacja
Przykład poniżej pokazuje, jak utworzyć GANSearchAdController
i GANView
, by wyświetlić reklamę w przykładowym ViewController
.
// SampleAppViewController.m implementation
#import <AFSNative/AFSNative.h>
@interface GBannerViewController () {
// The Ad Controller used by the sample application.
GANSearchAdController *_adController;
// The Ad View to display the loaded ad.
GANAdView *_adView;
}
// scrollView will be where we place our ads in this example.
@property(nonatomic, strong) UIScrollView *scrollView;
@end
...
- (void)viewDidLoad {
[super viewDidLoad];
// Create the scroll view.
...
[self.view addSubview:scrollView];
// Create a test button and link the ad request to its action.
UIButton *loadBannerButton = [UIButton buttonWithType:UIButtonTypeCustom];
...
[loadBannerButton addTarget:self
action:@selector(loadAd:)
forControlEvents:UIControlEventTouchUpInside];
[self.scrollView addSubview:loadBannerButton];
// Construct the Ad Controller.
GANSearchAdControllerOptions *options = [[GANSearchAdControllerOptions alloc] init];
options.prefetchEnabled = YES;
options.adType = GANSearchAdTypeSPA;
options.adFetchCount = 3;
_adController = [[GANSearchAdController alloc]
initWithPublisherID: @"your-client-id"
styleID: @"your-settings-id"
options: options
delegate: self];
_adView = [_adController adView];
[self.scrollView addSubview:_adView];
}
// Request ads when the test button is pressed.
- (void)loadAd:(id)sender {
// Construct the Ad Request.
GANSearchAdRequest *adRequest = [[GANSearchAdRequest alloc] init];
adRequest.query = @"some-query";
// Start loading ads. Note that the loading is asynchronous.
[_adController loadAds: adRequest];
}
// Insert ads into GANAdView if the request returns successfully.
- (void)searchAdController:(GANSearchAdController *)adController
didLoadAds:(NSInteger)numberOfAds {
if (numberOfAds <= 0) {
NSLog(@"No ads found on the server");
} else {
[_adController populateAdView:_adView identifier:@"demoAd"];
}
}
...