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

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

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

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

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

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

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

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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, 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 القيمة الدقيقة لهذا الإعلان.

في حال التوسّط، يحاول "مدير الإعلانات" توفير قيمة ESTIMATED للإعلان. المصادر التي تم فيها تفعيل ميزة جمع البيانات تلقائيًا. لمزيد من المعلومات، يُرجى مراجعة جمع البيانات تلقائيًا: بالنسبة مصادر الإعلانات التي لم يتم تفعيل ميزة جمع البيانات تلقائيًا فيها، أو في حالات حيث لا توجد بيانات مجمّعة كافية لتقديم تقدير ذي مغزى، تم عرض قيمة PUBLISHER_PROVIDED.

اختبار مرّات الظهور من "عرض الأسعار المفتوح"

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

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

في السابق، ربما رأيت نوع الدقة كقيمة أخرى غير Unknown وقيمة إعلان أكبر من 0.

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