Requisitos para la integración

Antes de comenzar la integración, descarga la Lista de tareas de integración y control de calidad, que es útil tener a mano cuando planificas un proyecto de integración de Suscríbete con Google. La lista de tareas incluye un desglose detallado de todos los componentes y tareas de SwG a los que se puede hacer referencia en todo el proceso de integración de SwG.

Descripción general

El proceso de integración de SwG consta de los siguientes componentes, cada uno de los cuales es un requisito del sistema de SwG. En determinadas situaciones, es posible que un editor no use un componente en particular. Esos casos se detallan en la descripción del componente.

  1. Cuenta de desarrollador de Google Play: El editor debe crear una cuenta de desarrollador de Google Play, subir una aplicación y habilitarla para la facturación. El editor debe publicar la aplicación en producción o usar una aplicación de producción existente.
  2. Configuración de la publicación: El editor debe trabajar con los representantes de soluciones técnicas de Google para establecer determinados puntos de configuración. Estos elementos incluyen las URL de los extremos de API obligatorios, los activos o el logotipo de la marca, los detalles de SKU, la URL de la Política de Privacidad y otros datos que Google requiere para configurar la integración. Esta configuración se debe realizar por publicación integrada.
  3. Lenguaje de marcado de la página: El editor debe agregar datos estructurados a todas las páginas de artículos. Estos datos constan de un ID de publicación (correspondiente al ID de los ajustes de la publicación) y una etiqueta de derechos. Deben figurar en todas las páginas de artículos, incluidos los documentos de AMP.
  4. Integración del cliente de SwG.js: El editor debe integrar el cliente de JavaScript de Google en el sitio web de su publicación. El editor debe incluir la biblioteca cliente de swg.js en todas las páginas de artículos en las que se puede activar un muro de pago, incluidos los artículos que forman parte de una implementación de muro de pago del servidor, y debe llamar a la función getEntitlements de SwG.js y procesar su respuesta como corresponda.

    En la medida en que el editor cree versiones de AMP de sus páginas y estas activen potencialmente muros de pago, las páginas de AMP deben estar configuradas para AMP-subscriptions-google a fin de que se respeten los derechos del usuario de SwG.

  5. Google Noticias: Si el editor proporciona acceso a contenido que representa en el producto de Google Noticias, debe actualizar la configuración de Google Noticias para que sea compatible con SwG. Esto significa que los SKU que vende allí funcionarán en los productos de su propiedad y administración, y las suscripciones que podría vender en otro lugar (ya sea mediante su propio flujo de compra o el de SwG) se pueden reconocer y aplicar en Google Noticias. En la medida en que el editor quiera usar documentos de AMP en el contexto de Google Noticias, debe configurarlos para que usen AMP-subscriptions-google a fin de que se reconozcan correctamente los derechos del usuario.

  6. Integración de Android: En la medida en que el editor venda conjuntos diferentes de SKU en Android y en la Web, o en el caso de que tenga varias apps para la misma publicación, debe actualizar sus aplicaciones para Android a fin de verificar la compra de la suscripción, así como llamar a la API de Subscribe with Google Publication y otorgar el acceso correspondiente.
  7. Acceso con Google: El editor debe incluir la opción de Acceso con Google en todas las páginas de acceso de las aplicaciones para iOS y Android, así como de la Web.

    Esta implementación de Acceso con Google debe revisar la API de Subscribe with Google Publication para garantizar que si la Cuenta de Google ya tiene un derecho vinculado con el editor, la cuenta se asociará con la cuenta existente del usuario en el sitio del editor. En el sitio web del editor, si la API de Subscribe with Google Publication indica que el usuario tiene un derecho que el editor no reconoce, este proporcionará el acceso adecuado a los usuarios conocidos y, en el caso en el que no se reconozca el usuario, lanzará un flujo de creación diferida de la cuenta.

    Si el producto web o de una aplicación para dispositivos móviles del editor proporciona una experiencia completamente gratuita y no dirige al usuario a un muro de pago, no se requiere el Acceso con Google. Asimismo, si el editor no mantiene un sistema de administración de usuarios (es decir, depende completamente de Suscríbete con Google para procesar transacciones de usuarios), no es necesario integrar Acceso con Google (además, no es posible).

  8. Controlador para crear cuentas después de compras: Los editores deben crear cuentas para los usuarios luego de que realicen una compra.

    En la Web, un editor debe poder pasar datos de derechos y eventos de suscripción de swg.js a la infraestructura del editor. Para las compras que se hacen en Google Noticias y a través de la Facturación integrada de Android, el editor debe usar el flujo de creación diferida de la cuenta en su sitio web mediante swg.js cuando esos usuarios lo visitan.

    En el caso de las compras de AMP, si un editor implementa un flujo de compra en AMP, debe suscribirse a eventos de Cloud Pub/Sub de Play en la infraestructura del editor.

    El editor debe usar los datos de compra de los eventos de suscripción para solicitar la información de perfil y de suscripción del usuario a la API de Subscription Status de Google. Luego de obtener esos datos, la API de Account Management debe cumplir con alguno de los siguientes requisitos:

    1. Crear una cuenta con la información de perfil del usuario que proporciona Google y asociar la suscripción a ella
    2. Adjuntar los datos de suscripción y de perfil del usuario de Google a una cuenta existente en el sitio del editor

    Si el editor no mantiene un sistema de administración de usuarios (es decir, depende completamente de Suscríbete con Google para procesar transacciones de usuarios), no es necesario crear una cuenta después de la compra (además, no es posible).

  9. Página de vínculo de cuenta de OAuth: El editor debe crear una página de acceso de OAuth para facilitar el siguiente proceso:

    1. Autenticación de los usuarios existentes del editor
    2. Verificación de los derechos de los usuarios
    3. Creación de un token de acceso de usuarios
    4. Redireccionamiento y pase del token de acceso a la página de referencia

    Si el editor no mantiene un sistema de administración de usuarios (es decir, depende completamente de Suscríbete con Google para procesar transacciones de usuarios), no es necesario tener una página de vínculo de cuenta de OAuth (además, no es posible).

  10. API de Entitlements: El editor debe crear una API de derechos que acepte un token de acceso creado mediante el flujo de vinculación de cuentas de OAuth para editores y que responda con los derechos del usuario. Estos derechos se representan como un conjunto de etiquetas a las que el usuario tiene acceso y, opcionalmente, un descriptor de texto del producto que compró el usuario.

    Si el editor no mantiene un sistema de administración de usuarios (es decir, depende completamente de Suscríbete con Google para procesar transacciones de usuarios), no es necesario tener una API de Entitlements (ni es posible).

  11. Mensaje de acceso automático: Si la API de Entitlements de Google muestra el derecho de un usuario que es conocido para el editor, pero el usuario no accedió al sistema del editor, recomendamos que se registre al usuario automáticamente en su cuenta del sitio. El editor puede usar las funciones de acceso automático de swg.js para avisar al usuario sobre este evento o pedirle que habilite la acción de acceso antes de llevarla a cabo.
  12. Integración de iOS: Si el editor tiene contenido de paga asociado a un SKU de Suscríbete con Google en una app para iOS, después del Acceso con Google, el editor debe revisar su backend en caso de que el usuario tenga algún derecho; si no se encuentra ninguno, debe llamar a la API de Subscribe with Google Publication para comprobar si tiene derechos y, en ese caso, otorgar acceso.
  13. Guardado de la suscripción: Al final de cualquier flujo de compra que no se haga a través de Suscríbete con Google, el editor debe integrar la función para guardar suscripciones a fin de que los usuarios tengan la opción de vincular su Cuenta de Google.