تحميل إعلان مدمج مع المحتوى

اختيار النظام الأساسي: Android iOS Flutter Unity Android (الإصدار القديم)

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

عند تحميل إعلان مدمج مع المحتوى، يتلقّى تطبيقك عنصر إعلان يحتوي على مواد العرض، ويكون التطبيق، وليس Google Mobile Ads SDK، مسؤولاً بعد ذلك عن عرضها.

بشكل عام، يتضمّن عرض "الإعلانات المدمجة مع المحتوى" بنجاح جزأَين: تحميل إعلان باستخدام حزمة تطوير البرامج (SDK)، ثم عرض محتوى الإعلان في تطبيقك.

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

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

قبل المتابعة، عليك إعداد Google Mobile Ads SDK.

الاختبار دائمًا باستخدام الإعلانات الاختبارية

عند إنشاء تطبيقاتك واختبارها، تأكَّد من استخدام الإعلانات الاختبارية بدلاً من الإعلانات النهائية المعروضة للمستخدمين.

أسهل طريقة لتحميل الإعلانات الاختبارية هي استخدام رقم تعريف الوحدة الإعلانية الاختبارية المخصّص للإعلانات المدمجة مع المحتوى على iOS:

ca-app-pub-3940256099942544/3986624511

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

للاطّلاع على تفاصيل الإعلانات الاختبارية Google Mobile Ads SDK، يُرجى مراجعة مقالة تفعيل الإعلانات الاختبارية.

تحميل الإعلانات

يتم تحميل "الإعلانات المدمجة مع المحتوى" باستخدام فئة GADAdLoader التي ترسل رسائل إلى مفوّضيها وفقًا لبروتوكول GADAdLoaderDelegate.

إعداد أداة تحميل الإعلانات

قبل أن تتمكّن من تحميل إعلان، عليك إعداد أداة تحميل الإعلانات. يوضّح الرمز البرمجي التالي كيفية إعداد GADAdLoader:

Swift

adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  // To receive native ads, the ad loader's delegate must
  // conform to the NativeAdLoaderDelegate protocol.
  adTypes: [.native],
  // Use nil for default options.
  options: nil)
// Set the delegate before making an ad request.
adLoader.delegate = self

استبدِل nativeAdUnitID برقم تعريف الوحدة الإعلانية.

Objective-C

self.adLoader =
    [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                       // The UIViewController parameter is optional.
                       rootViewController:self
                                  // To receive native ads, the ad loader's delegate must
                                  // conform to the NativeAdLoaderDelegate protocol.
                                  adTypes:@[ GADAdLoaderAdTypeNative ]
                                  // Use nil for default options.
                                  options:nil];
// Set the delegate before making an ad request.
self.adLoader.delegate = self;

استبدِل kNativeAdUnitID برقم تعريف الوحدة الإعلانية.

ستحتاج إلى رقم تعريف وحدة إعلانية (يمكنك استخدام رقم تعريف الاختبار)، وثوابت لتمريرها في مصفوفة adTypes لتحديد أشكال الإعلانات المدمجة مع المحتوى التي تريد طلبها، وأي خيارات تريد ضبطها في المَعلمة options. يمكنك الاطّلاع على قائمة بالقيم المحتمَلة للمَعلمة options في صفحة ضبط خيارات "الإعلانات المدمجة مع المحتوى".

يجب أن تحتوي مصفوفة adTypes على هذا الثابت :

تنفيذ مفوّض أداة تحميل الإعلانات

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

Swift

func adLoader(_ adLoader: AdLoader, didReceive nativeAd: NativeAd) {
  // Set the delegate to receive notifications for interactions with the native ad.
  nativeAd.delegate = self

  // TODO: Display the native ad.
}

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {
  // Set the delegate to receive notifications for interactions with the native ad.
  nativeAd.delegate = self;

  // TODO: Display the native ad.
}

طلب إدراج الإعلانات

بعد إعداد GADAdLoader، استخدِم طريقة loadRequest: لطلب إعلان:

Swift

adLoader.load(Request())

Objective-C

[self.adLoader loadRequest:[GADRequest request]];

تقبل loadRequest: طريقة GADAdLoader عناصر GADRequest نفسها التي تقبلها إعلانات البانر والإعلانات البينية. يمكنك استخدام عناصر الطلب لإضافة معلومات الاستهداف، تمامًا كما تفعل مع أنواع الإعلانات الأخرى.

تحميل إعلانات متعددة (اختياري)

لتحميل إعلانات متعددة في طلب واحد، اضبط الـ GADMultipleAdsAdLoaderOptions عند إعداد GADAdLoader.

Swift

let multipleAdOptions = MultipleAdsAdLoaderOptions()
multipleAdOptions.numberOfAds = 5
adLoader = AdLoader(
  adUnitID: "nativeAdUnitID",
  // The UIViewController parameter is optional.
  rootViewController: self,
  adTypes: [.native],
  options: [multipleAdOptions])

Objective-C

GADMultipleAdsAdLoaderOptions *multipleAdOptions = [[GADMultipleAdsAdLoaderOptions alloc] init];
multipleAdOptions.numberOfAds = 5;

self.adLoader = [[GADAdLoader alloc] initWithAdUnitID:"kNativeAdUnitID"
                                   // The UIViewController parameter is optional.
                                   rootViewController:self
                                              adTypes:@[ GADAdLoaderAdTypeNative ]
                                              options:@[ multipleAdOptions ]];

يبلغ الحد الأقصى لعدد الإعلانات لكل طلب عرض إعلان خمسة إعلانات، وليس من المضمون أن تعرض حزمة تطوير البرامج (SDK) العدد المطلوب من الإعلانات بالضبط.

