سجل المزامنة

لكل مصدر يُزامَن سجل مزامنة خاص به: حالته الآن وسجل بكل مزامنة خلال آخر 90 يومًا. راجعه عندما يبدو رقم قديمًا أو يبدو أن Webhook لا يعمل.

أين تجده

• في الإعدادات › المصادر، افتح قائمة "…" الخاصة بالمصدر واختر سجل المزامنة.
• في حالة المزامنة أسفل الصفحة، اختر سجل المزامنة تحت المصدر.

لا يتوفر إلا للمصادر التي تُزامَن، ولذلك لا يتوفر للبيانات النموذجية.

الحالة الصحية

تعرض هذه البطاقة حال المصدر الآن.

• الحالة تكون محدَّثة أو جارٍ المزامنة أو متأخرة عن الجدول أو فشل. تعني متأخرة عن الجدول أن آخر مزامنة مضى عليها أكثر من ساعتين، أو أن مزامنة فاشلة تنتظر محاولتها التالية. ويعني فشل أن لدى المصدر خطأً معروضًا تحت هذه الحقول. وتُحتسب كذلك المزامنة التي انتهت بـقراءة جزئية. ويبقى الخطأ إلى أن تقرأ مزامنة لاحقة كل شيء.
• آخر مزامنة هي آخر مرة أنهى فيها RevGlance قراءة المصدر. والمزامنة التي أوقفها خطأ لا تغيّرها.
• أحدث البيانات هي تاريخ آخر دفعة أو تغيير في الاشتراك لدى RevGlance من هذا المصدر.
• يبيّن Webhook ما إذا كانت استدعاءات المزوّد تصل. راجع حالة Webhook.

عند انتهاء الفترة التجريبية تذكر البطاقة ذلك، وتنتظر المزامنات الجديدة إلى أن تشتري RevGlance.

لماذا قد تكون أحدث البيانات أقدم من آخر مزامنة

تبيّن آخر مزامنة متى قرأ RevGlance المصدر. وتبيّن أحدث البيانات مدى حداثة البيانات التي وجدها. قد تنجح المزامنة دون أن تجد شيئًا أحدث:

• App Store: تصل تقارير Apple متأخرة بنحو يوم.
• Google Play: تنشر Google تقاريرها خلال 3 إلى 7 أيام.
• أي مزوّد: لم يحدث شيء. فترة هادئة بلا مدفوعات أو تغييرات في الاشتراكات تترك التاريخ كما هو.

ما الذي يبدأ المزامنة

يبيّن كل سطر في سجل المزامنات ما الذي بدأها:

لا تنتظر في قائمة الانتظار إلا مزامنة واحدة لكل مصدر في الوقت نفسه. وأي استدعاء Webhook يصل أثناء ذلك ينضم إليها، لذا قد ترى أسطر Webhook أقل من عدد الاستدعاءات.

كيفية قراءة السجل

تأتي أحدث مزامنة أولًا. يبيّن كل سطر متى بدأت وما الذي بدأها، والمدة التي استغرقتها إن كانت مزامنة واحدة.

الأعداد

لكل نوع من السجلات غيّرته المزامنة أعداده الخاصة: المدفوعات وتغييرات الاشتراكات والعملاء والفترات التجريبية والإلغاءات. ولا يظهر العدد إذا كان صفرًا.

• تمت إضافة 3: سجلات أضافتها هذه المزامنة.
• تم تحديث 2: سجلات كانت لدى RevGlance وغيّرتها هذه المزامنة.
• تمت إزالة 4: سجلات لم تعد موجودة بعد هذه المزامنة.

تعني لا تغييرات أن المزامنة لم تجد ما تفعله. والمزامنات المتتالية التي بلا تغييرات وبدأت بالطريقة نفسها تُطوى في سطر واحد يبيّن عددها وإلى أي مدى تعود. وهكذا لا تطغى المزامنة كل ساعة على المزامنات المهمة.

عندما تواجه المزامنة مشكلة

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

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

