Method: customers.uploadConversionAdjustments

Elabora gli aggiustamenti delle conversioni specificati.

Elenco degli errori generati: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

obbligatorio. L'ID del cliente che esegue il caricamento.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
Campi
conversionAdjustments[]

object (ConversionAdjustment)

obbligatorio. Gli aggiustamenti delle conversioni che vengono caricati.
partialFailure

boolean

obbligatorio. Se il valore è true, le operazioni andate a buon fine vengono eseguite e le operazioni non valide restituiranno errori. Se il valore è false, tutte le operazioni verranno eseguite in una sola transazione se e solo se sono tutte valide. Deve essere sempre impostato su true. Vedi https://developers.google.com/google-ads/api/docs/best-practices/partial-failures per saperne di più sull'errore parziale.
validateOnly

boolean

Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati.
jobId

integer

Campo facoltativo. Input facoltativo per impostare l'ID job. Deve essere un numero non negativo inferiore a 2^31, se fornito. Se questo campo non viene fornito, l'API genererà un ID job compreso nell'intervallo [2^31, (2^63)-1]. L'API restituirà il valore per questa richiesta nel campo jobId di UploadConversionAdjustmentsResponse.

Corpo della risposta

Messaggio di risposta per ConversionAdjustmentUploadService.UploadConversionAdjustments.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
Campi
partialFailureError

object (Status)

Errori relativi agli errori di aggiustamento delle conversioni in modalità di errore parziale. Errore restituito quando si verificano tutti gli errori all'interno delle regolazioni. Se si verificano errori non correlati agli aggiustamenti, ad esempio errori di autenticazione, viene restituito un errore a livello di RPC. Vedi https://developers.google.com/google-ads/api/docs/best-practices/partial-failures per saperne di più sull'errore parziale.
results[]

object (ConversionAdjustmentResult)

Restituito per gli aggiustamenti delle conversioni elaborati correttamente. Il protocollo sarà vuoto per le righe che hanno ricevuto un errore. I risultati non vengono restituiti quando validationOnly è true.
jobId

string (int64 format)

ID job per il batch di caricamento.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/adwords

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

ConversionAdjustment

Un aggiustamento della conversione.

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

object (GclidDateTimePair)

Per gli aggiustamenti, identifica in modo univoco una conversione registrata senza l'indicazione di un ID ordine. Se il parametro aggiustamentoType è ENHANCEMENT, questo valore è facoltativo ma può essere impostato in aggiunta all'ID ordine.
adjustmentType

enum (ConversionAdjustmentType)

Il tipo di aggiustamento.
restatementValue

object (RestatementValue)

Informazioni necessarie per ribadire il valore della conversione. Obbligatorio per le riaffermazioni. Non deve essere fornito per il ritiro. Se viene fornito un ritiro, verrà restituito un errore. NOTA: se vuoi caricare una seconda riaffermazione con un valore modificato diverso, devi avere una nuova e più recente data/ora in cui si è verificato l'aggiustamento. In caso contrario, verrà considerata come un duplicato della riaffermazione precedente e verrà ignorata.
userIdentifiers[]

object (UserIdentifier)

Gli identificatori utente per migliorare la conversione originale. ConversionAdjustUploadService accetta solo gli identificatori utente nei miglioramenti. Il numero massimo di identificatori utente per ogni miglioramento è 5.
orderId

string

L'ID ordine della conversione da modificare. Se la conversione è stata registrata con un ID ordine specificato, questo ID ordine deve essere utilizzato come identificatore. L'ID ordine è obbligatorio per i miglioramenti.
conversionAction

string

Nome della risorsa dell'azione di conversione associata a questo aggiustamento delle conversioni. Nota: sebbene questo nome risorsa sia composto da un ID cliente e da un ID azione di conversione, la convalida ignorerà l'ID cliente e utilizzerà l'ID azione di conversione come unico identificatore dell'azione di conversione.
adjustmentDateTime

string

La data e l'ora in cui si è verificato l'aggiustamento. Deve essere successiva a ConversionDateTime. È necessario specificare il fuso orario. Il formato è "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00".
userAgent

string

Lo user agent per migliorare la conversione originale. Puoi trovarlo nell'intestazione della richiesta HTTP dell'utente quando effettua la conversione sulla tua pagina web. Esempio, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 come Mac OS X)". Lo user agent può essere specificato solo nei miglioramenti con identificatori utente. Questo valore dovrebbe corrispondere allo user agent della richiesta che ha inviato la conversione originale, in modo che la conversione e il miglioramento vengano entrambi attribuiti come "stesso dispositivo" o come cross-device.

GclidDateTimePair

Identifica in modo univoco una conversione registrata senza un ID ordine specificato.

Rappresentazione JSON 
{
  "gclid": string,
  "conversionDateTime": string
}
Campi
gclid

string

ID clic Google (gclid) associato alla conversione originale per questo aggiustamento.
conversionDateTime

string

La data e l'ora in cui si è verificata la conversione originale di questo aggiustamento. È necessario specificare il fuso orario. Il formato è "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00".

ConversionAdjustmentType

Le diverse azioni che gli inserzionisti possono intraprendere per aggiustare le conversioni che hanno già registrato. Il ritiro comporta l'annullamento di una conversione. Le riaffermazioni modificano il valore di una conversione.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Rappresenta un valore sconosciuto in questa versione.
RETRACTION Nega una conversione in modo che il valore totale e il conteggio siano entrambi zero.
RESTATEMENT Modifica il valore di una conversione.
ENHANCEMENT Integra una conversione esistente con gli identificatori utente forniti e lo user agent, che possono essere utilizzati da Google per migliorare il conteggio delle conversioni.

RestatementValue

Contiene le informazioni necessarie per ridefinire il valore di una conversione.

Rappresentazione JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
Campi
adjustedValue

number

Il valore di conversione ripristinato. Questo è il valore della conversione dopo la riaffermazione. Ad esempio, per modificare il valore di una conversione da 100 a 70, deve essere registrato un valore rettificato pari a 70. NOTA: se vuoi caricare una seconda riaffermazione con un valore modificato diverso, devi avere una nuova e più recente data/ora in cui si è verificato l'aggiustamento. In caso contrario, verrà considerata come un duplicato della riaffermazione precedente e verrà ignorata.
currencyCode

string

La valuta del valore ripristinato. Se non viene specificata, viene utilizzata la valuta predefinita dell'azione di conversione. Se non è impostata, viene utilizzata la valuta dell'account. Si tratta del codice valuta ISO 4217 di tre caratteri, ad esempio USD o EUR.

ConversionAdjustmentResult

Informazioni che identificano un aggiustamento delle conversioni elaborato correttamente.

Rappresentazione JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Campi
gclidDateTimePair

object (GclidDateTimePair)

Il gclid e la data e l'ora della conversione.
orderId

string

L'ID ordine della conversione da modificare.
adjustmentType

enum (ConversionAdjustmentType)

Il tipo di aggiustamento.
conversionAction

string

Nome della risorsa dell'azione di conversione associata a questo aggiustamento delle conversioni.
adjustmentDateTime

string

La data e l'ora in cui si è verificato l'aggiustamento. Il formato è "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00".