iOS için AFS Yerel Uygulaması

Google Mobile Ads SDK'sı da özel arama stillerini destekler. Uygulamanız Google Mobile Ads SDK'sını zaten kullanıyorsa AFSMA SDK sürümü .

Ön koşullar

  • Xcode 8.0 veya sonraki bir sürümü kullanın
  • iOS 8.0 veya sonraki sürümleri hedefleme
  • Geçerli bir yayıncı web mülkü kodu (ör. vert-ppa-test1-srp)
  • CocoaPods

AFS Yerel SDK'sını içe aktarın

CocoaPods

Şunu kullanarak bir iOS projesine Google-AFSNative SDK'sı aktarın: CocoaPods'da bulabilirsiniz. Projenizin Podfile'a gidin ve bu satırı uygulamanızın hedefine ekleyin:

pod 'Google-AFSNative'

Ardından komut satırında şu komutu çalıştırın:

pod install --repo-update

CocoaPods'u kullanmaya yeni başladıysanız kullanıcıların bilgi için resmi dokümanlar konulu videomuzu izleyin.

Genel Bakış

2.0.8 veya daha eski bir sürümden 4.0 ya da daha yeni bir sürüme geçiyorsanız lütfen taşıma rehberimize göz atın.

Bu belgede, AFS Doğal reklamlarını entegre etme süreci özetlenmektedir iOS mobil uygulamanızda.

GANSearchAdController

  • GANSearchAdController oluşturucusuna yayıncının web mülkü kodu, istenen ayar kimliği ve ilişkili GANSearchAdControllerOptions nesne algılandı.
  • loadAds() için yapılan her çağrı, yeni bir aramayı gösterir ve mevcut silinecek ve geçersiz kılınacak reklam grubu.
  • Reklam öğeleri GANAdView konumunda depolanır.
  • Reklamlar, GANAdView reklamına populateAdView yöntemi ile eklenir. İçinde doldurulacak GANAdView öğesine ek olarak, arayan bir adIdentifier. Bu, reklamı benzersiz şekilde tanımlaması gereken rastgele bir dizedir. API'nin içinde, iletilen her adIdentifier'a belirli bir reklam atanır. inç Daha sonra, bu adKey gelecekte tekrar iletildiğinde, aynı reklam geri döndü. Örneğin, populateAdView ilk kez adIdentifier "keyA", iletilirken populateAdView öğesine yapılan her bir çağrı "anahtarA" çünkü adIdentifier aynı reklamın gösterilmesine neden olur.

GANAdView

  • Bu, reklam öğesini içeren UIView'dur.
  • Bu görünümü, populateAdView yöntemini kullanarak bir reklamla doldurun GANSearchAdController.

GANSearchAdControllerOptions

  • GANSearchAdController ve görüntülenme biçimleri arasındaki farkları ifade eder.

GANSearchAdRequest

  • Bu komutla GANSearchAdController örneğinde loadAds yöntemini çağırın nesnesini ifade eder.

GANSearchAdControllerDelegate

  • Bu arayüzü uygulayın ve aşağıdaki işlemleri yapması için GANSearchAdController adlı kullanıcıya sağlayın çeşitli eyaletler için geri çağırmalar yapın.

Örnek uygulama

Aşağıdaki örnekte, örnek bir ViewController içinde reklam göstermek için GANSearchAdController ve GANView oluşturma gösterilmektedir.

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