Cette page explique comment enregistrer des événements utilisateur en temps réel. Les événements utilisateur sont obligatoires pour les applications multimédias. Si vous n'utilisez pas d'applications multimédias, vous n'avez pas besoin d'importer d'événements utilisateur. Toutefois, l'enregistrement des événements utilisateur est recommandé pour les applications de recherche et de recommandations personnalisées.
Pour connaître les types d'événements utilisateur que vous pouvez enregistrer, consultez le champ eventType
de l'objet userEvents
. En ingérant des événements utilisateur, vous pouvez améliorer la qualité de vos résultats. Par exemple, les événements utilisateur affectent le classement des résultats de recherche. Les résultats avec des taux de clics plus élevés sont mis en avant, tandis que ceux avec des taux de clics plus faibles sont relégués au bas de la page. N'enregistrez pas d'événements utilisateur pour les documents que vous n'avez pas encore importés.
Si vous utilisez une application de recherche avec plusieurs data stores associés, Google vous recommande d'ingérer les événements utilisateur au niveau de l'établissement plutôt qu'au niveau du data store. Cela permet d'envoyer un événement utilisateur donné au data store auquel il est associé. Pour ingérer des événements utilisateur avec des documents provenant de différents dataStores
au niveau de l'emplacement plutôt qu'au niveau du datastore, consultez userEvents.write
.
Pour importer des événements utilisateur historiques de manière groupée, consultez Importer des événements utilisateur historiques.
Vous pouvez enregistrer des événements utilisateur de plusieurs manières :
Pour la représentation JSON des événements utilisateur, consultez userEvents
dans la documentation de référence de l'API.
Avant de commencer
Avant d'importer des événements utilisateur :
- Créez un data store et une application.
- Consultez À propos des événements utilisateur multimédias ou À propos des événements utilisateur pour connaître les exigences concernant les événements utilisateur.
Enregistrer des événements utilisateur en temps réel avec un pixel JavaScript
Pour enregistrer des événements utilisateur avec un pixel JavaScript :
- Créez une clé API pour les appels à la méthode
userEvents.collect
. - Consultez l'exemple de pixel JavaScript pour découvrir un exemple de balise JavaScript qui collecte les événements utilisateur.
Créer une clé API
Une clé API est requise si vous utilisez un pixel JavaScript pour collecter les événements utilisateur à partir des navigateurs des utilisateurs.
Pour créer une clé API pour les appels à la méthode userEvents.collect
, procédez comme suit :
Dans la console Google Cloud , accédez à la page Identifiants.
Dans la liste déroulante de projet en haut de la page de la console Google Cloud , sélectionnez votre projet (il est peut-être déjà sélectionné).
Cliquez sur Créer des identifiants, puis sélectionnez Clé API. N'ajoutez aucune restriction de référent. Certains paramètres de confidentialité de l'utilisateur ne transmettent pas l'URL de provenance.
- Prenez note de la clé API générée, que vous utiliserez lors des appels à l'API de journalisation des événements utilisateur.
Pour renforcer la sécurité, ajoutez une restriction HTTP à votre clé API afin de restreindre l'accès au service AI Applications à l'adresse
https://discoveryengine.googleapis.com/*
.
Exemple de pixel JavaScript
L'exemple suivant enregistre un événement utilisateur view-item
à l'aide d'un pixel JavaScript.
Pour la représentation JSON des événements utilisateur, consultez userEvents
dans la documentation de référence de l'API.
<script type="text/javascript">
var user_event = {
"eventType" : "view-item",
"userPseudoId": "USER_PSEUDO_ID",
"userInfo": {
"userId": "USER_ID"
},
"attributionToken": "ATTRIBUTION_TOKEN",
"tagIds": "TAG_ID",
"documents": [
{
"id": "DOCUMENT_ID"
}
]
};
var _gre = _gre || {};
// Credentials for project.
_gre.apiKey = '[API_KEY]';
_gre.logEvent = user_event;
_gre.projectId = 'PROJECT_ID';
_gre.locationId = 'LOCATION_ID';
_gre.dataStoreId = 'DATA_STORE_ID';
(function() {
var gre = document.createElement('script'); gre.type = 'text/javascript'; gre.async = true;
gre.src = 'https://www.gstatic.com/discoveryengine/v1beta_event.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(gre, s);
})();
</script>
Enregistrer des événements utilisateur en temps réel avec la méthode userEvents.write
REST
Vous pouvez utiliser la méthode userEvents.write
pour envoyer des événements utilisateur directement à l'API à partir de votre serveur backend.
Pour enregistrer des événements utilisateur, envoyez une requête POST à la méthode userEvents.write
et fournissez le corps de requête approprié. Pour la représentation JSON des événements utilisateur, consultez userEvents
dans la documentation de référence de l'API.
Si vous enregistrez des événements utilisateur au niveau de l'établissement, utilisez le point de terminaison https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/userEvents:write
.
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
--data "{
'eventType': 'view-item',
'userPseudoId': 'visitor0',
'eventTime': '2020-01-01T03:33:33.000001Z',
'tagIds': ['321'],
'attributionToken': 'ABC',
'attributes': {
'example_text_attribute': {
'text': ['text_1', 'text_2']
},
'example_number_attribute': {
'numbers': [3.14, 42, 1.2345]
}
},
'documents': [{
'id': 'abc'
}],
'userInfo': {
'userId': 'abc',
'userAgent': 'Mozilla/5.0'
},
'pageInfo': {
'uri': 'http://example',
'referrerUri': 'http://example',
'pageViewId': 'currentPageUri'
}
}" \\
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_NUMBER/locations/global/dataStores/DATA_STORE_ID/userEvents:write"
C#
Pour en savoir plus, consultez la documentation de référence de l'API AI Applications C#.
Pour vous authentifier auprès des applications d'IA, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Pour en savoir plus, consultez la documentation de référence de l'API AI Applications Go.
Pour vous authentifier auprès des applications d'IA, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez la documentation de référence de l'API AI Applications Java.
Pour vous authentifier auprès des applications d'IA, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API AI Applications Python.
Pour vous authentifier auprès des applications d'IA, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API AI Applications Ruby.
Pour vous authentifier auprès des applications d'IA, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.