أشكال الإعلانات المدمجة مع المحتوى المخصّصة

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

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

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

• formatId للإعلان المخصّص الذي يجب أن يطلبه AdLoader. يحتوي كل شكل إعلان مُدمَج مع المحتوى مخصّص على قيمة معرّف شكل مرتبطة به. تشير هذه المَعلمة إلى الشكل الذي يريد تطبيقك من AdLoader طلبه.
• Action<CustomNativeAd, string> اختياري يتمّ استدعاؤه عندما ينقر المستخدِم على الإعلان.

يتم تحميل الإعلانات المدمجة المخصّصة من خلال فئة AdLoader التي تحتوي على فئة AdLoader.Builder لتخصيصها أثناء الإنشاء. تعمل طريقة ForCustomNativeAd() على ضبط AdLoader لمعالجة الإعلانات المدمجة مع المحتوى.

void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
            .ForCustomNativeAd("10063170")
            .Build();
    adLoader.LoadAd(new AdRequest.Builder().Build());
}

بما أنّه يمكن إعداد وحدة إعلانية واحدة لعرض أكثر من شكل واحد مخصّص للإعلانات المدمجة، يمكن استدعاء ForCustomNativeAd() عدّة مرات بمعرّفات أشكال مختلفة من أجل إعداد أداة تحميل الإعلانات لأكثر من شكل واحد مخصّص ممكن للإعلانات المدمجة.

أحداث الإعلانات المدمجة مع المحتوى المخصّصة

توفّر فئة AdLoader أحداث الإعلانات من النوع EventHandler لإعلامك بدورة حياة إعلان مضمّن مخصّص. يوضّح المثال التالي كيفية التسجيل في أحداث الإعلانات المدمجة مع المحتوى المخصّصة على أداة تحميل الإعلانات:

private AdLoader adLoader;
adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
adLoader.OnAdFailedToLoad += HandleCustomNativeAdFailedToLoad;

تحتوي الطريقة HandleCustomNativeAdLoaded() على مَعلمة CustomNativeAdEventArgs. يمكن الوصول إلى الإعلان المخصّص المدمج مع المحتوى الذي تم تحميله من خلال مَعلمة الحدث هذه، كما هو موضّح أدناه:

void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
    this.customNativeAd = args.nativeAd;
}

تحتوي الطريقة HandleCustomNativeAdFailedToLoad() على مَعلمة AdFailedToLoadEventArgs. يمكن الوصول إلى رسالة الخطأ من خلال استدعاء طريقة GetMessage في حقل LoadAdError، كما هو موضّح أدناه:

void HandleCustomNativeAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    string message = args.LoadAdError.GetMessage();
    Debug.Log("Ad Loader fail event received with message: " + message);
}

عرض أشكال الإعلانات المدمجة مع المحتوى المخصّصة

تتيح الإعلانات المدمجة مع المحتوى المخصّصة استخدام أي عدد من مواد عرض الصور والنصوص التي يحدّدها المستخدِم. يتم الوصول إلى مواد العرض هذه من خلال فئة CustomNativeAd التي توفّر الطريقتَين GetTexture2D() وGetText() اللتين تأخذان معرّف المتغيّر لحقل التنسيق كمَعلمة.

في ما يلي مثال على عملية تنفيذ تحصل على مواد العرض من إعلان مخصّص مُدمَج مع المحتوى:

private bool adLoaded;
private Texture2D mainImageTexture;
private string headline;
private CustomNativeAd customNativeAd;
...

void Update()
{
    if(adLoaded)
    {
        mainImageTexture = customNativeAd.GetTexture2D("MainImage");
        headline = customNativeAd.GetText("Headline");
        adLoaded = false;
    }
}
...
void HandleCustomNativeAdLoaded(object sender, CustomNativeAdEventArgs args)
{
    customNativeAd = args.nativeAd;
    adLoaded = true;
    ...
}

التعامل مع مرّات ظهور الإعلانات المخصّصة المدمجة مع المحتوى والنقرات عليها

باستخدام الإعلانات المدمجة المخصّصة، يكون تطبيقك مسؤولاً عن تسجيل مرّات الظهور وتسجيل أحداث النقر وإرسالها إلى حزمة تطوير البرامج (SDK).

تسجيل مرّات الظهور

لتسجيل مرّة ظهور لإعلان مخصّص، استخدِم طريقة RecordImpression() في CustomNativeAd المقابل:

customNativeAd.RecordImpression();

الإبلاغ عن النقرات

للإبلاغ إلى حزمة تطوير البرامج (SDK) عن حدوث نقرة على مادة عرض، يمكنك استدعاء PerformClick() في CustomNativeAd ذي الصلة وضبط اسم مادة العرض التي تم النقر عليها. على سبيل المثال، إذا كانت لديك مادة عرض في التنسيق المخصّص المُسمى "MainImage" وأردت الإبلاغ عن نقرة على النسيج الذي يتوافق مع مادة العرض هذه، سيبدو الرمز على النحو التالي:

customNativeAd.PerformClick("MainImage");

الردّ على إجراءات النقر المخصّصة

عند الإبلاغ عن نقرة على إعلان مخصّص، تتم محاولة تنفيذ الردود المحتملة من حزمة SDK بالترتيب التالي:

1. حدِّد موقع أداة حلّ عناوين URL لرابط الصفحة في التطبيق للإعلان وابدأ استخدام أول أداة تحلّ المشكلة.

2. افتح متصفّحًا وانتقِل إلى عنوان URL التقليدي المقصود للإعلان.

إذا كنت تريد معالجة إجراء النقر لتنسيقات الإعلانات المدمجة المخصّصة بنفسك بدلاً من توجيه المستخدِم إلى رابط لصفحة في التطبيق أو متصفّح ويب، قدِّم Action<CustomNativeAd, string> اختياريًا في الأسلوب AdLoader.Builder.ForCustomNativeAd(). من خلال ضبط هذا الإجراء المخصّص للنقر، يتم إلغاء سلوك النقر في حِزم تطوير البرامج (SDK). في ما يلي مثال يستخدِم إجراء نقر مخصّصًا لتسجيل نقرة لمادة عرض معيّنة:

private void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/21775744923/example/native")
            .ForCustomNativeAd("10063170", HandleCustomNativeAdClicked)
            .Build();
    adLoader.OnCustomNativeAdLoaded += HandleCustomNativeAdLoaded;
    adLoader.LoadAd(createAdRequest());
}

private void HandleCustomNativeAdClicked(CustomNativeAd customNativeAd, string assetName)
{
    Debug.Log("Custom Native ad asset with name " + assetName + " was clicked.");
}