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/v15/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 riuscite verranno eseguite e quelle non valide restituiranno errori. Se impostato su false, tutte le operazioni verranno eseguite in un'unica transazione solo se sono tutte valide. Deve essere sempre impostato su true. Per ulteriori informazioni sull'errore parziale, consulta la pagina https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
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 a errori di aggiustamento delle conversioni in modalità di errore parziale. Restituito quando si verificano tutti gli errori all'interno degli aggiustamenti. Se si verificano errori che non riguardano gli aggiustamenti, ad esempio errori di autenticazione, viene restituito un errore a livello di RPC. Per ulteriori informazioni sull'errore parziale, consulta la pagina https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
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 se convalidareOnly è 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 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 aggiustamentoType è ENHANCEMENT, questo valore è facoltativo ma può essere impostato in aggiunta a orderId.
adjustmentType

enum (ConversionAdjustmentType)

Il tipo di aggiustamento.
restatementValue

object (RestatementValue)

Informazioni necessarie per ridefinire 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, la data e l'ora in cui si è verificato l'aggiustamento devono essere nuove e più recenti. 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 identificatori utente nei miglioramenti. Il numero massimo di identificatori utente per ogni miglioramento è 5.
orderId

string

L'ID ordine della conversione da aggiustare. 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: anche se questo nome risorsa è costituito 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 è stato eseguito 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. Lo puoi trovare 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 like 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 same-device 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 per 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 annulla 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 0.
RESTATEMENT Modifica il valore di una conversione.
ENHANCEMENT Integra una conversione esistente con gli identificatori utente e lo user agent forniti, 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 rettificato. Questo è il valore della conversione dopo la riaffermazione. Ad esempio, per modificare il valore di una conversione da 100 a 70, è necessario registrare un valore rettificato pari a 70. NOTA: se vuoi caricare una seconda riaffermazione con un valore modificato diverso, la data e l'ora in cui si è verificato l'aggiustamento devono essere nuove e più recenti. In caso contrario, verrà considerata come un duplicato della riaffermazione precedente e verrà ignorata.
currencyCode

string

La valuta del valore rideterminato. Se non viene fornita, viene utilizzata la valuta predefinita dell'azione di conversione. Se questa non è impostata, viene utilizzata la valuta dell'account. Si tratta del codice valuta di 3 caratteri ISO 4217, 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 aggiustare.
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 è stato eseguito l'aggiustamento. Il formato è "aaaa-mm-gg hh:mm:ss+|-hh:mm", ad esempio "2019-01-01 12:32:45-08:00".