RevGlanceDocumentación

App Store

Conecta App Store Connect con una clave de API para leer los informes diarios de Sales and Trends de iOS y Mac.

RevGlance lee los informes diarios de Sales and Trends de Apple a través de la App Store Connect API. El resumen SALES da las apps de pago y las compras dentro de la app; el informe SUBSCRIBER da cada cobro de suscripción, prueba gratuita y reembolso.

Conectar

  1. En App Store Connect, abre Users and Access › Integrations › App Store Connect API y genera una clave de equipo con el rol Finance o Sales.
  2. Apunta el Issuer ID que aparece encima de la lista de claves y el Key ID de la clave, y descarga el archivo .p8. Apple solo te deja descargarlo una vez.
  3. Busca tu vendor number en Payments and Financial Reports (arriba a la izquierda).
  4. Rellena los cuatro campos, pegando el archivo .p8 completo, líneas -----BEGIN PRIVATE KEY----- incluidas, y elige Conectar App Store.

Qué pide el formulario

CampoAspecto
Issuer ID57246542-96fe-1a63-e053-0824d011072a
Key ID2X9R4HXF34
Número de proveedor85012345
Clave privada (contenido del .p8)Se guarda cifrado-----BEGIN PRIVATE KEY-----

Añadir el webhook

Los informes llegan con un día de retraso aproximadamente. Las App Store Server Notifications avisan a RevGlance en cuanto algo cambia, así que el siguiente informe se descarga en cuanto existe.

  1. En RevGlance, abre Configuración › Fuentes, abre el menú de la fuente del App Store y elige Webhook.
  2. Inventa un secreto largo y aleatorio, pégalo en Secreto de firma y guarda.
  3. Copia la URL del webhook y añade al final ?token= y tu secreto.
  4. En App Store Connect, abre la App Information de tu app y, en App Store Server Notifications, pon esa dirección como URL de producción, versión 2.

RevGlance comprueba el secreto de la URL y la propia firma de Apple, una cadena de certificados hasta Apple Root CA G3.

Qué esperar

  • Clientes anónimos. Apple no da nombres de compradores. Cada suscriptor se convierte en un cliente con un Subscriber ID anónimo, y los códigos de oferta, los cambios entre grupos de suscripciones y los reinicios de ID pueden parecer suscripciones nuevas.
  • Un año de historial. Los informes diarios llegan hasta un año atrás, y cada día llega con un día de retraso aproximadamente.
  • Las cancelaciones aparecen tarde. Apple no informa de cancelaciones: una suscripción termina cuando su renovación lleva tres días vencida.

Cómo se cuenta el App Store

  • El precio al cliente cuenta como ingreso y la comisión es el precio al cliente menos tus ganancias, así que el impuesto de los precios con impuestos incluidos aparece como comisión.
  • El MRR es el último precio al cliente, así que incluye impuestos donde los precios los incluyen: los informes de Apple no separan el impuesto. Una oferta introductoria cuenta a su precio de oferta, y luego el precio normal aparece como una expansión.
  • Un reembolso llega en el informe de Apple con un precio negativo. Cuando Apple revierte un reembolso, RevGlance quita el último reembolso de ese suscriptor y esa suscripción. Apple no dice qué reembolso se revirtió, así que con varios reembolsos en una suscripción puede quitarse el equivocado.
  • Los reembolsos pedidos después de que Apple restablezca el ID de un suscriptor (180 días) se mantienen, pero sin cliente.
  • Los créditos por paquetes de apps (CMB-C) no son reembolsos y se dejan fuera.
  • Apple no muestra cancelaciones: una suscripción termina cuando una renovación lleva tres días de retraso.
  • Los cobros fallidos no se informan, así que esa cifra se queda en cero.