أداة فحص عرض الإعلانات ومعاينة المواد الإبداعية

يوضّح هذا الدليل كيفية تصحيح أخطاء عرض الإعلانات باستخدام المعاينة داخل التطبيق و"أداة فحص العرض".

تتيح لك ميزة المعاينة داخل التطبيق رؤية موادك الإبداعية معروضة داخل تطبيقك على الأجهزة الجوّالة. وتكون هذه المعاينة مفيدة بشكل خاص للناشرين الذين لديهم مواد إبداعية تتفاعل مع التطبيق أو تتضمّن سلوكًا فريدًا أو تعتمد على التطبيق في بعض عمليات العرض (بما في ذلك المواد الإبداعية الأصلية وMRAID).

تقدّم أداة فحص العرض معلومات عن الإعلانات التي تم عرضها. عند عرض إعلانات غير متوقّعة، استخدِم "أداة فحص العرض" لمعرفة السبب.

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

  • الإصدار 7.13.1 أو إصدار أحدث من Google Mobile Ads SDK
  • الوصول إلى حساب على "إدارة إعلانات Google"
  • أكمِل الخطوات في البدء

إعداد تطبيقك

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

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  let debugOptionsViewController = DebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  // TODO: Replace YOUR_AD_UNIT_ID with your own ad unit ID.
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

يكفي استخدام أي وحدة إعلانية صالحة من حسابك على "مدير إعلانات Google" لفتح قائمة خيارات تصحيح الأخطاء.

تلقّي إشعار عند إغلاق قائمة تصحيح الأخطاء

عند فتح قائمة خيارات تصحيح الأخطاء آليًا، يمكنك اختيار تنفيذ GADDebugOptionsViewControllerDelegate لتلقّي إشعار عند إغلاق وحدة التحكّم في العرض. لإجراء ذلك، يجب أن يتوافق صفك مع العنصر المفوض:

Swift

import GoogleMobileAds
 
class ViewController: UIViewController, GADDebugOptionsViewControllerDelegate {
}

Objective-C

@import GoogleMobileAds;
 
@interface ViewController : UIViewController <GADDebugOptionsViewControllerDelegate> {
}
 
@end

تعيين مفوَّض على جهاز GADDebugOptionsViewController:

Swift

@IBAction func openDebugOptions(sender: AnyObject) {
  let debugOptionsViewController = GADDebugOptionsViewController(adUnitID: "YOUR_AD_UNIT_ID")
  debugOptionsViewController.delegate = self
  self.present(debugOptionsViewController, animated: true, completion: nil)
}

Objective-C

- (IBAction)openDebugOptions:(id)sender {
  GADDebugOptionsViewController *debugOptionsViewController =
      [GADDebugOptionsViewController debugOptionsViewControllerWithAdUnitID:@"YOUR_AD_UNIT_ID"];
  debugOptionsViewController.delegate = self;
  [self presentViewController:debugOptionsViewController animated:YES completion:nil];
}

أخيرًا، نفِّذ مفوّضًا:

Swift

func debugOptionsViewControllerDidDismiss(controller: GADDebugOptionsViewController) {
  print("Debug options view controller dismissed.")
}

Objective-C 

- (void)debugOptionsViewControllerDidDismiss:(GADDebugOptionsViewController *)controller {
  NSLog(@"Debug options view controller dismissed.");
}

بعد إضافة إمكانية فتح قائمة خيارات تصحيح الأخطاء، شغِّل تطبيقك ونفِّذ الدالة أعلاه. تظهر القائمة التالية:

انقر على معاينة تصميم الإعلان لربط جهازك. يتم فتح متصفّح وينقلك تلقائيًا إلى متصفّح لتسجيل الدخول إلى "مدير إعلانات Google". بعد تسجيل الدخول بنجاح، أدخِل اسمًا لجهازك لتسجيله في حسابك على "مدير إعلانات Google"، ثم انقر على إثبات الملكية.

تم ربط جهازك بنجاح. في هذه المرحلة، يمكنك الاطّلاع على جهازك المرتبط في الواجهة الأمامية لخدمة "إدارة الإعلانات". يمكنك أيضًا السماح للمستخدمين الآخرين بالوصول إلى أجهزتك.

المعاينة داخل التطبيق

اتّبِع الخطوات التالية لإرسال تصميم إعلان إلى جهازك المرتبط. تأكَّد من أنّ تصميم الإعلان الذي تمّ دفعه هو جزء من تفاصيل إعلان نشطة تستهدف خانة الإعلان التي تريد عرض تصميم الإعلان فيها.

بعد إرسال تصميم إعلان من الواجهة الأمامية، فعِّل قائمة خيارات تصحيح الأخطاء على جهازك مرة أخرى، ثم انقر على معاينة تصميم الإعلان مرة أخرى. تتيح هذه الخطوة لحزمة SDK التحقّق من &quot;مدير إعلانات Google&quot; مرة أخرى للتأكّد من نجاح ربط الجهاز والحصول على بعض المعلومات حول التصميم الذي أرسلته. إذا نجح ربط الجهاز في السابق، سيتم إغلاق قائمة تصحيح الأخطاء على الفور. إذا لم تنجح عملية الربط، سيُطلب منك ربط حسابك مرة أخرى.

أخيرًا، حمِّل إعلانًا للفتحة التي تريد معاينتها للاطّلاع على تصميم إعلانك.

Delivery Inspector

اتّبِع خطوات بدء تحديد المشاكل في التطبيق وحلّها لتحديد المشاكل في تطبيقك وحلّها. وفي حال إكمال الخطوات بنجاح، سيظهر الطلب في الواجهة الأمامية من "مدير إعلانات Google"، ويمكنك الاطّلاع على مزيد من المعلومات عن الإعلان الذي تم عرضه.