Method: events.ingest

Importe une liste de ressources Event à partir du Destination fourni.

Requête HTTP

POST https://datamanager.googleapis.com/v1/events:ingest

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
Champs
destinations[]

object (Destination)

Obligatoire. Liste des destinations auxquelles envoyer les événements.
events[]

object (Event)

Obligatoire. Liste des événements à envoyer aux destinations spécifiées. Vous pouvez envoyer jusqu'à 2 000 ressources Event dans une même requête.
consent

object (Consent)

Facultatif. Consentement au niveau de la demande à appliquer à tous les utilisateurs de la demande. Le consentement au niveau de l'utilisateur remplace celui au niveau de la demande et peut être spécifié dans chaque Event.
validateOnly

boolean

Facultatif. À des fins de test. Si la valeur est true, la requête est validée, mais pas exécutée. Seules les erreurs sont renvoyées, et non les résultats.
encoding

enum (Encoding)

Facultatif. Obligatoire pour les importations UserData. Type d'encodage des identifiants utilisateur. Pour les identifiants utilisateur hachés, il s'agit du type d'encodage de la chaîne hachée. Pour les identifiants utilisateur hachés chiffrés, il s'agit du type d'encodage de la chaîne chiffrée externe, mais pas nécessairement de la chaîne hachée interne. Cela signifie que la chaîne hachée interne peut être encodée différemment de la chaîne chiffrée externe. Pour les importations autres que UserData, ce champ est ignoré.
encryptionInfo

object (EncryptionInfo)

Facultatif. Informations sur le chiffrement des importations UserData. Si elle n'est pas définie, les informations d'identification importées sont considérées comme hachées, mais pas chiffrées. Pour les importations autres que UserData, ce champ est ignoré.

Corps de la réponse

Réponse de IngestEventsRequest.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "requestId": string
}
Champs
requestId

string

ID généré automatiquement pour la demande.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/datamanager

Événement

Événement représentant une interaction utilisateur avec le site Web ou l'application d'un annonceur.

Représentation JSON 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "conversionValue": number,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  }
}
Champs
destinationReferences[]

string

Facultatif. Chaîne de référence utilisée pour déterminer la destination. Si ce champ est vide, l'événement sera envoyé à tous les destinations de la requête.
transactionId

string

Obligatoire. Identifiant unique de cet événement.
eventTimestamp

string (Timestamp format)

Obligatoire. Heure à laquelle l'événement s'est produit.

Utilise la norme RFC 3339, où la sortie générée utilise le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
lastUpdatedTimestamp

string (Timestamp format)

Facultatif. Date de la dernière modification de l'événement.

Utilise la norme RFC 3339, où la sortie générée utilise le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
userData

object (UserData)

Facultatif. Éléments de données fournies par l'utilisateur, représentant l'utilisateur auquel l'événement est associé.
consent

object (Consent)

Facultatif. Informations indiquant si l'utilisateur associé a donné différents types de consentement.
adIdentifiers

object (AdIdentifiers)

Facultatif. Identifiants et autres informations utilisés pour faire correspondre l'événement de conversion à d'autres activités en ligne (comme les clics sur les annonces).
currency

string

Facultatif. Code de devise associé à toutes les valeurs monétaires de cet événement.
conversionValue

number

Facultatif. Valeur de conversion associée à l'événement, pour les conversions basées sur la valeur.
eventSource

enum (EventSource)

Facultatif. Signal indiquant où l'événement s'est produit (sur le Web, dans une application, en magasin, etc.).
eventDeviceInfo

object (DeviceInfo)

Facultatif. Informations recueillies sur l'appareil utilisé (le cas échéant) au moment de l'événement.
cartData

object (CartData)

Facultatif. Informations sur la transaction et les articles associés à l'événement.
customVariables[]

object (CustomVariable)

Facultatif. Informations supplémentaires sur les paires clé/valeur à envoyer aux conteneurs de conversion (action de conversion ou activité Floodlight).
experimentalFields[]

object (ExperimentalField)

Facultatif. Liste de paires clé/valeur pour les champs expérimentaux qui pourront éventuellement être promus pour faire partie de l'API.
userProperties

object (UserProperties)

Facultatif. Informations évaluées par l'annonceur sur l'utilisateur au moment de l'événement.

AdIdentifiers

Identifiants et autres informations utilisés pour faire correspondre l'événement de conversion à d'autres activités en ligne (comme les clics sur les annonces).

Représentation JSON 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  }
}
Champs
sessionAttributes

string

Facultatif. Attributs de session pour l'attribution et la modélisation des événements.
gclid

string

Facultatif. ID de clic Google (gclid) associé à cet événement.
gbraid

string