الأرقام المصححة

تُدرج هنا الأرقام المسجلة التي صحّحتها المزامنة، مع القيمة القديمة والجديدة. والتصحيح ليس أمرًا فعله عميل.

• بعد إعادة قراءة كاملة: أي إجمالي تغيّر، مثل MRR أو المبالغ المستردة أو الرسوم.
• MRR لاشتراك: صُحّح المبلغ المسجل لاشتراك واحد.
• تاريخ إلغاء: يختلف تاريخ الإلغاء لدى المزوّد عن التاريخ المسجل.

يدرج السطر خمسة على الأكثر، ثم و3 أخرى.

حالة Webhook

يرى المالكون والمسؤولون حالة Webhook في الحالة الصحية. وقد تكون واحدة من أربع:

• آخر استدعاء تم استلامه مع الوقت: الاستدعاءات تصل. لا حاجة إلى فعل شيء.
• تم الإعداد، لكن لم يصل أي استدعاء بعد. المصدر جاهز، لكن المزوّد لم يستدعِه بعد. تحقّق من إضافة Webhook لدى المزوّد. لا تأتي الاستدعاءات إلا عند حدوث تغيير، لذا قد يبقى المصدر الهادئ على هذه الحال مدة.
• غير معد، لذا تنتظر البيانات الجديدة المزامنة المجدولة التالية. لا يوجد سرّ محفوظ. تصل البيانات الجديدة مع المزامنة كل ساعة أو كل يوم إلى أن تضيف Webhook.
• يتم رفض الاستدعاءات مع وقت آخرها: يصل المزوّد إلى RevGlance، لكن استدعاءاته لا تجتاز التحقق، فلا تبدأ أي مزامنة.

في كل الحالات عدا الأولى، تربط البطاقة بالدليل خطوة بخطوة الخاص بمزوّدك.

عندما تُرفض الاستدعاءات

يظهر التحذير بعد 3 استدعاءات مرفوضة متتالية، لذا لا يُطلقه استدعاء عابر واحد. وعندها تظهر تم رفض Webhook أيضًا في صف المصدر في الإعدادات › المصادر. يتوقف ما تتحقق منه على طريقة تحقق المزوّد من استدعاءاته:

• Stripe, Polar, Lemon Squeezy, Paddle, Recurly: انسخ سرّ التوقيع من المزوّد مجددًا والصقه في سرّ التوقيع في لوحة Webhook الخاصة بالمصدر.
• Gumroad, App Store, Google Play, Chargebee: تأكد من أن ?token= في العنوان لدى المزوّد يطابق السرّ المحفوظ في سرّ التوقيع، أو احفظ سرًّا جديدًا وحدّث العنوان.
• Braintree, Shopify: لا يوجد سرّ للصقه. تحقّق من إضافة Webhook في حساب Braintree أو تطبيق Shopify نفسه الذي يتصل به المصدر.

تُرفض أيضًا الاستدعاءات الموجهة إلى مصدر لا سرّ محفوظ له. وحفظ السرّ يحل ذلك.

يزول التحذير عند الاستدعاء السليم التالي أو عند حفظ سرّ جديد. وإذا ظل السرّ خاطئًا يعود بعد 3 استدعاءات مرفوضة أخرى. ويزول أيضًا بعد 7 أيام من آخر استدعاء مرفوض.

مدة الاحتفاظ به

تبقى كل مزامنة في السجل 90 يومًا، ثم تُحذف. وإزالة المصدر تزيل سجل المزامنة الخاص به أيضًا.

من يرى ماذا

يمكن لكل من في النشاط التجاري فتح سجل مزامنة المصدر وقراءة الحالة الصحية وسجل المزامنات. لا يرى المُشاهدون حالة Webhook: لا حقل Webhook ولا شارة ولا عنصر قائمة. وبدء المزامنة وحفظ السرّ متاحان للمالكين والمسؤولين فقط. راجع الفريق والأدوار.