Method: customers.uploadCallConversions

Traite les conversions par appel données.

Liste des erreurs générées: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Requête HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

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 (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Champs
conversions[]

object (CallConversion)

Obligatoire. Conversions en cours d'importation.
partialFailure

boolean

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 en 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

boolean

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 (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
Champs
partialFailureError

object (Status)

Erreurs liées aux échecs de conversion en mode d'échec partiel. Est renvoyé lorsque toutes les erreurs se produisent dans les 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[]

object (CallConversionResult)

Est renvoyé pour les conversions traitées. 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 (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Champs
customVariables[]

object (CustomVariable)

Variables personnalisées associées à cette conversion.
consent

object (Consent)

Paramètre de consentement pour l'événement.
callerId

string

Numéro de l'appelant à partir duquel l'appel a été passé. Le numéro de l'appelant doit être au format E.164 et précédé du signe "+" ("+16502531234", par exemple).
callStartDateTime

string

Date et 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").
conversionAction

string

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

string

Il s'agit de la date et de l'heure auxquelles la conversion s'est produite. 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

number

Valeur de la conversion pour l'annonceur.
currencyCode

string

Devise associée à la valeur de conversion. Il s'agit du code de devise ISO 4217 à trois caractères. Par exemple: USD, EUR.

CallConversionResult

Informations permettant d'identifier un élément CallConversionUpload qui a bien été traité.

Représentation JSON 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Champs
callerId

string

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

string

Date et heure de l'appel. Le format est "aaaa-mm-jj hh:mm:ss+|-hh:mm" (par exemple, "2019-01-01 12:32:45-08:00").
conversionAction

string

Nom de ressource de l'action de conversion associée à cette conversion.
conversionDateTime

string

Il s'agit de la date et de l'heure auxquelles la conversion s'est produite. Le format est "aaaa-mm-jj hh:mm:ss+|-hh:mm" (par exemple, "2019-01-01 12:32:45-08:00").