Inscripción a programas de lealtad de usuarios

La función de inscripción en el programa de lealtad y de acceso permite que los usuarios busquen tu y unirte a la cuenta o acceder a ella desde la Billetera de Google. Se redireccionará a los usuarios a tu sitio web optimizado para dispositivos móviles para que completen la después del cual pueden agregar su tarjeta a la Billetera de Google.

En esta guía, se proporciona una descripción general de los pasos de implementación necesarios para habilitar tu programa de lealtad para esta función.

Descripción general

Para comenzar, asegúrate de haber configurado tu proyecto anteriormente y de tener acceso a API de la Billetera de Google

Debes seguir estos cuatro pasos para implementar la función de inscripción y acceso. para tu programa de lealtad:

1. Configura una clase de prueba en la Billetera de Google para probar los flujos de inscripción o acceso.
2. Desarrolla páginas de inscripción o de acceso que utilicen SharedDataType de la Billetera de Google.
3. Implementa el rechazo de la tarjeta de lealtad en la Billetera de Google después de la inscripción o el acceso.
4. Solicitar verificación y activación

Configura una clase de prueba en la Billetera de Google

Determina las URLs de inscripción y acceso, el logotipo de tu programa y los campos de usuario elegidos. Luego, usa los campos anidados discoverableProgram en la loyaltyclass para establecer valores adecuados.

Establece los valores en discoverableProgram para crear una versión en borrador de tu programa de lealtad con inscripción o acceso. Para asegurarte de que los verificadores puedan ver esta información, verifica lo siguiente: los verificadores tendrán acceso a la Consola de Google Pay y la Billetera de Google. Para obtener detalles sobre cómo compartir tu el acceso de Google Pay y la Consola de la Billetera de Google con otras personas, consulta Obtén información sobre la página Usuarios.

Para completar la verificación de la funcionalidad de la implementación durante el desarrollo comunícate con nosotros a través del widget de asistencia que se encuentra en la Consola de Google Pay y la Billetera de Google. Mientras estás en la consola, selecciona API de la Billetera de Google en el tema y selecciona Inscripción/acceso en el programa de lealtad en del subtema.

Desarrolla páginas de inscripción y acceso que usan datos del usuario de la Billetera de Google

Cuando un usuario elige acceder a tu programa de lealtad o inscribirse en él, se los dirigirá a una página personalizada en tu sitio web para completar el proceso de inscripción o acceso. Si un usuario elige inscribirse, la Billetera de Google se le solicitará al usuario que apruebe el uso compartido de sus datos de usuario contigo.

Debes proporcionar una de las dos páginas, o ambas, que permiten a los usuarios completar estas acciones.

1. Es una URL de acceso en la que los usuarios pueden acceder a una cuenta existente.
2. Una URL de inscripción en la que un usuario puede crear una cuenta nueva.

Las páginas de acceso e inscripción deben cumplir con los siguientes requisitos:

• Brinda una experiencia del usuario optimizada para dispositivos móviles.
• Minimiza la cantidad de campos obligatorios durante el proceso de inscripción.
• Permite que el usuario complete el acceso o la inscripción en una sola página.
• Usa la encriptación de HTTPS con un certificado válido para garantizar que los datos del usuario se transmitirse de forma segura.
• Garantiza, al menos, un tiempo de actividad del 99.9% de tus páginas de inscripción y acceso.

Además de los requisitos anteriores, te recomendamos que permitas a los usuarios para inscribirte en tu programa de lealtad sin tener que completar ningún formulario o y dejar la página solo para aceptar las condiciones del servicio.

• Si aprovechas los datos del usuario que se proporcionan en el SharedDataType, podrás crear una cuenta y rechazar de inmediato su tarjeta de lealtad.
• Luego, puedes enviar por correo electrónico al usuario una contraseña de un solo uso o un vínculo para configurar su contraseña y detalles opcionales de la cuenta.
• Esto reduce la posibilidad de que los usuarios abandonen el proceso de inscripción. ya que cada paso adicional puede generar abandonos adicionales.

Al presentar la página de acceso o inscripción, Google Wallet creará se realiza una WebView de Android y se realiza una solicitud POST a la URL. Los datos del usuario se proporcionan en el parámetro SharedDataType. que se incluye en la solicitud POST mediante el application/x-www-form-urlencoded y Codificación UTF-8 El valor de SharedDataType es un objeto JSON codificado en Base64.

Nota: La cadena JSON primero se codifica en UTF-8 y, luego, codificada con android.util.Base64 con las opciones NO_WRAP y URL_SAFE. Esto se corresponde con RFC 3548 sección 4.

