يمكن للناشرين في "مدير إعلانات Google" إنشاء أشكال إعلانات أصلية خاصة بهم من خلال تحديد قوائم مخصّصة لمواد العرض. يمكن استخدام أشكال الإعلانات المدمجة مع المحتوى المخصّصة مع الإعلانات المحجوزة. تتيح أشكال الإعلانات المدمجة مع المحتوى المخصّصة للناشرين إمكانية تمرير بيانات عشوائية للصور والسلاسل إلى تطبيقاتهم. يتم تمثيل هذه البيانات باستخدام عنصر CustomNativeTemplateAd.
تحميل أشكال "الإعلانات المدمجة مع المحتوى" المخصّصة
يتم تحميل أشكال "الإعلانات المدمجة مع المحتوى" المخصّصة باستخدام عناصر AdLoader.
تضبط طريقة forCustomTemplateAd() السمة AdLoader للتعامل مع أشكال الإعلانات المدمجة مع المحتوى المخصّصة. لكل شكل إعلان مدمج مع المحتوى مخصّص قيمة معرّف نموذج مرتبطة به. يجب تحديد رقم تعريف نموذج شكل الإعلان المخصّص على الأجهزة الجوّالة الذي يريد تطبيقك أن تطلبه AdLoader.
ابحث عن أرقام تعريف النماذج في واجهة مستخدم "مدير إعلانات Google" للعثور على رقم تعريف نموذج شكل الإعلان المدمج مع المحتوى الذي تريد طلبه.
void LoadCustomNativeTemplateAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.forCustomNativeAd("10063170")
.Build();
adLoader.LoadAd(new AdRequest.Builder().Build());
}
بما أنّه يمكن إعداد وحدة إعلانية واحدة لعرض أكثر من نموذج تصميم إعلان واحد، يمكن استدعاء forCustomTemplateAd() عدة مرات باستخدام معرّفات نماذج مختلفة
لإعداد Adloader لأكثر من شكل إعلان أصلي مخصّص واحد محتمل.
يوضّح مقتطف الرمز البرمجي أدناه كيفية إعداد AdLoader لعدّة نماذج مخصّصة لأشكال الإعلانات الأصلية.
void LoadCustomNativeTemplateAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.forCustomNativeAd("10063170")
.forCustomNativeAd("10063171")
.forCustomNativeAd("10063172")
.Build();
adLoader.LoadAd(new AdRequest.Builder().Build());
}
أحداث الإعلانات في شكل "الإعلانات المدمجة مع المحتوى" المخصّصة
تقدّم الفئة AdLoader أحداثًا إعلانية من النوع EventHandler
لإعلامك بدورة حياة شكل إعلان أصلي مخصّص.
يوضّح المثال أدناه كيفية التسجيل في أحداث الإعلانات بتنسيق الإعلانات المخصّصة على الأجهزة الجوّالة:
adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
تحتوي الطريقة HandleCustomNativeAdLoaded() على المَعلمة CustomNativeEventArgs.
يمكن الوصول إلى شكل "الإعلان المدمج مع المحتوى" المخصّص الذي تم تحميله من خلال مَعلمة الحدث هذه، كما هو موضّح أدناه:
private boolean adLoaded;
private CustomNativeTemplateAd customNativeTemplateAd;
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
customNativeTemplateAd = args.nativeAd;
adLoaded = true;
}
عرض أشكال "الإعلانات المدمجة مع المحتوى" المخصّصة على الشبكة الإعلانية
توفّر أشكال الإعلانات المدمجة مع المحتوى المخصّصة إمكانية استخدام أي عدد من مواد العرض النصية والمصوّرة التي يحدّدها المستخدم. يمكن الوصول إلى مواد العرض هذه من خلال الفئة CustomNativeTemplateAd،
التي توفّر الطريقتَين GetTexture2D() وGetText() اللتَين تأخذان رقم تعريف المتغيّر الخاص بحقل النموذج كمعلَمة.
يستخرج مثال التنفيذ التالي مواد العرض من CustomNativeTemplateAd:
public const int NATIVE_AD_TEMPLATE_1 = 10063170;
public const int NATIVE_AD_TEMPLATE_2 = 10063171;
private boolean adLoaded;
private Texture2d mainImageTexture;
private string headline;
private CustomNativeTemplateAd customNativeTemplateAd;
...
void Update()
{
if(adLoaded)
{
mainImageTexture = customNativeTemplateAd.GetTexture2D("MainImage");
headline = customNativeTemplateAd.GetText("Headline");
string templateId = customNativeTemplateAd.GetCustomTemplateId();
if (templateId == NATIVE_AD_TEMPLATE_1)
{
...
}
else if (templateId == NATIVE_AD_TEMPLATE_2)
{
...
}
...
adLoaded = false;
}
}
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeEventArgs args)
{
customNativeTemplateAd = args.nativeAd;
adLoaded = true;
...
}
التعامل مع النقرات ومرّات الظهور في شكل "الإعلانات المدمجة مع المحتوى" المخصّص
باستخدام أشكال الإعلانات المدمجة مع المحتوى المخصّصة، يكون تطبيقك مسؤولاً عن تسجيل مرّات الظهور والإبلاغ عن أحداث النقرات إلى حزمة SDK.
عدد مرّات الظهور
لتسجيل مرّة ظهور لشكل إعلان مدمج مع المحتوى مخصّص، استدعِ طريقة RecordImpression() على CustomNativeTemplateAd المقابل:
customNativeTemplateAd.RecordImpression();
نقرات الإبلاغ
للإبلاغ عن حدوث نقرة على مادة عرض في حزمة SDK، استدعِ طريقة PerformClick() على CustomNativeTemplateAd المقابل ومرِّر اسم مادة العرض التي تم النقر عليها. على سبيل المثال، إذا كان لديك مادة عرض في تنسيق الإعلان الأصلي المخصّص باسم "MainImage" وأردت تسجيل نقرة على النسيج الذي يتوافق مع مادة العرض هذه، سيبدو الرمز البرمجي على النحو التالي:
customNativeTemplateAd.PerformClick("MainImage");
عند تسجيل نقرة على إعلان نموذج مخصّص، هناك ردّان محتملان من حزمة SDK، ويتمّ تنفيذهما بهذا الترتيب:
- ابحث عن أداة تحليل محتوى لعنوان URL الخاص بالرابط لصفحة معيّنة في الإعلان، وابدأ بالأداة الأولى التي تحلّل المحتوى.
- افتح متصفّحًا وانتقِل إلى عنوان URL التقليدي الخاص بالصفحة المقصودة للإعلان.
إجراءات النقر المخصّصة
قد تقرّر التعامل مع إجراء النقر بنفسك في ما يتعلّق بتنسيقات الإعلانات المخصّصة على التطبيق
بدلاً من توجيه المستخدم إلى رابط لصفحة في التطبيق أو متصفّح الويب. يمكنك إجراء ذلك من خلال تقديم Action<CustomNativeTemplateAd, string> اختياري في طريقة AdLoader.Builder.forCustomTemplateAd(). من خلال ضبط إجراء النقر المخصّص هذا، يمكنك تجاهل سلوك النقر في حزمة SDK الموضّح أعلاه.
في ما يلي مثال يستخدم إجراء نقر مخصّصًا لتسجيل نقرة على مادة عرض معيّنة:
private void LoadCustomNativeTemplateAd()
{
AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
.forCustomNativeAd("10063170", HandleCustomNativeAdClicked)
.Build();
adLoader.onCustomNativeTemplateAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;
adLoader.LoadAd(createAdRequest());
}
private void HandleCustomNativeAdClicked(CustomNativeTemplateAd customNativeTemplateAd, string assetName)
{
Debug.Log("Native ad asset with name " + assetName + " was clicked.");
}