- 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
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- Essayer
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/v15/customers/{customerId}:uploadConversionAdjustments
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 |
---|
{
"conversionAdjustments": [
{
object ( |
Champs | |
---|---|
conversionAdjustments[] |
Obligatoire. Ajustements de conversion 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. |
jobId |
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 tâche compris dans la plage [2^31, (2^63)-1]. L'API renvoie la valeur de cette requête dans le champ |
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 ( |
Champs | |
---|---|
partialFailureError |
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[] |
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 |
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 ( |
Champs | |
---|---|
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 |
Type d'ajustement. |
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[] |
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 |
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 |
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 |
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 |
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 |
ID de clic Google (GCLID) associé à la conversion d'origine pour cet ajustement. |
conversionDateTime |
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 |
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 |
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 ( |
Champs | |
---|---|
gclidDateTimePair |
Le paramètre gclid et la date et l'heure de la conversion. |
orderId |
ID de commande de la conversion à ajuster. |
adjustmentType |
Type d'ajustement. |
conversionAction |
Nom de ressource de l'action de conversion associée à cet ajustement de conversion. |
adjustmentDateTime |
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". |