كيفية إعداد إشعارات AdMate وخطافات الويب في RevenueCat

يمكن لإشعارات AdMate أن تضيف سياقًا إلى أحداث RevenueCat، لكن مسار الإشعارات منفصل عن اتصال لوحة المعلومات. فالتطبيق يستعلم عن المشاريع باستخدام بيانات الاعتماد التي أعدّها المستخدم، بينما تستقبل واجهة AdMate البرمجية خطافات الويب المُعدّة وتستخدم سياقًا مؤقتًا للجهاز لإنشاء الإشعار المناسب.

إن الفصل بين هذه المسؤوليات أمر أساسي للأمان ولاستكشاف الأخطاء.

AdMate

كل إيراداتك في لوحة تحكم واحدة

تابع AdMob وAdSense وRevenueCat وApp Store Connect عبر حسابات متعددة مع فلاتر حسب التطبيق والمنصة والبلد

راقب الإيرادات والنقرات وeCPM والاشتراكات وعمليات التثبيت والمدفوعات من iPhone وiPad وMac وApple Watch

إعدادان لغرضين مختلفين

اتصال لوحة المعلومات

يتيح حساب RevenueCat في AdMate للتطبيق قراءة المشاريع والمقاييس المتاحة وفق التفويض المُعدّ.

توصيل خطافات الويب

يرسل RevenueCat الأحداث إلى نقطة نهاية خطافات الويب في واجهة AdMate البرمجية. وتستخدم الواجهة سياق الجهاز المسجل، مثل المشروع والتطبيق واللغة والعملة، لإعداد الإشعارات المدعومة.

لا تؤدي إضافة مفتاح إلى لوحة المعلومات إلى إنشاء خطاف الويب لدى المزوّد تلقائيًا. كما أن إنشاء خطاف الويب لا يمنح لوحة معلومات التطبيق تفويضًا.

جهّز سياق التطبيق

اربط حساب RevenueCat في AdMate وتحقق منه.
اختر المشاريع والتطبيقات المقصودة.
افتح إعداد خطافات الويب أو الإشعارات الذي يوفره التطبيق.
زامن سياق الجهاز الذي يطلبه سير العمل.
تأكد من اللغة والعملة وأسماء المشاريع.
اسمح بالإشعارات على مستوى نظام التشغيل.

لسياق الواجهة البرمجية مدة صلاحية محدودة، ويجب تحديثه عبر سير العمل المدعوم في التطبيق. وهو ليس قاعدة بيانات مالية دائمة.

اضبط RevenueCat

استخدم إعدادات خطافات الويب في RevenueCat لإضافة نقطة النهاية ومعلومات التفويض التي يعرضها سير عمل AdMate. اتبع التعليمات الحالية داخل التطبيق بدلًا من نسخ بيانات اعتماد من بيئة أخرى.

اختبر بحدث غير حساس متى أمكن. ولا تضع أبدًا مفتاحًا سريًا أو قيمة تفويض خطاف الويب كاملة في لقطة شاشة أو مستودع أو سلسلة دعم عامة.

تحقق من المسار كاملًا

افحص السلسلة كلها:

يقبل RevenueCat إعداد خطاف الويب.
يُسلَّم حدث مدعوم بنجاح.
تستطيع واجهة AdMate البرمجية تحديد سياق الجهاز والمشروع.
تقبل خدمة المنصة توصيل الإشعار الفوري.
لا يزال الجهاز مسجلًا ويسمح بالإشعارات.
المشروع والتطبيق واللغة والعملة المعروضة صحيحة.

لا يتحقق التحديث الناجح للوحة المعلومات إلا من مسار مختلف.

استكشاف الأخطاء وإصلاحها

يبلّغ RevenueCat عن خطأ في خطاف الويب

تحقق من نقطة النهاية والتفويض وحالة الاستجابة في RevenueCat. ولا تغيّر مفاتيح لوحة المعلومات غير المرتبطة بالمشكلة.

ينجح خطاف الويب لكن لا يصل أي إشعار

تحقق من سياق الجهاز وإذن الإشعارات الفورية والتسجيل وما إذا كان نوع الحدث مدعومًا. وقد تنتهي صلاحية سياق الجهاز بعد فترة من عدم النشاط.

يعرض الإشعار اسم مشروع خاطئًا

حدّث السياق من المشروع الصحيح، وتأكد من عدم ربط حسابين بالاسم المعروض نفسه.

جهاز يعمل وآخر لا يعمل

لكل جهاز تسجيله وسياقه الخاص. اختبر الأذونات والسياق على الجهاز المتأثر.

قواعد الأمان

أبقِ تفويض خطافات الويب ومفاتيح المزوّدين خارج Git.
لا تسجّل في السجلات حمولات كاملة تحتوي على معرّفات العملاء أو المعاملات.
لا تستخدم واجهة خطافات الويب البرمجية مستودعًا لبيانات الإيرادات.
استبدل أي تفويض مكشوف فورًا.
احذف سياق الجهاز عندما لا ينبغي أن يتلقى الأحداث بعد الآن.

الأسئلة الشائعة

هل يخزّن AdMate سجل RevenueCat الكامل الخاص بي على خادمه؟

لا. تعالج الواجهة البرمجية أحداث خطافات الويب وسياقًا مؤقتًا للجهاز والمشروع، بينما يستعلم التطبيق مباشرة من الخدمات المُعدّة.

لماذا أحتاج إلى حساب للوحة المعلومات وإلى خطاف ويب معًا؟

لأنهما يخدمان مسارين مختلفين: التقارير التفاعلية وإشعارات الأحداث التي يرسلها الخادم.

هل يمكن لخطاف الويب إصلاح المقاييس المفقودة في لوحة المعلومات؟

لا. تحقق من تفويض RevenueCat في التطبيق ومن ربط المشاريع.

ما الذي يجب أن يتضمنه تقرير دعم آمن؟

نوع الحدث والوقت التقريبي والحالة بعد حجب البيانات وسياق الجهاز والتطبيق، ولا يتضمن أبدًا مفاتيح سرية أو معرّفات العملاء الكاملة.