[Ultimate]{class="badge positive"}

Google PubSub origen

IMPORTANT
El origen Google PubSub está disponible en el catálogo de orígenes para los usuarios que han adquirido Real-time Customer Data Platform Ultimate.

Adobe Experience Platform proporciona conectividad nativa para proveedores de la nube como AWS, Google Cloud Platform y Azure, lo que le permite traer datos de estos sistemas a Platform para usarlos en destinos y servicios descendentes.

Las fuentes de almacenamiento en la nube pueden llevar los datos a Platform sin necesidad de descargarlos, formatearlos o cargarlos. Los datos introducidos pueden tener el formato XDM JSON, XDM Parquet o estar delimitados. Cada paso del proceso se integra en el flujo de trabajo de fuentes. Platform le permite traer datos de Google PubSub en tiempo real.

Requisitos previos prerequisites

Esta sección describe la configuración de requisitos previos que debe completar antes de conectar su cuenta de Google PubSub al Experience Platform.

Crear cuenta de servicio create-service-account

Una cuenta de servicio es un tipo de cuenta que suele usar una aplicación o una carga de trabajo de cálculo, en lugar de una persona. Una cuenta de servicio se identifica mediante su dirección de correo electrónico, que es única para la cuenta.

  • Por un lado, las cuentas de servicio son principales; puede conceder acceso a las cuentas de servicio a Google Cloud recursos. Por ejemplo, puede conceder a una cuenta de servicio la función de administrador de proceso (roles/compute.admin) en un proyecto determinado. Esto permite que la cuenta de servicio pueda administrar los recursos de Compute Engine en ese proyecto en particular.
  • Por otro lado, las cuentas de servicio también son recursos: puede dar a otras entidades principales permiso para acceder a la cuenta de servicio. Por ejemplo, puede conceder a un usuario el rol de usuario de cuenta de servicio (roles/iam.serviceAccountUser) en una cuenta de servicio para que el usuario adjunte esa cuenta de servicio a los recursos. También puede otorgar a un usuario el rol de Administrador de cuenta de servicio (roles/iam.serviceAccountAdmin) para que pueda completar tareas como ver, editar, deshabilitar y eliminar la cuenta de servicio.

Para obtener más información sobre cómo determinar el tipo de autenticación adecuado para su caso de uso, lea la Google guía sobre métodos de autenticación.

Siga los pasos descritos a continuación para crear una cuenta de servicio:

Primero, vaya a la página IAM de Google Developer Console y, a continuación, seleccione Create Service Account.

La ventana Crear cuenta de servicio en Google Developer Console

A continuación, escriba un nombre para mostrar y un identificador para su cuenta de servicio y, a continuación, seleccione Create and Continue.

Los detalles de la cuenta de servicio en Google Developer Console

Generar claves de cuenta de servicio generate-service-account-keys

Para generar claves para la cuenta de servicio, seleccione el encabezado claves en la página cuentas de servicio. Desde allí, seleccione Add key y luego seleccione Create new key en el menú desplegable. También puede utilizar este panel para cargar una clave existente.

La ventana de agregar clave en Google Developer Console

Cuando se realice correctamente, recibirá un mensaje que indica que la clave privada se ha guardado en el equipo y que se descargará un archivo. Puede usar el contenido de este archivo como credenciales al crear su cuenta de Google PubSub en el Experience Platform.

Conceder permisos en los niveles de tema y suscripción grant-permissions

Para conceder permisos en los niveles de tema y suscripción, vaya a la página de consola del tema y seleccione Show info panel. A continuación, en la ficha Permissions, seleccione Add Principal y, a continuación, agregue la entidad de seguridad de la cuenta de servicio junto con los permisos.

Ventana emergente de Google Developer Console donde puede conceder permisos en los niveles de tema y suscripción

Configuraciones para el(la) óptimo(a) Google PubSub usage optimal-configurations

Esta sección describe las configuraciones que se recomienda realizar para optimizar el uso del origen Google PubSub en el Experience Platform.

Propiedades de suscripción subscription-properties

Use Google Developer Console para aumentar el plazo de confirmación. Esto permite que Google Publisher espere según el tiempo configurado antes de volver a enviar el mensaje. Este retraso ayuda a reducir la carga innecesaria en el nivel del suscriptor.

Interfaz de fecha límite de confirmación en Google Developer Console.

Habilitar exactly one delivery. Esta configuración informa a Google Publisher para garantizar que los mensajes enviados a la suscripción no se reenvíen antes de que expire el plazo de confirmación. Puede utilizar esta configuración para asegurarse de que los mensajes de confirmación no se reenvíen a la suscripción.

La página de configuración de envío exacta en Google Developer Console.

Puede habilitar Retry after exponential backoff delay para reducir el riesgo de sobrecargar aún más el servidor. Puede habilitar esta configuración en Google Developer Console para mitigar mejor los errores transitorios (errores temporales que normalmente se resuelven por sí mismos), proporcionando al sistema más tiempo para recuperarse antes de intentar otra conexión.

Ventana de directiva de reintento en Google Developer Console.

Debe establecer la duración de retención de mensajes de suscripción en 24 horas o más para garantizar que los datos no reconocidos no se pierdan durante las cargas máximas. Además, habilite un tema de carta muerta para asegurarse de que la pérdida de datos no se produzca incluso en casos extremos poco frecuentes.

IMPORTANT
Solo puede crear un flujo de datos de origen por cada suscripción de Google PubSub. La reutilización de una suscripción, incluso en entornos limitados, provoca la pérdida de datos.

Conectar Google PubSub al Experience Platform

La siguiente documentación proporciona información sobre cómo conectar Google PubSub a Platform mediante API o la interfaz de usuario:

Uso de API

Uso de la IU

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089