الإعلانات المدمجة مع المحتوى التي تظهر على سطح الفيديو

اختيار النظام الأساسي: Android iOS Flutter Unity Android (الإصدار القديم)

البدء

يتم عرض "الإعلانات المدمجة مع المحتوى التي تظهر على سطح الفيديو" للمستخدمين من خلال مكوّنات واجهة المستخدم المدمجة في المنصة. تظهر هذه الإعلانات على سطح التطبيق. يشبه ذلك طريقة عمل "إعلانات البانر"، ولكن مع إمكانية تخصيص مظهر الإعلانات.

تتوافق "الإعلانات المدمجة مع المحتوى التي تظهر على سطح الفيديو" مع ميزة التوسّط وإعلانات الفيديو. وهذه ميزة رئيسية تتفوّق بها "الإعلانات المدمجة مع المحتوى التي تظهر على سطح الفيديو" على الإعلانات المدمجة مع المحتوى.

يوضّح لك هذا الدليل كيفية تنفيذ "الإعلانات المدمجة مع المحتوى التي تظهر على سطح الفيديو" في تطبيق Unity، بالإضافة إلى بعض النقاط المهمة التي يجب مراعاتها أثناء ذلك.

المتطلبات الأساسية

قبل المتابعة، عليك تنفيذ ما يلي:

اختبِر دائمًا باستخدام الإعلانات الاختبارية

يحتوي الرمز النموذجي التالي على معرّف وحدة إعلانية يمكنك استخدامه لطلب إعلانات اختبارية. وقد تم ضبطه خصيصًا لعرض إعلانات اختبارية بدلاً من إعلانات إنتاجية لكل طلب، ما يجعله آمنًا للاستخدام.

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

Android

ca-app-pub-3940256099942544/1033173712

iOS

ca-app-pub-3940256099942544/4411468910

تحميل "الإعلان المدمج مع المحتوى الذي يظهر على سطح الفيديو"

يتم تحميل "إعلان مدمج مع المحتوى يظهر على سطح الفيديو" باستخدام الإجراء الثابت Load() في فئة NativeOverlayAd. يتم توفير عنصر NativeOverlayAd الذي تم تحميله كمَعلمة في معالج الإكمال.

يستخدم الرمز التالي NativeOverlayAd لتحميل إعلان:



  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/2247696110";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/3986624511";
#else
  private string _adUnitId = "unused";
#endif


private NativeOverlayAd _nativeOverlayAd;

/// <summary>
/// Loads the ad.
/// </summary>
public void LoadAd()
{
    // Clean up the old ad before loading a new one.
    if (_nativeOverlayAd != null)
    {
        DestroyAd();
    }

    Debug.Log("Loading native overlay ad.");

    // Create a request used to load the ad.
    var adRequest = new AdRequest();

    // Optional: Define native ad options.
    var options = new NativeAdOptions
    {
        AdChoicesPosition = AdChoicesPlacement.TopRightCorner,
        MediaAspectRatio = NativeMediaAspectRatio.Any,
    };

    // Send the request to load the ad.
    NativeOverlayAd.Load(_adUnitId, adRequest, options,
        (NativeOverlayAd ad, LoadAdError error) =>
    {
        if (error != null)
        {
            Debug.LogError("Native Overlay ad failed to load an ad " +
                           " with error: " + error);
            return;
        }

        // The ad should always be non-null if the error is null, but
        // double-check to avoid a crash.
        if (ad == null)
        {
            Debug.LogError("Unexpected error: Native Overlay ad load event " +
                           " fired with null ad and null error.");
            return;
        }

        // The operation completed successfully.
        Debug.Log("Native Overlay ad loaded with response : " +
                   ad.GetResponseInfo());
        _nativeOverlayAd = ad;

        // Register to ad events to extend functionality.
        RegisterEventHandlers(ad);
    });
}

عرض "الإعلان المدمج مع المحتوى الذي يظهر على سطح الفيديو" وتنسيقه

يتم عرض "الإعلانات المدمجة مع المحتوى التي تظهر على سطح الفيديو" باستخدام NativeTemplateStyle. تحدّد هذه الفئة الحقول التي تتيح لك تخصيص مظهر الإعلان.

‫TemplateID هي سلسلة مطلوبة تحدّد النموذج المدمج مع المحتوى المستخدَم لعرض "إعلان يظهر على سطح الفيديو". استخدِم الثابت NativeTemplateID لاختيار نموذج مدمج مع المحتوى مناسب لإعلانك.

يعرض الرمز التالي "الإعلان المدمج مع المحتوى الذي يظهر على سطح الفيديو" باستخدام نموذج متوسط ونمط مخصّص.

/// <summary>
/// Renders the ad.
/// </summary>
public void RenderAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Rendering Native Overlay ad.");

        // Define a native template style with a custom style.
        var style = new NativeTemplateStyle
        {
            TemplateID = NativeTemplateID.Medium,
            MainBackgroundColor = Color.red,
            CallToActionText = new NativeTemplateTextStyles
            {
                BackgroundColor = Color.green,
                FontColor = Color.white,
                FontSize = 9,
                Style = NativeTemplateFontStyle.Bold
            }
        };

        // Renders a native overlay ad at the default size
        // and anchored to the bottom of the screne.
        _nativeOverlayAd.RenderTemplate(style, AdPosition.Bottom);
    }
}

إظهار وإخفاء "الإعلان المدمج مع المحتوى الذي يظهر على سطح الفيديو"

يوضّح الرمز التالي كيفية عرض "إعلان مدمج مع المحتوى يظهر على سطح الفيديو" تم تحميله.

/// <summary>
/// Shows the ad.
/// </summary>
public void ShowAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Showing Native Overlay ad.");
        _nativeOverlayAd.Show();
    }
}

إخفاء الإعلان المدمج مع المحتوى الذي يظهر على سطح الفيديو

يوضّح الرمز التالي كيفية إخفاء "إعلان مدمج مع المحتوى يظهر على سطح الفيديو".

/// <summary>
/// Hides the ad.
/// </summary>
public void HideAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Hiding Native Overlay ad.");
        _nativeOverlayAd.Hide();
    }
}

إزالة "الإعلان المدمج مع المحتوى الذي يظهر على سطح الفيديو"

عند الانتهاء من استخدام "الإعلان المدمج مع المحتوى الذي يظهر على سطح الفيديو"، احرص على استدعاء Destroy() لتحرير الموارد.

/// <summary>
/// Destroys the native overlay ad.
/// </summary>
public void DestroyAd()
{
    if (_nativeOverlayAd != null)
    {
        Debug.Log("Destroying native overlay ad.");
        _nativeOverlayAd.Destroy();
        _nativeOverlayAd = null;
    }
}

الخطوات التالية