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

ملاحظة: لا تتوفر الإعلانات المدمجة مع المحتوى المخصّصة إلا للناشرين في "مدير الإعلانات".

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

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

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

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

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

void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/6499/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 المقابل وتمرير اسم مادة العرض التي تم النقر عليها. على سبيل المثال، إذا كان لديك مادة عرض بالتنسيق المخصّص باسم

customNativeAd.PerformClick("MainImage");

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

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

1. حدِّد موقع برنامج تعيين المحتوى لعنوان URL لرابط صفحة "موضع الإعلان" وابدأ تشغيل أول عنوان URL يتم حله.

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

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

private void LoadCustomNativeAd()
{
    AdLoader adLoader = new AdLoader.Builder("/6499/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.");
}