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

يمكن لناشري "مدير إعلانات 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.");
}