كيفية ربط RevenueCat بـ AdMate

يمنح ربط RevenueCat تطبيق AdMate عرضًا يركّز على الاشتراكات إلى جانب تقارير الإعلانات والمتاجر. ويمكنه إظهار المشاريع والمعاملات والمقاييس التي يتيحها RevenueCat دون تحويل واجهة AdMate البرمجية إلى مخزن للإيرادات على الخادم.

تمنح بيانات اعتماد RevenueCat صلاحيات واسعة. حضّر الاتصال بعناية، واستخدم وضع التفويض الذي يوفره إصدار AdMate الحالي، ولا تلصق أبدًا مفتاحًا سريًا في بلاغ عام أو لقطة شاشة.

AdMate

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

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

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

اختر صلاحية الوصول الصحيحة إلى RevenueCat

يدعم AdMate إعداد حسابات RevenueCat ومشاريع متعددة. وبحسب الحساب والإصدار الحاليين، قد تستخدم شاشة بيانات الاعتماد تفويض API v2 المدعوم، بما في ذلك المفاتيح السرية للمشاريع، وقد تتيح مسار تفويض على مستوى الحساب.

استخدم بيانات الاعتماد ذات أقل صلاحيات تكفي لقراءة البيانات التي تحتاجها. فمفتاح SDK العام المخصص للتضمين في تطبيق لا يحل تلقائيًا محل بيانات اعتماد API السرية، ولا يمكن افتراض أن بيانات اعتماد مشروع واحد ستعرض كل المشاريع في المؤسسة.

قبل الإعداد:

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

أضف حساب RevenueCat

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

إذا كنت تستخدم عدة مفاتيح سرية للمشاريع، فاربط كل مفتاح بالمشروع الصحيح. لا تسمِّ كل إدخال “RevenueCat” فقط؛ فالاسم المستعار الوصفي يمنع المقارنات العرضية بين العملاء.

ما الذي يجب التحقق منه بعد الاتصال

ابدأ بالهوية قبل الإجماليات:

اسم الحساب أو المؤسسة؛
اسم المشروع ومعرّفه؛
التطبيقات والمتاجر المضمّنة؛
نطاق التاريخ والعملة المحددان؛
ما إذا كانت المبالغ المستردة أو التعديلات بالخفض مضمّنة في المقياس المعروض.

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

الوصول إلى اللوحة وخطافات الويب أمران منفصلان

يستخدم AdMate خدمة RevenueCat بطريقتين مختلفتين:

يستعلم تطبيق Apple عن المشاريع التي أعدّها المستخدم للحصول على بيانات اللوحة؛
يمكن لواجهة AdMate البرمجية استقبال خطافات الويب من RevenueCat لمسارات الإشعارات.

إعداد بيانات اعتماد للوحة لا يُعدّ خطاف ويب تلقائيًا، وإنشاء خطاف ويب لا يمنح التطبيق إذنًا بعرض مقاييس المشروع. تعامل معهما كمهمتين منفصلتين ببيانات اعتماد وأغراض منفصلة.

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

معالجة مشروع مفقود

تم التحقق من بيانات الاعتماد لكن يظهر مشروع واحد فقط

تحقق مما إذا كانت بيانات الاعتماد خاصة بذلك المشروع تحديدًا. أضف المفاتيح المطلوبة أو اربطها، أو استخدم الطريقة المدعومة على مستوى الحساب إذا كانت مناسبة.

لا تظهر أي مقاييس لمشروع صالح

اختر نطاق تاريخ مكتملًا يحتوي على معاملات معروفة، وتحقق من مرشحات المشروع والمتجر، ثم حدّث البيانات في التطبيق الرئيسي. قد يُرجع مشروع جديد أو غير نشط صفرًا بشكل صحيح.

فشل التفويض فجأة

ربما أُلغي المفتاح أو استُبدل أو نُسخ مع مسافات. تحقق من حالته في RevenueCat، ثم استبدله في AdMate. لا تحتفظ بمفتاح ملغى كبديل احتياطي.

اسم المشروع صحيح لكن الإجمالي يبدو خاطئًا

تحقق من تعريف المقياس والمبالغ المستردة والعملة وحدود التاريخ. لا تقارن إيرادات RevenueCat مباشرةً بعائدات App Store Connect قبل مواءمة النطاقات.

احمِ بيانات الاعتماد

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

تابع مع لماذا تختلف إجماليات مزوّدي الخدمة قبل نشر رقم إيرادات مجمّع.

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

هل يمكن لـ AdMate ربط عدة مشاريع RevenueCat؟

نعم. يدعم نموذج الحسابات مشاريع متعددة وبيانات اعتماد للمشاريع. سمِّ كل مشروع وتحقق منه قبل دمج طرق العرض.

هل يكفي مفتاح SDK العام من RevenueCat؟

استخدم نوع بيانات الاعتماد الذي يطلبه إعداد RevenueCat في AdMate. لمفاتيح SDK العامة للتطبيقات وبيانات اعتماد API السرية أغراض مختلفة.

هل يرسل AdMate كل إيرادات الاشتراكات إلى واجهته البرمجية؟

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

ماذا أرسل إلى الدعم؟

أرسل اسم المشروع ونطاق التاريخ والمقياس والخطأ بعد إخفاء البيانات الحساسة. لا ترسل المفتاح السري أبدًا.