Facultatif. Identifiant des clics associés aux événements d'application et provenant d'appareils iOS (à partir d'iOS 14).
wbraid

string

Facultatif. Identifiant des clics associés aux événements Web et provenant d'appareils iOS (à partir d'iOS 14).
landingPageDeviceInfo

object (DeviceInfo)

Facultatif. Informations recueillies sur l'appareil utilisé (le cas échéant) au moment de l'arrivée sur le site de l'annonceur après l'interaction avec l'annonce.

DeviceInfo

Informations sur l'appareil utilisé (le cas échéant) au moment de l'événement.

Représentation JSON 
{
  "userAgent": string,
  "ipAddress": string
}
Champs
userAgent

string

Facultatif. Chaîne user-agent de l'appareil pour le contexte donné.
ipAddress

string

Facultatif. Adresse IP de l'appareil pour le contexte donné.

Remarque : Google Ads n'est pas compatible avec la mise en correspondance des adresses IP pour les utilisateurs finaux de l'Espace économique européen (EEE), du Royaume-Uni (UK) ou de la Suisse (CH). Ajoutez une logique pour exclure conditionnellement le partage des adresses IP des utilisateurs de ces régions. Assurez-vous également de fournir aux utilisateurs des informations claires et complètes sur les données que vous collectez sur vos sites, applications et autres propriétés, et d'obtenir leur consentement lorsque la loi ou les règles Google applicables l'exigent. Pour en savoir plus, consultez la page À propos de l'importation des conversions hors connexion.

EventSource

Source de l'événement.

Enums
EVENT_SOURCE_UNSPECIFIED EventSource non spécifié. Ce type ne doit jamais être utilisé.
WEB L'événement a été généré à partir d'un navigateur Web.
APP L'événement a été généré à partir d'une application.
IN_STORE L'événement a été généré à partir d'une transaction en magasin.
PHONE L'événement a été généré à partir d'un appel téléphonique.
OTHER L'événement a été généré à partir d'autres sources.

CartData

Données du panier associées à l'événement.

Représentation JSON 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ]
}
Champs
merchantId

string

Facultatif. ID Merchant Center associé aux articles.
merchantFeedLabel

string

Facultatif. Libellé du flux Merchant Center associé au flux des articles.
merchantFeedLanguageCode

string

Facultatif. Code de langue ISO 639-1 associé au flux Merchant Center des articles dans lequel vos articles sont importés.
transactionDiscount

number

Facultatif. Somme de toutes les remises associées à la transaction.
items[]

object (Item)

Facultatif. Liste des éléments associés à l'événement.

Élément

Représente un article du panier associé à l'événement.

Représentation JSON 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number
}
Champs
merchantProductId

string

Facultatif. ID du produit dans le compte Merchant Center.
quantity

string (int64 format)

Facultatif. Nombre de cet article associé à l'événement.
unitPrice

number

Facultatif. Prix unitaire hors taxes, frais de port et toute remise appliquée aux transactions.

Variable personnalisée

Variable personnalisée pour les conversions d'annonces.

Représentation JSON 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
Champs
variable

string

Facultatif. Nom de la variable personnalisée à définir. Si la variable n'est pas trouvée pour la destination indiquée, elle sera ignorée.
value

string

Facultatif. Valeur à stocker pour la variable personnalisée.
destinationReferences[]

string

Facultatif. Chaîne de référence utilisée pour déterminer à quel Event.destination_references la variable personnalisée doit être envoyée. Si ce champ est vide, le Event.destination_references sera utilisé.

ExperimentalField

Champ expérimental représentant les champs non officiels.

Représentation JSON 
{
  "field": string,
  "value": string
}
Champs
field

string

Facultatif. Nom du champ à utiliser.
value

string

Facultatif. Valeur à définir pour le champ.

UserProperties

Informations évaluées par l'annonceur sur l'utilisateur au moment de l'événement. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/14007601.

Représentation JSON 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket)
}
Champs
customerType

enum (CustomerType)

Facultatif. Type de client associé à l'événement.
customerValueBucket

enum (CustomerValueBucket)

Facultatif. Valeur du client évaluée par l'annonceur.

CustomerType

Type de client associé à l'événement.

Enums
CUSTOMER_TYPE_UNSPECIFIED Type de client non spécifié. Ce type ne doit jamais être utilisé.
NEW Le client est nouveau pour l'annonceur.
RETURNING Le client revient vers l'annonceur.
REENGAGED Le client a de nouveau interagi avec l'annonceur.

CustomerValueBucket

Valeur du client évaluée par l'annonceur.

Enums
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Bucket de valeur client non spécifié. Ce type ne doit jamais être utilisé.
LOW Le client a un faible potentiel.
MEDIUM Le client a un potentiel moyen.
HIGH Le client est à fort potentiel.