أشكال الإعلانات المدمجة مع المحتوى المخصّصة لنوع العرض والقياس المفتوح

إذا كنت تخطّط لاستخدام القياس المفتوح مع أشكال الإعلانات المدمجة مع المحتوى المخصّصة التي لا تحتوي على مادة عرض فيديو، ستكون مسؤولاً عن طلب واجهات برمجة التطبيقات Open Measurement API بنفسك. يتوفر القياس المفتوح لأشكال الإعلانات المدمجة المخصّصة من نوع الشبكة الإعلانية فقط في الإصدار 7.43.0 والإصدارات الأحدث. إذا كنت تستخدم أشكال إعلانات مدمجة مع المحتوى مخصّصة مع مادة عرض فيديو، لن تحتاج إلى اتّباع هذا الدليل، لأنّ "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" تعمل على تتبُّع إمكانية عرض مادة عرض الفيديو نيابةً عنك.

المتطلبات الأساسية

تحميل إعلان

يكون تحميل الإعلان مماثلاً سواء كنت تستخدم القياس المفتوح أم لا. في هذه الحالة، سنستخدم دالة ViewController بسيطة لإثبات كيفية تحميل GADNativeCustomTemplateAd:

@interface OpenMeasurementNativeCustomTemplateAdViewController ()
    <GADNativeCustomTemplateAdLoaderDelegate> {
  IBOutlet UIView *_parentView;
  GADAdLoader *_adLoader;
  GADNativeCustomTemplateAd *_customTemplateAd;
  MySimpleNativeAdView *_simpleNativeAdView;
}

@end

@implementation OpenMeasurementNativeCustomTemplateAdViewController

- (void) viewDidLoad {
  [super viewDidLoad];

  _adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"your ad unit ID"
                                 rootViewController:self
                                            adTypes:@[ kGADAdLoaderAdTypeNativeCustomTemplate ]
                                            options:nil];
  _adLoader.delegate = self;
  [self loadAd];
}

- (void) loadAd {
  GAMRequest *request = [GAMRequest request];
  [_adLoader loadRequest:request];
}
...
@end

تسجيل طريقة العرض وبدء القياس

عند عرض GADNativeCustomTemplateAd، عليك تسجيل طريقة عرض إعلانك المخصّصة مع GADNativeTemplateAd باستخدام السمة displayAdMeasurement.view.

عليك أيضًا إعلام حزمة تطوير البرامج (SDK) صراحةً ببدء قياس إعلانك. لإجراء ذلك، عليك استدعاء الإجراء startWithError: على السمة displayAdMeasurement في GADNativeCustomTemplateAd. يجب استدعاء startWithError: من سلسلة التعليمات الرئيسية، ولن يكون للطلبات اللاحقة أي تأثير.

@implementation OpenMeasurementNativeCustomTemplateAdViewController
...
#pragma mark - GADNativeCustomTemplateAdLoaderDelegate

- (void) adLoader:(GADAdLoader *) adLoader
    didReceiveNativeCustomTemplateAd:(GADNativeCustomTemplateAd *)nativeCustomTemplateAd {
  NSLog(@"Received custom native ad: %@", nativeCustomTemplateAd);

  _customTemplateAd = nativeCustomTemplateAd;

  // Put the custom native ad on screen.
  _simpleNativeAdView =
    [[NSBundle mainBundle] loadNibNamed:@"SimpleCustomNativeAdView"
                                  owner:nil
                                options:nil]
    .firstObject;
  [_parentView addSubview:_simpleNativeAdView];
  [_simpleNativeAdView populateWithCustomNativeAd:_customTemplateAd];


  // Set the top-level native ad view on the GADNativeCustomTemplateAd so the
  // Google Mobile Ads SDK can track viewability for that view.
  _customTemplateAd.displayAdMeasurement.view = _simpleNativeAdView;
  // Begin measuring your impressions and clicks.
  NSError *error = nil;
  [_customTemplateAd.displayAdMeasurement startWithError:&error];

  if (error) {
    NSLog(@"Failed to start the display measurement.");
  }
}
...
@end

هذا كل ما في الأمر. بعد إصدار تطبيقك، ستبدأ في تلقّي بيانات القياس، ومع ذلك لن يتم اعتماد بياناتك إلى أن تخضع لعملية اعتماد مكتب الإعلانات التفاعلية (IAB).