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

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

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