Según la acción que elija el usuario y los campos que especifiques para solicitar al usuario, el objeto JSON puede contener los siguientes campos.

Campo	Inscripción
correo electrónico	✓
firstName	✓
lastName	✓
Línea de dirección [1-3]	✓
city	✓
state	✓
zipcode	✓
country	✓
teléfono	✓

Nota: Ninguno de los campos contenido garantizado, y tu sitio debe permitir que el usuario continúa si uno o más campos no están presentes.

Nota: Si le solicitas un campo a un usuario, asegúrate de que estos detalles se usen para prepropagar el formulario.

Consulta lo siguiente para obtener un objeto JSON de muestra decodificado incluido en el SharedDataType.

Recurso

{
  "firstName": "Jane",
  "lastName": "Doe",
  "addressLine1": "1600 Amphitheatre Pkwy",
  "addressLine2": "Apt 123",
  "addressLine3": "Attn:Jane",
  "city": "Mountain View",
  "state": "CA",
  "zipcode": "94043",
  "country": "US",
  "email": "[e-mail]",
  "phone": "555-555-5555"
}

Implementa el rechazo inmediato de la tarjeta de lealtad en la Billetera de Google

Una vez que se autentique (acceso) o después de que se cree una cuenta (inscripción), tu página debe rechazar de inmediato la tarjeta de lealtad del usuario a la Billetera de Google.

Nota: No implementes un botón de la API de la Billetera de Google. ya que los usuarios deben regresar a la Billetera de Google sin interacción adicional.

Puedes rechazar la tarjeta de lealtad a la Billetera de Google si redireccionas a un que sigue la estructura que se muestra a continuación.

https://pay.google.com/gp/v/save/{jwt_generated}

Nota: Asegúrate de hacer lo siguiente: incluye la "/" al final en la URL antes del JWT.

Nota: Los JWT no están encriptados. Solo incluir datos en el vínculo directo que se pueden compartir como texto sin formato.

La longitud segura de una URL es de 2,000 caracteres. Los vínculos deben permanezcan por debajo de este límite. Los objetos codificados en JWT deben ser pequeños y contener solo datos que son específicos del usuario. Intenta conservar la mayoría de los datos en la clase del objeto. crearlo antes de crear el JWT. Para objetos más grandes que no se ajusten al límite, considera crear primero el objeto en la API de Google Wallet y enviar solo el ID de objeto en JWT.

Flujo de comunicación típico

El flujo de comunicación para un usuario que completa la inscripción o el acceso se ilustra en el siguiente imagen. Todas las acciones entre "Tu servidor" y es tu responsabilidad implementarlas.

Solicitar verificación y activación

Después de que completes el trabajo de desarrollo y pruebes tus flujos de inscripción o acceso, envía una solicitud. mediante la Comunícate con el equipo de asistencia de Google Pay y la Billetera de la Billetera widget.

Después de una revisión completa de la implementación para confirmar que la funcionalidad sea correcta en en combinación con la app de la Billetera de Google, la función de inscripción y de acceso en el programa de lealtad se para tu programa de lealtad. Esto permitirá que cualquier usuario vea el programa y aprovechar esa funcionalidad.

Para garantizar una experiencia del usuario óptima, se deben realizar verificaciones recurrentes de tu inscripción o acceso. implementación se realizará para garantizar el cumplimiento permanente de los requisitos de las funciones. Se te notificará en caso de discrepancias y la función de acceso o inscripción. pueden inhabilitarse hasta que se resuelva el problema.

Preguntas frecuentes

• ¿Hay algún requisito para las imágenes que se usan en mi programa de lealtad?
  • Sí, sus imágenes deben alojarse en HTTPS ubicación ya que, de lo contrario, no aparecerán en la Billetera de Google.
• ¿Existe alguna herramienta que simplifique la implementación y depuración de los JWT?
  • Sí, plataformas como www.jwt.io te permiten decodificar y depurar los tokens durante el proceso de desarrollo, lo que te permite verificar el el contenido que envías. Ten en cuenta que Google no tiene afiliación ni recomendar específicamente cualquiera de dichos terceros.
• ¿Cómo se manejan correctamente los datos de SharedDataType codificados en Base64?
  • Asegúrate de usar la codificación UTF-8 durante todo el proceso. La cadena JSON primero se codifica en UTF-8 y, luego, se codifica con android.util.Base64 con las opciones NO_WRAP y URL_SAFE. Esto se corresponde con Sección 4 de RFC 3548.