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/v14/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
}
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 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

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 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 à des échecs d'ajustement des conversions en mode d'échec partiel. Est renvoyé lorsque toutes les erreurs se produisent pendant les ajustements. Si des erreurs se produisent en dehors des ajustements (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 (ConversionAdjustmentResult)

Retourné pour cause d'ajustement des conversions traité avec succès. 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.
jobId

string (int64 format)

ID du job pour le lot de mise en ligne.

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

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 qui a été enregistrée sans ID de commande spécifié. Si le paramètre AdjustType est ENHANCEMENT, cette valeur est facultative, mais peut être définie en plus de l'ID de commande (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 sera renvoyée 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 d'origine. ConversionAdjustUploadService 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

L'user-agent pour améliorer la conversion d'origine. Il se trouve dans l'en-tête de requête HTTP de l'utilisateur lorsqu'il effectue une conversion sur votre page Web. Par 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 optimisations avec des identifiants utilisateur. Il doit correspondre à l'user-agent de la demande qui a envoyé la conversion d'origine. Ainsi, la conversion et son amélioration sont toutes deux attribuées au même appareil ou à une conversion multi-appareil.

GclidDateTimePair

Identifie de manière unique une conversion qui a été enregistrée 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 auxquelles la conversion initiale de cet ajustement 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".

ConversionAdjustmentType

Les différentes actions que les annonceurs peuvent effectuer pour ajuster les conversions qu'ils ont 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 Elle complète une conversion existante par les identifiants utilisateur et le 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 remanié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 elle 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 identifiant un ajustement de conversion traité correctement.

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

object (GclidDateTimePair)

Le paramètre gclid et la date et l'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".