[Ultimate]{class="badge positive"}

Source Google PubSub

IMPORTANT
La variable Google PubSub source est disponible dans le catalogue des sources pour les utilisateurs qui ont acheté Real-time Customer Data Platform Ultimate.

Adobe Experience Platform fournit une connectivité native aux fournisseurs de cloud tels que AWS, Google Cloud Platform et Azure, ce qui vous permet d’importer des données de ces systèmes dans Platform pour les utiliser dans des services et des destinations en aval.

Les sources de stockage dans le cloud peuvent introduire vos propres données dans Platform sans avoir à les télécharger, les formater ou les transférer. Les données ingérées peuvent être formatées sous la forme XDM JSON, XDM Parquet ou délimitées. Chaque étape du processus est intégrée dans le processus Sources. Platform vous permet d’importer des données depuis Google PubSub en temps réel.

Conditions préalables prerequisites

Cette section décrit la configuration prérequise que vous devez effectuer avant de connecter votre Google PubSub compte à Experience Platform.

Créer un compte de service create-service-account

A compte de service est un type de compte souvent utilisé par une application ou une charge de travail calculée, plutôt qu’une personne. Un compte de service est identifié par son adresse électronique, qui est propre au compte.

  • D’une part, les comptes de service sont principals - vous pouvez accorder aux comptes de service l’accès à Google Cloud ressources. Par exemple, vous pouvez accorder à un compte de service le rôle d’administrateur de calcul (roles/compute.admin) sur un projet donné. Cela permet ensuite au compte de service de gérer les ressources du moteur de calcul dans ce projet particulier.
  • D’un autre côté, les comptes de service sont également des ressources. Vous pouvez autoriser d’autres entités à accéder au compte de service. Par exemple, vous pouvez accorder à un utilisateur le rôle Utilisateur du compte de service (roles/iam.serviceAccountUser) sur un compte de service pour permettre à l’utilisateur de joindre ce compte de service à des ressources. Vous pouvez également accorder à un utilisateur le rôle d’ administrateur de compte de service . (roles/iam.serviceAccountAdmin) pour permettre à l’utilisateur d’exécuter des tâches telles que l’affichage, la modification, la désactivation et la suppression du compte de service.

Pour plus d’informations sur la détermination du type d’authentification approprié à votre cas d’utilisation, consultez la section Google guide sur les méthodes d’authentification.

Pour créer un compte de service, procédez comme suit :

Tout d’abord, accédez au IAM de la page Google Developer Console puis sélectionnez Create Service Account.

Fenêtre de création de compte de service dans Google Developer Console

Ensuite, saisissez un nom d’affichage et un identifiant pour votre compte de service, puis sélectionnez Create and Continue.

Détails du compte de service dans Google Developer Console

Génération des clés de compte de service generate-service-account-keys

Pour générer les clés de votre compte de service, sélectionnez l’en-tête keys dans la page des comptes de service. À partir de là, sélectionnez Add key puis sélectionnez Create new key dans le menu déroulant. Vous pouvez également utiliser ce panneau pour charger une clé existante.

Fenêtre d’ajout de clé dans Google Developer Console

En cas de réussite, vous recevrez un message indiquant que la clé privée a été enregistrée sur votre ordinateur et qu’un fichier sera téléchargé. Vous pouvez ensuite utiliser le contenu de ce fichier comme informations d’identification lors de la création de votre Google PubSub sur Experience Platform.

Octroi d’autorisations au niveau des rubriques et des abonnements grant-permissions

Pour accorder des autorisations au niveau de la rubrique et de l’abonnement, accédez à la page de la console de rubrique, puis sélectionnez Show info panel. Ensuite, sous Permissions onglet, sélectionnez Add Principal puis ajoutez l’entité de compte de service avec les autorisations.

Fenêtre contextuelle de la console de développement Google dans laquelle vous pouvez accorder des autorisations au niveau de la rubrique et de l’abonnement.

Configurations optimales Google PubSub usage optimal-configurations

Cette section décrit les configurations que vous devez effectuer pour optimiser l’utilisation de la variable Google PubSub source sur Experience Platform.

Propriétés de l'abonnement subscription-properties

Utilisez la variable Google Developer Console to augmenter le délai d’accusé de réception ;. Cela permet à la variable Google Publisher d’attendre en fonction de l’heure que vous configurez avant d’envoyer à nouveau le message. Ce délai permet de réduire la charge inutile au niveau des abonnés.

Interface de date limite d’accusé de réception dans Google Developer Console.

Activer exactly one delivery. Cette configuration informe la variable Google Publisher afin de garantir que les messages envoyés à l’abonnement ne seront pas renvoyés avant l’expiration du délai d’accusé de réception. Vous pouvez utiliser ce paramètre pour vous assurer que les messages d’accusé de réception ne sont pas renvoyés à l’abonnement.

Une seule page de configuration de diffusion dans Google Developer Console.

Vous pouvez activer Retry after exponential backoff delay afin de réduire le risque de surcharge du serveur. Vous pouvez activer cette configuration dans la section Google Developer Console pour mieux atténuer les échecs transitoires (erreurs temporaires qui se résolvent généralement par elles-mêmes), en donnant au système plus de temps pour récupérer avant de tenter une autre connexion.

Fenêtre Stratégie de reprise dans Google Developer Console.

Vous devez définissez la durée de rétention de votre message d’abonnement sur 24 heures ou plus. afin de s’assurer que les données non acquittées ne sont pas perdues lors des charges maximales. En outre, Activation d’une rubrique de lettre morte afin de s’assurer que la perte de données ne se produit pas même dans de rares cas de périphérie.

IMPORTANT
Vous ne pouvez créer qu’un seul flux de données source par Google PubSub abonnement. La réutilisation d’un abonnement, même entre des environnements de test, entraîne la perte de données.

Connexion Google PubSub à Experience Platform

La documentation ci-dessous fournit des informations sur la connexion de Google PubSub à Platform à l’aide d’API ou de l’interface utilisateur :

Utiliser les API

Utiliser l’interface utilisateur

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