RevGlanceالمستندات

App Store

اربط App Store Connect بمفتاح API لقراءة تقارير Sales and Trends اليومية لـ iOS وMac.

يقرأ RevGlance تقارير Sales and Trends اليومية من Apple عبر App Store Connect API. يوفّر ملخّص SALES التطبيقات المدفوعة وعمليات الشراء داخل التطبيق؛ ويوفّر تقرير SUBSCRIBER كل دفعة اشتراك وفترة تجريبية مجانية واسترداد.

الربط

  1. في App Store Connect، افتح Users and Access › Integrations › App Store Connect API وأنشئ مفتاح فريق بدور Finance أو Sales.
  2. دوّن Issuer ID الظاهر فوق قائمة المفاتيح وKey ID الخاص بالمفتاح، ثم نزّل ملف .p8. تسمح Apple بتنزيله مرة واحدة فقط.
  3. اعثر على vendor number ضمن Payments and Financial Reports (أعلى اليسار).
  4. املأ الحقول الأربعة، والصق ملف .p8 كاملًا بما فيه سطرا -----BEGIN PRIVATE KEY-----، ثم اختر ربط App Store.

ما يطلبه النموذج

الحقليبدو مثل
Issuer ID57246542-96fe-1a63-e053-0824d011072a
Key ID2X9R4HXF34
رقم المورّد85012345
المفتاح الخاص (محتوى ملف .p8)مخزّن بتشفير-----BEGIN PRIVATE KEY-----

إضافة Webhook

تصل التقارير متأخرة بيوم تقريبًا. تُبلغ App Store Server Notifications RevGlance لحظة حدوث أي تغيير، فيُجلب التقرير التالي بمجرد توفره.

  1. في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر App Store واختر Webhook.
  2. اختلق سرًّا عشوائيًا طويلًا، والصقه في سرّ التوقيع واحفظ.
  3. انسخ عنوان Webhook وأضف ?token= وسرّك إلى نهايته.
  4. في App Store Connect، افتح App Information لتطبيقك، وضمن App Store Server Notifications اضبط ذلك العنوان كعنوان URL للإنتاج، الإصدار 2.

يتحقق RevGlance من السرّ في العنوان ومن توقيع Apple نفسها، وهو سلسلة شهادات تصل إلى Apple Root CA G3.

ما الذي تتوقعه

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

كيف يُحسب App Store

  • يُحتسب سعر العميل إيرادًا والرسوم هي سعر العميل مطروحًا منه عائداتك، لذا تظهر الضريبة في الأسعار الشاملة للضريبة كرسوم.
  • MRR هو أحدث سعر للعميل، لذا يشمل الضريبة حيث تشملها الأسعار: فتقارير Apple لا تفصل الضريبة. ويُحتسب العرض التمهيدي بسعر العرض، ثم يظهر السعر العادي كتوسّع.
  • يأتي الاسترداد من تقرير Apple بسعر سالب. وحين تلغي Apple استردادًا، يزيل RevGlance أحدث استرداد لذلك المشترك والاشتراك. لا تحدّد Apple أي استرداد أُلغي، لذا مع عدة استردادات على اشتراك واحد قد يُزال الخطأ.
  • الاستردادات المطلوبة بعد أن تعيد Apple تعيين معرّف المشترك (180 يومًا) تُحفظ، لكن بلا عميل.
  • أرصدة حزم التطبيقات (CMB-C) ليست استردادات وتُستبعد.
  • لا تعرض Apple الإلغاءات: ينتهي الاشتراك حين يتأخر التجديد ثلاثة أيام.
  • لا يُبلَّغ عن الدفعات الفاشلة، لذا يبقى هذا الرقم صفرًا.