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

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

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

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

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

• تأكَّد من تفعيل ميزة "إيرادات الإعلان على مستوى مرة الظهور" في واجهة مستخدم "مدير إعلانات Google".
• المكوّن الإضافي Unity‏ 5.0.0 أو إصدار أحدث
• أكمِل خطوات البدء. من المفترض أن يكون تطبيق Unity قد استورد Google Mobile Ads Unity Plugin.

• قبل أن تتمكّن من تلقّي أي بيانات لإيرادات الإعلانات على مستوى مرّات الظهور، عليك تنفيذ شكل إعلان واحد على الأقل:

  • إعلان بانر
  • الإعلانات البينية
  • الإعلانات مقابل مكافأة
  • الإعلانات البينية مقابل مكافأة
  • الإعلان المدمجة مع المحتوى

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

لكل شكل إعلان حدث OnPaidEvent. خلال مراحل نشاط حدث الإعلان، يراقب Google Mobile Ads Unity Plugin أحداث مرّات الظهور ويستدعي المعالج بقيمة مكتسَبة.

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

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 هي قيمة دقيقة تمثّل قيمة كل إعلان. على سبيل المثال، تشير القيمة 5,000 إلى أنّ القيمة المقدَّرة لهذا الإعلان هي 0.005 دولار أمريكي.

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

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

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

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

• ‫Unknown: يشير إلى تصنيف دقة القيمة.

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

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

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