[Ultimate]{class="badge positive"}
Source Google PubSub
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éalable à effectuer avant de connecter votre compte Google PubSub à Experience Platform.
Créer un compte de service create-service-account
Un compte de service est un type de compte souvent utilisé par une application ou une charge de travail de calcul, plutôt que par une personne. Un compte de service est identifié par son adresse e-mail, qui est propre au compte.
- D’une part, les comptes de service sont des entités - vous pouvez accorder aux comptes de service l’accès aux ressources Google Cloud. Par exemple, vous pouvez accorder à un compte de service le rôle 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 donner à d’autres entités de sécurité l’autorisation d’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 lui permettre de joindre ce compte de service aux ressources. Vous pouvez également accorder à un utilisateur le rôle d’administrateur de compte de service(roles/iam.serviceAccountAdmin)pour lui permettre d’effectuer 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 le Google guide sur les méthodes d’authentification.
Pour créer un compte de service, procédez comme suit :
Tout d’abord, accédez à la page IAM du Google Developer Console, puis sélectionnez Create Service Account.
Saisissez ensuite un nom d’affichage et un identifiant pour votre compte de service, puis sélectionnez Create and Continue.
Générer des clés de compte de service generate-service-account-keys
Pour générer des clés pour votre compte de service, sélectionnez l’en-tête des clés dans la page Comptes de service . À partir de là, sélectionnez Add key , puis Create new key dans le menu déroulant. Vous pouvez également utiliser ce panneau pour charger une clé existante.
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 compte Google PubSub sur Experience Platform.
Octroi d’autorisations au niveau de la rubrique et de l’abonnement grant-permissions
Pour accorder des autorisations au niveau de la rubrique et de l’abonnement, accédez à la page de console de la rubrique, puis sélectionnez Show info panel. Ensuite, sous l’onglet Permissions , sélectionnez Add Principal , puis ajoutez le principal du compte de service ainsi que les autorisations.
Configurations pour une Google PubSub usage optimale optimal-configurations
Cette section présente les configurations recommandées pour optimiser l’utilisation de la source Google PubSub sur Experience Platform.
Propriétés de l’abonnement subscription-properties
Utilisez l’Google Developer Console pour augmenter l’échéance de votre accusé de réception. Cela permet au Google Publisher d’attendre en fonction du temps que vous configurez avant d’envoyer à nouveau le message. Ce délai permet de réduire la charge inutile au niveau de l'abonné.
Activez exactly one delivery. Cette configuration informe l’Google Publisher de garantir que les messages envoyés à l’abonnement ne seront pas renvoyés avant l’expiration de la date limite 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.
Vous pouvez activer Retry after exponential backoff delay pour réduire le risque de surcharger davantage le serveur. Vous pouvez activer cette configuration dans l’Google Developer Console pour mieux atténuer les défaillances transitoires (erreurs temporaires qui se résolvent généralement d’elles-mêmes), en donnant au système plus de temps pour récupérer avant de tenter une autre connexion.
Vous devez définir la durée de rétention de vos messages d’abonnement sur 24 heures ou plus pour vous assurer que les données non reconnues ne sont pas perdues pendant les pics de charge. En outre, activez une rubrique de lettre morte pour vous assurer que la perte de données ne se produit pas, même dans de rares cas de périphérie.
Connecter Google PubSub à l’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 :