الإعلان البيني بمكافأة (إصدار تجريبي)

الإعلان البيني بمكافأة هو نوع من شكل إعلان تحفيزي يتيح لك تقديم مكافآت مقابل الإعلانات التي تظهر تلقائيًا أثناء عمليات الانتقال الطبيعية للتطبيق. وعلى عكس الإعلانات التي تضم مكافأة، مطلوب الموافقة على عرض الإعلانات البينية التي تضم مكافأة.

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

• أكمِل دليل البدء.

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

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

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

/21775744923/example/rewarded-interstitial

إعداد حزمة تطوير البرامج (SDK) لعرض الإعلانات للأجهزة الجوّالة

قبل تحميل الإعلانات، يجب أن يُعِدّ تطبيقك حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة من خلال الاتصال MobileAds.Initialize() يجب إجراء ذلك مرة واحدة فقط، ومن الأفضل أن يتم ذلك عند تشغيل التطبيق.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

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

التنفيذ

الخطوات الأساسية لدمج الإعلانات البينية التي تضم مكافأة هي:

1. تحميل الإعلان البيني الذي يضم مكافأة
2. [اختياري] التحقق من صحة عمليات استدعاء التحقّق من جهة الخادم (SSV)
3. عرض الإعلان البيني الذي يضم مكافأة مع معاودة الاتصال بمكافأة
4. الاستماع إلى أحداث الإعلانات البينية التي تضم مكافأة
5. تنظيف الإعلان البيني الذي يضم مكافأة
6. التحميل المسبق للإعلان البيني التالي الذي يضم مكافأة

تحميل الإعلان البيني الذي يضمّ مكافأة

اكتمال تحميل إعلان بيني يضم مكافأة باستخدام طريقة Load() الثابتة في الفئة RewardedInterstitialAd. تتطلب طريقة التحميل إعلانًا. رقم تعريف الوحدة وعنصر AdManagerAdRequest وإكمال المعالِج الذي يتم طلبه عند نجاح تحميل الإعلان أو تعذُّر تحميله. يتوفّر عنصر RewardedInterstitialAd كمَعلمة في عملية الإكمال. . يوضّح المثال أدناه كيفية تحميل RewardedInterstitialAd.

  // This ad unit is configured to always serve test ads.
  private string _adUnitId = "/21775744923/example/rewarded-interstitial";

  private RewardedInterstitialAd _rewardedInterstitialAd;

  /// <summary>
  /// Loads the rewarded interstitial ad.
  /// </summary>
  public void LoadRewardedInterstitialAd()
  {
      // Clean up the old ad before loading a new one.
      if (_rewardedInterstitialAd != null)
      {
            _rewardedInterstitialAd.Destroy();
            _rewardedInterstitialAd = null;
      }

      Debug.Log("Loading the rewarded interstitial ad.");

      // create our request used to load the ad.
      var adRequest = new AdManagerAdRequest();
      adRequest.Keywords.Add("unity-admob-sample");

      // send the request to load the ad.
      RewardedInterstitialAd.Load(_adUnitId, adRequest,
          (RewardedInterstitialAd ad, LoadAdError error) =>
          {
              // if error is not null, the load request failed.
              if (error != null || ad == null)
              {
                  Debug.LogError("rewarded interstitial ad failed to load an ad " +
                                 "with error : " + error);
                  return;
              }

              Debug.Log("Rewarded interstitial ad loaded with response : "
                        + ad.GetResponseInfo());

              _rewardedInterstitialAd = ad;
          });
  }

تحذير: محاولة تحميل إعلان جديد من حظر إكمال طلب الإعلان في حين لا ننصح أبدًا بفشل تحميل إعلان. في حال كان عليك تحميل إعلان من الإعلان حظر إكمال الطلب، يمكنك الحدّ من محاولات عدد مرات إعادة تحميل الإعلانات لتجنُّب التكرارات المستمرة تعذّر تنفيذ طلبات الإعلان في حالات مثل الاتصال بالشبكة بشكل محدود.

ملاحظة: يمكنك استخدام طلبات تحميل الإعلانات لإنشاء ذاكرة تخزين مؤقت للإعلانات المحمَّلة مسبقًا قبل أن تنوي عرضها، حتى يمكن عرض الإعلانات بدون أي وقت استجابة عند الحاجة. ونظرًا لأن صلاحية الإعلانات تنتهي بعد ساعة، يجب محو ذاكرة التخزين المؤقت هذه وإعادة التحميل باستخدام من الإعلانات كل ساعة.

[اختياري] التحقّق من صحة عمليات معاودة الاتصال في عملية إثبات الملكية من جهة الخادم

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

يوضح نموذج التعليمة البرمجية التالي كيفية تعيين خيارات SSV بعد تم تحميل الإعلان البيني الذي يضم مكافأة.

