- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- CallConversion
- CallConversionResult
- Essayer
Traite les conversions par appel indiquées.
Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
Requête HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
customerId |
Obligatoire. Identifiant du client effectuant l'importation. |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"conversions": [
{
object ( |
Champs | |
---|---|
conversions[] |
Obligatoire. Conversions en cours d'importation. |
partialFailure |
Obligatoire. Si la valeur est "true", les opérations réussies sont effectuées et les opérations non valides renvoient des erreurs. Si la valeur est "false", toutes les opérations seront effectuées dans une seule transaction si et seulement si elles sont toutes valides. Doit toujours être défini sur "true". Pour en savoir plus sur les échecs partiels, consultez la page https://developers.google.com/google-ads/api/docs/best-practices/partial-failures. |
validateOnly |
Si la valeur est "true", la requête est validée, mais pas exécutée. Seules les erreurs sont renvoyées, pas les résultats. |
Corps de la réponse
Message de réponse pour ConversionUploadService.UploadCallConversions
.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{ "partialFailureError": { object ( |
Champs | |
---|---|
partialFailureError |
Erreurs liées à des échecs de conversion en mode d'échec partiel. Est renvoyé lorsque toutes les erreurs se produisent au sein des conversions. Si des erreurs se produisent en dehors des conversions (erreurs d'authentification, par exemple), nous renvoyons une erreur au niveau du RPC. Pour en savoir plus sur les échecs partiels, consultez la page https://developers.google.com/google-ads/api/docs/best-practices/partial-failures. |
results[] |
Retourné pour les conversions traitées. Le proto sera vide pour les lignes qui ont reçu une erreur. Les résultats ne sont pas renvoyés lorsque validateOnly est défini sur true. |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/adwords
Pour en savoir plus, consultez la présentation d'OAuth 2.0.
CallConversion
Une conversion par appel
Représentation JSON |
---|
{ "customVariables": [ { object ( |
Champs | |
---|---|
customVariables[] |
Variables personnalisées associées à cette conversion. |
consent |
Paramètre de consentement pour l'événement. |
callerId |
Numéro de l'appelant à partir duquel l'appel a été passé. Le numéro de l'appelant doit être au format E.164, suivi du signe "+" (par exemple, "+16502531234"). |
callStartDateTime |
Date et heure auxquelles l'appel a eu lieu. Vous devez indiquer le fuseau horaire. Le format est "aaaa-mm-jj hh:mm:ss+|-hh:mm", par exemple, "2019-01-01 12:32:45-08:00". |
conversionAction |
Nom de ressource de l'action de conversion associée à cette conversion. Remarque: Bien que ce nom de ressource se compose d'un numéro client et d'un ID d'action de conversion, la validation ignorera le numéro client et utilisera l'ID de l'action de conversion comme unique identifiant de l'action de conversion. |
conversionDateTime |
Il s'agit de la date et de l'heure auxquelles la conversion a eu lieu. Doit être postérieure à l'heure de l'appel. Vous devez indiquer le fuseau horaire. Le format est "aaaa-mm-jj hh:mm:ss+|-hh:mm", par exemple, "2019-01-01 12:32:45-08:00". |
conversionValue |
Valeur de la conversion pour l'annonceur. |
currencyCode |
Devise associée à la valeur de conversion. Il s'agit du code de devise à trois caractères ISO 4217. Par exemple: USD, EUR. |
CallConversionResult
Informations d'identification d'un élément CallConversionUpload qui a été correctement traité.
Représentation JSON |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
Champs | |
---|---|
callerId |
Numéro de l'appelant à partir duquel l'appel a été passé. Le numéro de l'appelant doit être au format E.164, précédé du signe "+". |
callStartDateTime |
Date et heure auxquelles l'appel a eu lieu. Le format est "aaaa-mm-jj hh:mm:ss+|-hh:mm", par exemple, "2019-01-01 12:32:45-08:00". |
conversionAction |
Nom de ressource de l'action de conversion associée à cette conversion. |
conversionDateTime |
Il s'agit de la date et de l'heure auxquelles la conversion a eu lieu. Le format est "aaaa-mm-jj hh:mm:ss+|-hh:mm", par exemple, "2019-01-01 12:32:45-08:00". |