الإعلانات المدمجة مع المحتوى هي مواد عرض إعلانات يتم عرضها للمستخدمين من خلال مكوّنات واجهة المستخدم المدمجة مع المحتوى على المنصة. ويتم عرضها باستخدام نفس الفئات التي تستخدمها بالفعل في مخططات القصة الخاصة بك، ويمكن تنسيقها لتتناسب مع التصميم المرئي لتطبيقك.
عند تحميل أحد الإعلانات المدمَجة مع المحتوى، يتلقّى تطبيقك عنصر إعلان يحتوي على مواد العرض الخاصة به، ويكون التطبيق عندئذٍ مسؤولاً عن عرضه، وليس حزمة "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
على واحد أو أكثر من الثوابت التالية
:
تنفيذ تفويض أداة تحميل الإعلانات
يحتاج المستخدم المفوَّض من أداة تحميل الإعلانات إلى تنفيذ بروتوكولات خاصة بنوع إعلانك.
بالنسبة إلى الإعلانات المدمجة مع المحتوى، يشتمل بروتوكول 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
نفسها مثل إعلانات البانر والإعلانات البينية. يمكنك استخدام كائنات الطلب لإضافة
معلومات استهداف، تمامًا كما تفعل مع أنواع الإعلانات الأخرى.
تحديد وقت انتهاء التحميل
بعد اتصال التطبيق بـ 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;
تلقّي إشعارات بشأن أحداث الإعلانات المدمجة مع المحتوى
ليتم إشعارك بالأحداث ذات الصلة بالتفاعلات مع الإعلانات المدمجة مع المحتوى، يجب ضبط موقع التفويض للإعلان المدمج مع المحتوى:
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:
.
عرض إعلانك
بعد تحميل أي إعلان، كل ما تبقى هو عرضه للمستخدمين. يمكنك الانتقال إلى دليل الإعلانات المدمجة مع المحتوى (المتقدّم) للاطّلاع على كيفية إجراء ذلك.