// send the request to load the ad.
RewardedInterstitialAd.Load(_adUnitId,
                            adRequest,
                            (RewardedInterstitialAd ad, LoadAdError error) =>
    {
        // If the operation failed, an error is returned.
        if (error != null || ad == null)
        {
            Debug.LogError("Rewarded interstitial ad failed to load an ad " +
                           " with error : " + error);
            return;
        }

        // If the operation completed successfully, no error is returned.
        Debug.Log("Rewarded interstitial ad loaded with response : " +
                   ad.GetResponseInfo());
        
        // Create and pass the SSV options to the rewarded ad.
        var options = new ServerSideVerificationOptions
                              .Builder()
                              .SetCustomData("SAMPLE_CUSTOM_DATA_STRING")
                              .Build()
        ad.SetServerSideVerificationOptions(options);
        
});

إذا كنت تريد ضبط سلسلة المكافأة المخصّصة، عليك إجراء ذلك قبل عرض الإعلان.

نقطة رئيسية: سلسلة المكافأة المخصّصة هي تجاوز النسبة المئوية وقد تتطلب فك الترميز عند تحليلها من معاودة اتصال SSV.

عرض الإعلان البيني الذي يضم مكافأة مع معاودة الاتصال بمكافأة

عند عرض إعلانك، يجب توفير معاودة اتصال للتعامل مع مكافأة المستخدم. يمكن عرض الإعلانات مرة واحدة فقط لكل تحميل. استخدِم طريقة CanShowAd() من أجل التحقق من أن الإعلان جاهز للعرض.

يقدِّم الرمز التالي أفضل طريقة لعرض إعلان بمكافأة الإعلان البيني.

public void ShowRewardedInterstitialAd()
{
    const string rewardMsg =
        "Rewarded interstitial ad rewarded the user. Type: {0}, amount: {1}.";

    if (rewardedInterstitialAd != null && rewardedInterstitialAd.CanShowAd())
    {
        rewardedInterstitialAd.Show((Reward reward) =>
        {
            // TODO: Reward the user.
            Debug.Log(String.Format(rewardMsg, reward.Type, reward.Amount));
        });
    }
}

نقطة رئيسية: قبل عرض إعلان بيني يضم مكافأة للمستخدمين، يجب: اعرض للمستخدم شاشة مقدمة توفر رسالة واضحة عن المكافآت خيار لتخطي الإعلان قبل بدئه. مزيد من المعلومات

الاستماع إلى أحداث الإعلانات البينية التي تضم مكافأة

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

private void RegisterEventHandlers(RewardedInterstitialAd ad)
{
    // Raised when the ad is estimated to have earned money.
    ad.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Rewarded interstitial ad paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    ad.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Rewarded interstitial ad recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    ad.OnAdClicked += () =>
    {
        Debug.Log("Rewarded interstitial ad was clicked.");
    };
    // Raised when an ad opened full screen content.
    ad.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Rewarded interstitial ad full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Rewarded interstitial ad full screen content closed.");
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Rewarded interstitial ad failed to open " +
                       "full screen content with error : " + error);
    };
}

تنظيف الإعلان البيني الذي يضم مكافأة

عند الانتهاء من "RewardedInterstitialAd"، احرص على الاتصال Destroy() قبل إسقاط الإشارة إليها:

_rewardedInterstitialAd.Destroy();

يتم بذلك إعلام المكون الإضافي بأن الكائن لم يعد قيد الاستخدام والذاكرة ويمكن استردادها. يؤدي عدم طلب هذه الطريقة إلى حدوث تسرُّب للذاكرة.

تحميل الإعلان البيني التالي الذي يضمّ مكافأة مسبقًا

RewardedInterstitialAd هو عنصر يُستخدم لمرة واحدة. وهذا يعني أنه بمجرد ظهور مكافأة سيتم عرض إعلان بيني، لا يمكن استخدام العنصر مرة أخرى. لطلب مفتاح آخر إعلان بيني يضم مكافأة، ستحتاج إلى تحميل RewardedInterstitialAd جديد الخاص بك.

لإعداد إعلان بيني يضم مكافأة من أجل فرصة الظهور التالية، التحميل المسبق للإعلان البيني الذي يضم مكافأة بعد النقر على OnAdFullScreenContentClosed أو تم رفع حدث إعلان واحد (OnAdFullScreenContentFailed).

private void RegisterReloadHandler(RewardedInterstitialAd ad)
{
    // Raised when the ad closed full screen content.
    ad.OnAdFullScreenContentClosed += ()
    {
        Debug.Log("Rewarded interstitial ad full screen content closed.");

        // Reload the ad so that we can show another as soon as possible.
        LoadRewardedInterstitialAd();
    };
    // Raised when the ad failed to open full screen content.
    ad.OnAdFullScreenContentFailed += (AdError error) =>
    {
        Debug.LogError("Rewarded interstitial ad failed to open " +
                       "full screen content with error : " + error);

        // Reload the ad so that we can show another as soon as possible.
        LoadRewardedInterstitialAd();
    };
}

مراجع إضافية

• مثال على HelloWorld: الحد الأدنى من التنفيذ لكل أشكال الإعلانات: