Google Play

לחבר את Google Play עם service account שקורא את דוחות ה-Play Console ואת Play Developer API.

RevGlance קוראת את דוחות ה-sales וה-earnings החודשיים ב-bucket של Cloud Storage של ה-Play Console, ושואלת את Play Developer API על תקופות חיוב, החזרים, ובעזרת התראות בזמן אמת גם על תקופות ניסיון וביטולים.

חיבור

ב-Google Cloud, ליצור service account בפרויקט, להוסיף לו מפתח JSON ולהוריד אותו. להפעיל את Google Play Android Developer API עבור הפרויקט.
ב-Play Console, לפתוח את Users and permissions, להזמין את כתובת האימייל של ה-service account ולתת לו View financial data עבור האפליקציה.
להעתיק את ה-bucket של הדוחות מתוך Download reports › Financial: החלק pubsite_prod_rev_… של ה-URI ב-Cloud Storage.
למלא את ה-bucket, את שם החבילה של האפליקציה (com.example.app) ואת כל מפתח ה-JSON, ואז לבחור חיבור Google Play. הזמנה חדשה עשויה לקחת עד יום עד שתגיע לדוחות.

מה הטופס מבקש

שדה	נראה כך
bucket של דוחות	`pubsite_prod_rev_01234567890987654321`
שם החבילה	`com.example.app`
JSON של חשבון השירותנשמר מוצפן	`{ "type": "service_account", … }`

ה-service account מתחבר עם גישת קריאה בלבד ל-Cloud Storage (devstorage.read_only) ול-Android Publisher API.

הוספת ה-webhook

בלי ההתראות האלה, תקופות ניסיון לא נראות וביטול מופיע רק כשחידוש מאחר בשלושה ימים. איתן, RevGlance לומדת את ה-purchase token של כל מנוי ושואלת את Play על המצב העדכני שלו.

ב-RevGlance, לפתוח את הגדרות › מקורות, לפתוח את התפריט של מקור ה-Google Play ולבחור Webhook. לשמור סוד אקראי ארוך תחת סוד חתימה.
ב-Google Cloud, ליצור topic של Pub/Sub ולאפשר ל-Google Play לפרסם אליו, כפי שמוסבר בעמוד Monetization setup של Play Console.
להוסיף ל-topic מנוי מסוג push. נקודת הקצה שלו היא כתובת ה-webhook עם ?token= והסוד בסופה.
ב-Play Console, לפתוח את Monetization setup, להזין את ה-topic ולשלוח התראת בדיקה. RevGlance מאשרת קבלה של בדיקות ושל התראות עבור אפליקציות אחרות בלי לפעול לפיהן.

למה לצפות

הדוחות מגיעים באיחור. Google מפרסמת אותם שלושה עד שבעה ימים אחרי המכירה. המכירות מגיעות קודם; הרווחים מחליפים אותן מאוחר יותר במה ש-Google שילמה לך בפועל.
לקוחות אנונימיים. Play לא מוסרת שמות של קונים. ההזמנות של מנוי אחד חולקות שורש מזהה (GPA.1234…), שהופך ללקוח אנונימי אחד. לרכישות חד-פעמיות אין לקוח.
החזרים דרך ה-API מגיעים 30 יום אחורה. החזרים ישנים יותר מגיעים עם דוח הרווחים.

איך Google Play נספרת

Google מפרסמת דוחות באיחור של שלושה עד שבעה ימים. המכירות מגיעות קודם; הרווחים מחליפים אותן מאוחר יותר במה ש-Google שילמה לך, אחרי העמלה שלה. חיובים נספרים לפני מס.
כל שורת החזר נשמרת, גם חלקיות. שני החזרים חלקיים של הזמנה אחת שמתפרסים על פני שני דוחות חודשיים עלולים להתנגש, ואחד מהם עלול להתפספס. Google לא מציינת אם ההחזרים בדוחות שלה שליליים, ולכן הם נקראים כסכומים שהוחזרו.
החזרים דרך Play API מגיעים רק 30 ימים אחורה. החזרים ישנים יותר מגיעים עם דוח הרווחים.
בלי התראות בזמן אמת, ביטול מופיע רק כחידוש שמאחר בשלושה ימים, ונספר ברגע שהדוחות מכסים את אותו יום.
רכישות בדיקה לא נכללות. מנוי בהמתנה (on hold) ממשיך להיספר; מנוי מושהה נספר כנטישה עד שהוא מתחדש.
ה-MRR הוא ההזמנה האחרונה, לפני מס. מבצע היכרות נספר במחיר המבצע, והמחיר הרגיל מופיע אחר כך כהרחבה.
אין דיווח על חיובים שנכשלו, ולכן הנתון הזה נשאר אפס.