Method: customers.uploadConversionAdjustments

Traite les ajustements de conversion donnés.

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}:uploadConversionAdjustments

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 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
Champs
conversionAdjustments[]

object (ConversionAdjustment)

Obligatoire. Ajustements de conversion 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.
jobId

integer

Facultatif. Entrée facultative permettant de définir l'ID du job. Doit être un nombre non négatif inférieur à 2^31, le cas échéant. Si ce champ n'est pas fourni, l'API génère un ID de job compris dans la plage [2^31, (2^63)-1]. L'API renvoie la valeur de cette requête dans le champ jobId de UploadConversionAdjustmentsResponse.

Corps de la réponse

Message de réponse pour ConversionAdjustmentUploadService.UploadConversionAdjustments.

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 (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
Champs
partialFailureError

object (Status)

Erreurs liées aux échecs d'ajustement des conversions en mode d'échec partiel. Est renvoyé lorsque toutes les erreurs se produisent dans les ajustements. Si des erreurs se produisent en dehors des ajustements (par exemple, des erreurs d'authentification), 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 (ConversionAdjustmentResult)

Élément renvoyé pour cause d'ajustement des conversions traité correctement. 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.
jobId

string (int64 format)

ID du job du lot d'importation.

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.

ConversionAdjustment

Un ajustement de conversion.

Représentation JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Champs
gclidDateTimePair

object (GclidDateTimePair)

Pour les ajustements, identifie de manière unique une conversion enregistrée sans ID de commande spécifié. Si la valeur de "adjustType" est "ENHANCEMENT", cette valeur est facultative, mais peut être définie en plus de "orderId".
adjustmentType

enum (ConversionAdjustmentType)

Type d'ajustement.
restatementValue

object (RestatementValue)

Informations nécessaires pour reformuler la valeur de la conversion. Obligatoire pour les retraitements. Ne doit pas être fourni pour les rétractations. Une erreur s'affiche s'il est fourni pour une rétractation. REMARQUE: Si vous souhaitez importer une deuxième reformulation avec une valeur ajustée différente, elle doit avoir une nouvelle heure d'occurrence d'ajustement plus récente. Sinon, elle sera traitée comme un doublon de la reformulation précédente et ignorée.
userIdentifiers[]

object (UserIdentifier)

Identifiants utilisateur permettant d'améliorer la conversion initiale. ConversionAjustementUploadService n'accepte que les identifiants utilisateur dans les améliorations. Le nombre maximal d'identifiants utilisateur pour chaque amélioration est de cinq.
orderId

string

ID de commande de la conversion à ajuster. Si la conversion a été enregistrée avec un ID de commande spécifié, celui-ci doit être utilisé comme identifiant ici. L'ID de commande est obligatoire pour les améliorations.
conversionAction

string

Nom de ressource de l'action de conversion associée à cet ajustement de 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.
adjustmentDateTime

string

Date et heure auxquelles l'ajustement a été effectué. Doit être postérieure à la date et l'heure de la conversion. 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").
userAgent

string

User-agent pour améliorer la conversion initiale. Vous le trouverez dans l'en-tête de requête HTTP de l'utilisateur lorsqu'il effectue une conversion sur votre page Web. Exemple : "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)". Le user-agent ne peut être spécifié que dans les améliorations avec des identifiants utilisateur. Il doit correspondre au user-agent de la demande qui a envoyé la conversion d'origine. Ainsi, la conversion et son amélioration sont toutes les deux attribuées au même appareil ou à une conversion multi-appareil.

GclidDateTimePair

Identifie une conversion enregistrée de manière unique sans ID de commande spécifié.

Représentation JSON 
{
  "gclid": string,
  "conversionDateTime": string
}
Champs
gclid

string

ID de clic Google (gclid) associé à la conversion d'origine pour cet ajustement.
conversionDateTime

string

Date et heure de la conversion d'origine de cet ajustement. 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").

ConversionAdjustmentType

Les différentes actions que les annonceurs peuvent effectuer pour ajuster les conversions déjà enregistrées Les rétractations annulent une conversion. Les reformulations modifient la valeur d'une conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Représente une valeur inconnue dans cette version.
RETRACTION Annule une conversion de sorte que sa valeur totale et son nombre soient tous deux nuls.
RESTATEMENT Modifie la valeur d'une conversion.
ENHANCEMENT complète une conversion existante avec les identifiants utilisateur et l'user-agent fournis, que Google peut utiliser pour augmenter le nombre de conversions.

RestatementValue

Contient les informations nécessaires pour reformuler la valeur d'une conversion.

Représentation JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
Champs
adjustedValue

number

Valeur de conversion reformulée. Il s'agit de la valeur de la conversion après retraitement. Par exemple, pour faire passer la valeur d'une conversion de 100 à 70, une valeur ajustée de 70 doit être enregistrée. REMARQUE: Si vous souhaitez importer une deuxième reformulation avec une valeur ajustée différente, elle doit avoir une nouvelle heure d'occurrence d'ajustement plus récente. Sinon, elle sera traitée comme un doublon de la reformulation précédente et ignorée.
currencyCode

string

Devise de la valeur mise à jour. Si aucune valeur n'est spécifiée, la devise par défaut de l'action de conversion est utilisée. Si cette valeur n'est pas définie, la devise du compte est utilisée. Il s'agit du code de devise ISO 4217 à trois caractères, par exemple USD ou EUR.

ConversionAdjustmentResult

Informations permettant d'identifier un ajustement de conversion traité avec succès.

Représentation JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Champs
gclidDateTimePair

object (GclidDateTimePair)

Paramètre gclid et date et heure de la conversion.
orderId

string

ID de commande de la conversion à ajuster.
adjustmentType

enum (ConversionAdjustmentType)

Type d'ajustement.
conversionAction

string

Nom de ressource de l'action de conversion associée à cet ajustement de conversion.
adjustmentDateTime

string

Date et heure auxquelles l'ajustement a été effectué. Le format est "aaaa-mm-jj hh:mm:ss+|-hh:mm" (par exemple, "2019-01-01 12:32:45-08:00").