ستكون جميع إعلانات Google المعروضة مختلفة عن بعضها البعض، على الرغم من أنّه ليس من المضمون أن تكون الإعلانات من المستودع المحجوز أو من المشترين الخارجيين فريدة.

لا تستخدِم فئة GADMultipleAdsAdLoaderOptions إذا كنت تستخدِم التوسّط، لأنّ طلبات عرض إعلانات مدمجة مع المحتوى متعددة لا تعمل مع أرقام تعريف الوحدات الإعلانية التي تم إعدادها للتوسّط.

تحديد وقت انتهاء التحميل

بعد أن يستخدِم التطبيق طريقة loadRequest:، يمكنه الحصول على نتائج الطلب باستخدام استدعاءات:

سيؤدي طلب إعلان واحد إلى استدعاء إحدى هاتَين الطريقتَين مرة واحدة.

سيؤدي طلب عرض إعلان واحد أو أكثر إلى استدعاء إحدى الطريقتَين أعلاه مرة واحدة على الأقل، ولكن ليس أكثر من الحد الأقصى لعدد الإعلانات المطلوبة.

بالإضافة إلى ذلك، يقدّم GADAdLoaderDelegate معاودة الاتصال adLoaderDidFinishLoading. تشير طريقة المفوّض هذه إلى أنّ أداة تحميل الإعلانات قد انتهت من تحميل الإعلانات ولن يتم الإبلاغ عن أي إعلانات أو أخطاء أخرى للطلب. في ما يلي مثال على كيفية استخدامها عند تحميل عدة "إعلانات مدمجة مع المحتوى" في آنٍ واحد:

Swift

func adLoaderDidFinishLoading(_ adLoader: AdLoader) {
  // The adLoader has finished loading ads.
}

Objective-C

- (void)adLoaderDidFinishLoading:(GADAdLoader *)adLoader {
  // The adLoader has finished loading ads.
}

التعامل مع الطلبات التي تعذّر تنفيذها

توسّع البروتوكولات بروتوكول GADAdLoaderDelegate الذي يحدّد رسالة يتم إرسالها عندما يتعذّر تحميل الإعلانات.

Swift

func adLoader(_ adLoader: AdLoader, didFailToReceiveAdWithError error: any Error) {
  // The adLoader failed to receive an ad.
}

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didFailToReceiveAdWithError:(NSError *)error {
  // The adLoader failed to receive an ad.
}

تلقّي إشعارات بشأن أحداث "الإعلانات المدمجة مع المحتوى"

لتلقّي إشعارات بشأن الأحداث المتعلقة بتفاعلات "الإعلانات المدمجة مع المحتوى"، اضبط السمة delegate للإعلان المدمج مع المحتوى:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

بعد ذلك، نفِّذ GADNativeAdDelegate لتلقّي استدعاءات المفوّض التالية:

Swift

func nativeAdDidRecordImpression(_ nativeAd: NativeAd) {
  // The native ad was shown.
}

func nativeAdDidRecordClick(_ nativeAd: NativeAd) {
  // The native ad was clicked on.
}

func nativeAdWillPresentScreen(_ nativeAd: NativeAd) {
  // The native ad will present a full screen view.
}

func nativeAdWillDismissScreen(_ nativeAd: NativeAd) {
  // The native ad will dismiss a full screen view.
}

func nativeAdDidDismissScreen(_ nativeAd: NativeAd) {
  // The native ad did dismiss a full screen view.
}

func nativeAdWillLeaveApplication(_ nativeAd: NativeAd) {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

Objective-C

- (void)nativeAdDidRecordImpression:(GADNativeAd *)nativeAd {
  // The native ad was shown.
}

- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  // The native ad was clicked on.
}

- (void)nativeAdWillPresentScreen:(GADNativeAd *)nativeAd {
  // The native ad will present a full screen view.
}

- (void)nativeAdWillDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad will dismiss a full screen view.
}

- (void)nativeAdDidDismissScreen:(GADNativeAd *)nativeAd {
  // The native ad did dismiss a full screen view.
}

- (void)nativeAdWillLeaveApplication:(GADNativeAd *)nativeAd {
  // The native ad will cause the app to become inactive and
  // open a new app.
}

أفضل الممارسات

اتّبِع هذه القواعد عند تحميل الإعلانات.

  • يجب أن تُخزّن التطبيقات التي تستخدِم "الإعلانات المدمجة مع المحتوى" في قائمة، قائمة الإعلانات مؤقتًا.

  • عند التخزين المؤقت للإعلانات، امحُ ذاكرة التخزين المؤقت وأعِد التحميل بعد ساعة واحدة.

  • لا تستخدِم loadRequest: مرة أخرى على GADAdLoader إلى أن ينتهي تحميل الطلب السابق ، كما هو موضّح في adLoaderDidFinishLoading:.

  • اقتصر على تخزين "الإعلانات المدمجة مع المحتوى" مؤقتًا على ما هو مطلوب فقط. على سبيل المثال، عند التخزين المؤقت، لا تُخزِّن مؤقتًا إلا الإعلانات التي تظهر على الشاشة على الفور. تستهلك "الإعلانات المدمجة مع المحتوى" مساحة كبيرة من الذاكرة، ويؤدي تخزينها مؤقتًا بدون إزالتها إلى استخدام مفرط للذاكرة.

  • أزِل "الإعلانات المدمجة مع المحتوى" عندما لا تعود قيد الاستخدام.

عرض إعلانك

بعد تحميل إعلان، ما عليك سوى عرضه للمستخدمين. انتقِل إلى دليل "الإعلانات المدمجة مع المحتوى (متقدم) guide" لمعرفة كيفية ذلك.