[Ultimate]{class="badge positive"}

Google PubSub origen

IMPORTANT
El Google PubSub La fuente de está disponible en el catálogo de fuentes de para los usuarios que han adquirido Real-time Customer Data Platform Ultimate.

Adobe Experience Platform proporciona conectividad nativa para proveedores en la nube como AWS, Google Cloud Platform, y Azure, lo que le permite introducir datos de estos sistemas en Platform para utilizarlos en servicios y destinos 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 introducir 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 Google PubSub cuenta para el Experience Platform.

Crear cuenta de servicio create-service-account

A cuenta de servicio es un tipo de cuenta que a menudo utiliza una aplicación o una carga de trabajo informática, 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 otorgar 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 otorgar a un usuario la función Usuario de cuenta de servicio (roles/iam.serviceAccountUser) en una cuenta de servicio para permitir que el usuario adjunte esa cuenta de servicio a los recursos. También puede otorgar a un usuario la función Administrador de cuentas de servicio (roles/iam.serviceAccountAdmin) para permitir que el usuario complete 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 de métodos de autenticación.

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

En primer lugar, vaya a IAM página de la Google Developer Console y luego seleccione Create Service Account.

La ventana Crear cuenta de servicio de Google Developer Console

A continuación, introduzca un nombre para mostrar y un ID para la 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 Añadir 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. A continuación, puede utilizar el contenido de este archivo como credenciales al crear su Google PubSub cuenta 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, debajo de Permissions pestaña, seleccione Add Principal y, a continuación, agregue el principal 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 una optimización óptima Google PubSub usage optimal-configurations

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

Propiedades de suscripción subscription-properties

Utilice el Google Developer Console hasta aumentar el plazo de confirmación. Esto permite que Google Publisher para esperar 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.

Activar exactly one delivery. Esta configuración informa a la Google Publisher para garantizar que los mensajes enviados a la suscripción no se vuelvan a enviar antes de que caduque 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 activar Retry after exponential backoff delay para reducir el riesgo de sobrecargar aún más el servidor. Puede habilitar esta configuración en la variable 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.

La ventana de directiva Reintentar en Google Developer Console.

Usted debe establezca una duración de retención de mensaje de suscripción de 24 horas o más para garantizar que los datos no reconocidos no se pierdan durante las cargas máximas. Además, habilitar un tema de carta muerta para garantizar que la pérdida de datos no se produzca incluso durante casos excepcionales.

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

Connect Google PubSub al Experience Platform

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

Uso de API

Uso de la IU

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