RevGlanceالمستندات

Google Play

اربط Google Play بحساب خدمة يقرأ تقارير Play Console وPlay Developer API.

يقرأ RevGlance تقارير sales وearnings الشهرية في حاوية Cloud Storage الخاصة بـ Play Console، ويستعلم من Play Developer API عن فترات الفوترة والمبالغ المستردة، ومع الإشعارات الفورية، عن الفترات التجريبية والإلغاءات.

الربط

  1. في Google Cloud، أنشئ service account داخل مشروع، وأضف إليه مفتاح JSON ونزّله. فعّل Google Play Android Developer API للمشروع.
  2. في Play Console، افتح Users and permissions، وادعُ البريد الإلكتروني لحساب الخدمة وامنحه صلاحية View financial data لتطبيقك.
  3. انسخ حاوية التقارير من Download reports › Financial: الجزء pubsite_prod_rev_… من عنوان URI في Cloud Storage.
  4. املأ الحاوية، واسم حزمة تطبيقك (com.example.app) ومفتاح JSON كاملًا، ثم اختر ربط Google Play. قد تستغرق الدعوة الجديدة ما يصل إلى يوم حتى تصل إلى التقارير.

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

الحقليبدو مثل
حاوية التقاريرpubsite_prod_rev_01234567890987654321
اسم الحزمةcom.example.app
JSON حساب الخدمةمخزّن بتشفير{ "type": "service_account", … }

يسجّل حساب الخدمة الدخول بصلاحية قراءة فقط إلى Cloud Storage (devstorage.read_only) وإلى Android Publisher API.

إضافة Webhook

بدون الإشعارات، تكون الفترات التجريبية غير مرئية ولا يظهر الإلغاء إلا بعد تأخر التجديد ثلاثة أيام. ومعها، يتعرّف RevGlance على رمز الشراء لكل اشتراك ويستعلم من Play عن حالته الحية.

  1. في RevGlance، افتح الإعدادات › المصادر، وافتح قائمة مصدر Google Play واختر Webhook. احفظ سرًّا عشوائيًا طويلًا في سرّ التوقيع.
  2. في Google Cloud، أنشئ موضوع Pub/Sub واسمح لـ Google Play بالنشر فيه، كما تشرح صفحة Monetization setup في Play Console.
  3. أضف اشتراك push إلى الموضوع. نقطة نهايته هي عنوان Webhook مع ?token= وسرّك في آخره.
  4. في Play Console، افتح Monetization setup، وأدخل الموضوع وأرسل إشعارًا تجريبيًا. يقرّ RevGlance باستلام الإشعارات التجريبية وإشعارات التطبيقات الأخرى دون أن يتصرف بناءً عليها.

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

  • تصل التقارير متأخرة. تنشرها Google بعد ثلاثة إلى سبعة أيام من البيع. تأتي المبيعات أولًا؛ ثم تحلّ الأرباح محلها لاحقًا بما دفعته لك Google.
  • عملاء مجهولون. لا يذكر Play أسماء المشترين. تشترك طلبات الاشتراك الواحد في جذر معرّف (GPA.1234…)، يصبح عميلًا مجهولًا واحدًا. أما عمليات الشراء لمرة واحدة فليس لها عميل.
  • المبالغ المستردة عبر API تمتد إلى 30 يومًا مضت. وتصل المبالغ المستردة الأقدم مع تقرير الأرباح.

كيف يُحسب Google Play

  • تنشر Google التقارير متأخرة من ثلاثة إلى سبعة أيام. تأتي المبيعات أولًا؛ ثم تحلّ الأرباح محلها لاحقًا بما دفعته لك Google بعد رسومها. تُحتسب الدفعات قبل الضريبة.
  • يُحفظ كل سطر استرداد، بما فيها الجزئية. قد يتعارض استردادان جزئيان لطلب واحد موزّعان على تقريرين شهريين، وقد يفوت أحدهما. لا توضّح Google إن كانت الاستردادات سالبة في تقاريرها، لذا تُقرأ كمبالغ مستردة.
  • لا تعود الاستردادات عبر Play API إلا 30 يومًا. أما الأقدم فتصل مع تقرير الأرباح.
  • دون الإشعارات الفورية، لا يظهر الإلغاء إلا كتجديد متأخر ثلاثة أيام، ويُحتسب حين تغطي التقارير ذلك اليوم.
  • تُستبعد عمليات الشراء التجريبية. يبقى الاشتراك المعلّق محتسبًا؛ ويُحتسب الموقوف مؤقتًا تسرّبًا حتى يُستأنف.
  • MRR هو أحدث طلب، قبل الضريبة. ويُحتسب العرض التمهيدي بسعر العرض، ثم يظهر السعر العادي كتوسّع.
  • لا يُبلَّغ عن الدفعات الفاشلة، لذا يبقى هذا الرقم صفرًا.