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

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

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

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

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

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

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


RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    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"];
}

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

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

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

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

أفضل ممارسات التنفيذ

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

AdValue

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

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

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