RevGlanceתיעוד

App Store

לחבר את App Store Connect עם מפתח API כדי לקרוא את דוחות Sales and Trends היומיים עבור iOS ו-Mac.

RevGlance קוראת את דוחות Sales and Trends היומיים של אפל דרך 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. אפל מאפשרת להוריד אותו פעם אחת בלבד.
  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 להגדיר את הכתובת הזו כ-production URL, גרסה 2.

RevGlance בודקת את הסוד שב-URL ואת החתימה של אפל עצמה, שרשרת אישורים עד Apple Root CA G3.

למה לצפות

  • לקוחות אנונימיים. אפל לא מוסרת שמות של קונים. כל מנוי הופך ללקוח אחד עם Subscriber ID אנונימי, וקודי הצעה, שדרוגים בין קבוצות מנויים ואיפוסי מזהה עשויים להיראות כמו מנויים חדשים.
  • שנה של היסטוריה. הדוחות היומיים מגיעים שנה אחורה, וכל יום מגיע באיחור של כיום.
  • ביטולים מופיעים באיחור. אפל לא מדווחת על ביטולים: מנוי מסתיים כשהחידוש שלו מאחר בשלושה ימים.

איך ה-App Store נספר

  • מחיר הלקוח נספר כהכנסה, והעמלה היא מחיר הלקוח פחות התמורה שלך, כך שמס במחירים שכוללים מס מופיע כעמלה.
  • ה-MRR הוא מחיר הלקוח האחרון, ולכן הוא כולל מס היכן שהמחירים כוללים: הדוחות של Apple לא מפרידים את המס. מבצע היכרות נספר במחיר המבצע, והמחיר הרגיל מופיע אחר כך כהרחבה.
  • החזר מגיע מהדוח של Apple עם מחיר שלילי. כש-Apple מבטלת החזר, RevGlance מסיר את ההחזר האחרון של אותו מנוי ואותו מנוי. Apple לא מציינת איזה החזר בוטל, ולכן כשיש כמה החזרים על מנוי אחד, ייתכן שיוסר ההחזר הלא נכון.
  • החזרים שהתבקשו אחרי ש-Apple מאפסת את המזהה של מנוי (180 ימים) נשמרים, אבל בלי לקוח.
  • זיכויים על חבילות אפליקציות (CMB-C) אינם החזרים ולא נכללים.
  • Apple לא מציגה ביטולים: מנוי מסתיים כשחידוש מאחר בשלושה ימים.
  • אין דיווח על חיובים שנכשלו, ולכן הנתון הזה נשאר אפס.