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

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

عند تحميل أحد الإعلانات المدمَجة مع المحتوى، يتلقّى تطبيقك عنصر إعلان يحتوي على مواد العرض الخاصة به، ويكون التطبيق عندئذٍ مسؤولاً عن عرضه، وليس حزمة "SDK لإعلانات Google على الأجهزة الجوّالة".

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

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

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

• أكمل دليل البدء.

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

عند إنشاء تطبيقاتك واختبارها، احرص على استخدام إعلانات تجريبية وليس إعلانات مباشرة.

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

/6499/example/native

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

لمزيد من المعلومات عن آلية عمل الإعلانات الاختبارية في "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة"، اطّلِع على الإعلانات التجريبية.

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

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

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

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

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

Swift

adLoader = GADAdLoader(adUnitID: "/6499/example/native",
    rootViewController: self,
    adTypes: [ .native ],
    options: [ ... ad loader options objects ... ])
adLoader.delegate = self

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/6499/example/native"
    rootViewController:rootViewController
               adTypes:@[ GADAdLoaderAdTypeNative ]
               options:@[ ... ad loader options objects ... ]];
self.adLoader.delegate = self;

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

يجب أن تحتوي الصفيفة adTypes على واحد أو أكثر من الثوابت التالية :

• GADAdLoaderAdTypeNative

• GADAdLoaderAdTypeCustomNative

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

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

Swift

public func adLoader(_ adLoader: GADAdLoader,
            didReceive nativeAd: GADNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd *)nativeAd;

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

Swift

func adLoader(_ adLoader: GADAdLoader,
  Receive customNativeAd: GADCustomNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *) customNativeAd;

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

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

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

Swift

adLoader.load(GAMRequest())

Objective-C

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

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

ملاحظة: لا يتيح "مدير الإعلانات" تحميل إعلانات متعددة باستخدام GADMultipleAdsAdLoaderOptions، ويعرض إعلانًا واحدًا فقط في حال استخدامه.

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

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

• adLoader:didFailToReceiveAdWithError: في GADAdLoaderDelegate
• adLoader:didReceiveNativeAd: في GADNativeAdLoaderDelegate

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

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

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

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didFailToReceiveAdWithError error: NSError)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didFailToReceiveAdWithError:(NSError *)error;

تحذير: لا ننصح بشدة بمحاولة تحميل إعلان جديد باستخدام طريقة التفويض في "adLoader:didFailToReceiveAdWithError:". في حال كان عليك تحميل إعلان من adLoader:didFailToReceiveAdWithError:، عليك الحدّ من عمليات إعادة محاولة تحميل الإعلانات لتجنُّب تعذُّر إرسال طلبات الإعلان المستمرة في حالات مثل الاتصال المحدود بالشبكة.

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

ليتم إشعارك بالأحداث ذات الصلة بالتفاعلات مع الإعلانات المدمجة مع المحتوى، يجب ضبط موقع التفويض للإعلان المدمج مع المحتوى:

Swift

nativeAd.delegate = self

Objective-C

nativeAd.delegate = self;

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

Swift

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

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

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

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

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

func nativeAdWillLeaveApplication(_ nativeAd: GADNativeAd) {
  // 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:.

عرض إعلانك

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