أرباح الإعلانات على مستوى مرّات الظهور

عند حدوث مرّة ظهور، تقدّم حزمة SDK لإعلانات Google على الأجهزة الجوّالة بيانات أرباح الإعلانات المرتبطة بهذه المرّة. يمكنك استخدام البيانات لاحتساب قيمة العميل الدائمة أو إعادة توجيه البيانات إلى الأنظمة الأخرى ذات الصلة.

يهدف هذا الدليل إلى مساعدتك في تنفيذ عملية تسجيل بيانات أرباح الإعلانات على مستوى مرّات الظهور في مشروعك على Unity.

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

تنفيذ معالج حدث مدفوع

يحتوي كل شكل من أشكال الإعلانات على حدث OnAdPaid. خلال دورة حياة حدث إعلان، ترصد "Google Mobile Ads SDK" أحداث مرّات الظهور وتستدعي معالِجًا باستخدام AdValue يمثّل القيمة المكتسَبة.

يعالج المثال التالي الأحداث المدفوعة لإعلان يضم مكافأة:

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

لمزيد من المعلومات عن مصدر الإعلان الفائز، اطّلِع على مقالة استرداد معلومات عن استجابة الإعلان.

الدمج مع شركاء إحالة التطبيقات

للاطّلاع على التفاصيل الكاملة حول إعادة توجيه بيانات أرباح الإعلانات إلى منصات الإحصاءات، يُرجى الرجوع إلى دليل الشركاء:

حزمة تطوير البرامج (SDK) للشريك
Adjust
AppsFlyer
Singular
Tenjin

أفضل الممارسات المتعلّقة بالتنفيذ

  • اضبط الحدث OnPaidEvent فورًا بعد إنشاء ملف تعريف الإعلان أو الوصول إليه، وقبل عرض الإعلان بالتأكيد. يضمن ذلك عدم تفويت أي عمليات استدعاء.
  • أرسِل معلومات إيرادات الإعلانات على مستوى مرّات الظهور إلى خادم الإحصاءات المفضّل لديك على الفور في معالِج OnPaidEvent. يضمن لك ذلك عدم إسقاط أي عمليات استدعاء عن طريق الخطأ وتجنُّب الاختلافات في البيانات.

AdValue

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

AdValue.PrecisionType الوصف
Unknown قيمة إعلان غير معروفة. يتم عرض هذا الرمز عندما يكون رمز pingback لقيمة LTV مفعّلاً ولكنه لا يتوفّر لديه بيانات كافية.
Estimated قيمة إعلان مقدّرة من بيانات مجمَّعة.
PublisherProvided قيمة الإعلان التي قدّمها الناشر، مثل قيم التكلفة اليدوية لكل ألف ظهور في مجموعة توسّط.
Precise القيمة الدقيقة لهذا الإعلان.

في حال التوسّط، تحاول AdMob تقديم Estimatedقيمة لمصادر الإعلانات التي تم تحسينها. بالنسبة إلى مصادر الإعلانات غير المحسّنة، أو في الحالات التي لا تتوفّر فيها بيانات مجمّعة كافية لإعداد تقدير ذي مغزى، يتم عرض القيمة PublisherProvided.

اختبار مرّات الظهور من مصادر الإعلانات المستندة إلى عروض الأسعار

بعد حدوث حدث أرباح إعلانات على مستوى مرّات الظهور ل مصدر إعلان مستند إلى عروض الأسعار من خلال طلب اختباري، لن تتلقّى سوى القيم التالية:

  • Unknown: يشير إلى نوع الدقة.
  • ‫0: يشير إلى قيمة الإعلان.

في السابق، قد يكون نوع الدقّة قد ظهر لك كقيمة غير Unknown وقيمة إعلان تزيد عن 0.

للاطّلاع على تفاصيل حول إرسال طلب إعلان تجريبي، يُرجى الاطّلاع على مقالة تفعيل الأجهزة الاختبارية.