OfflineUserDataJob

Un job contenente i dati utente offline dei visitatori dei negozi o dei membri degli elenchi di utenti che verranno elaborati in modo asincrono. I dati caricati non sono leggibili e i risultati di elaborazione del job possono essere letti solo utilizzando GoogleAdsService.Search/SearchStream.

Rappresentazione JSON
{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}
Campi
resourceName

string

Immutabile. Il nome della risorsa del job di dati utente offline. I nomi delle risorse dei job per i dati utente offline hanno il seguente formato:

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}

type

enum (OfflineUserDataJobType)

Immutabile. Tipo di lavoro.

status

enum (OfflineUserDataJobStatus)

Solo output. Stato del job.

failureReason

enum (OfflineUserDataJobFailureReason)

Solo output. Motivo dell'errore di elaborazione, se lo stato è NON RIUSCITA.

operationMetadata

object (OfflineUserDataJobMetadata)

Solo output. Metadati del job di dati utente offline che rappresentano l'intervallo del tasso di corrispondenza.

id

string (int64 format)

Solo output. ID di questo job di dati utente offline.

externalId

string (int64 format)

Immutabile. ID job specificato dall'utente.

Campo unione metadata. Metadati del job. metadata può essere solo uno dei seguenti:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Immutabile. Metadati per gli aggiornamenti dei dati in un elenco di utenti basato su CRM.

storeSalesMetadata

object (StoreSalesMetadata)

Immutabile. I metadati per l'aggiornamento dei dati delle vendite in negozio.

OfflineUserDataJobType

Il tipo di un job di dati utente offline.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
STORE_SALES_UPLOAD_FIRST_PARTY Dati relativi alle vendite dirette in negozio per il self-service.
STORE_SALES_UPLOAD_THIRD_PARTY Dati relativi alle vendite dirette in negozio per terze parti.
CUSTOMER_MATCH_USER_LIST Dati dell'elenco di utenti di Customer Match.
CUSTOMER_MATCH_WITH_ATTRIBUTES Customer Match con dati degli attributi.

OfflineUserDataJobStatus

Lo stato di un job di dati utente offline.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
PENDING Il job è stato creato correttamente ed è in attesa di caricamento.
RUNNING I caricamenti sono stati accettati e i dati sono in fase di elaborazione.
SUCCESS I dati caricati sono stati elaborati correttamente.
FAILED Impossibile elaborare i dati caricati.

OfflineUserDataJobFailureReason

Il motivo dell'errore di un job di dati utente offline.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
INSUFFICIENT_MATCHED_TRANSACTIONS Le transazioni corrispondenti non sono sufficienti.
INSUFFICIENT_TRANSACTIONS Le transazioni caricate non sono sufficienti.
HIGH_AVERAGE_TRANSACTION_VALUE Il valore medio delle transazioni del tuo account è insolitamente elevato. In questo caso, contatta l'assistenza per richiedere un'eccezione. Scopri di più all'indirizzo https://support.google.com/google-ads/answer/10018944#transaction_value
LOW_AVERAGE_TRANSACTION_VALUE Il valore medio delle transazioni per il tuo account è insolitamente basso. In questo caso, contatta l'assistenza per richiedere un'eccezione. Scopri di più all'indirizzo https://support.google.com/google-ads/answer/10018944#transaction_value
NEWLY_OBSERVED_CURRENCY_CODE Esiste un codice valuta che non hai mai utilizzato nei tuoi caricamenti. In questo caso, contatta l'assistenza per richiedere un'eccezione. Scopri di più all'indirizzo https://support.google.com/google-ads/answer/10018944#Unrecognized_currency

OfflineUserDataJobMetadata

Metadati del job di dati utente offline.

Rappresentazione JSON
{
  "matchRateRange": enum (OfflineUserDataJobMatchRateRange)
}
Campi
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

Solo output. Tasso di corrispondenza del caricamento dell'elenco di utenti Customer Match. Descrive il tasso di corrispondenza stimato quando lo stato del job è "IN ESECUZIONE" e il tasso di corrispondenza finale quando il tasso di corrispondenza finale è disponibile dopo che lo stato del job è "RIUSCITO/NON RIUSCITA".

OfflineUserDataJobMatchRateRange

L'intervallo del tasso di corrispondenza di un job di dati utente offline.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Valore predefinito per l'intervallo del tasso di corrispondenza.
MATCH_RANGE_LESS_THAN_20 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra 0% e 19%.
MATCH_RANGE_20_TO_30 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra 20% e 30%.
MATCH_RANGE_31_TO_40 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra 31% e 40%.
MATCH_RANGE_41_TO_50 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra il 41% e il 50%.
MATCH_RANGE_51_TO_60 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra 51% e 60%.
MATCH_RANGE_61_TO_70 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra 61% e 70%.
MATCH_RANGE_71_TO_80 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra 71% e 80%.
MATCH_RANGE_81_TO_90 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è compreso tra 81% e 90%.
MATCH_RANGE_91_TO_100 L'intervallo del tasso di corrispondenza per l'entità di caricamento dei dati offline è superiore o uguale al 91%.

StoreSalesMetadata

Metadati per le vendite dirette in negozio.

Rappresentazione JSON
{
  "thirdPartyMetadata": {
    object (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
Campi
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

Metadati per il caricamento di vendite in negozio di terze parti.

loyaltyFraction

number

Si tratta della frazione di tutte le transazioni identificabili (ad esempio associate a qualsiasi tipo di dati del cliente). Obbligatoria. La frazione deve essere compresa tra 0 e 1 (escluso 0).

transactionUploadFraction

number

Il rapporto tra le vendite caricate e le vendite totali che possono essere associate a un cliente. Obbligatoria. La frazione deve essere compresa tra 0 e 1 (escluso 0). Ad esempio, se carichi metà delle vendite che puoi associare a un cliente, il valore sarà 0,5.

customKey

string

Nome della chiave della variabile personalizzata per le vendite in negozio. Chiave predefinita che può essere applicata alla transazione e utilizzata in un secondo momento per la segmentazione personalizzata nei report. Accessibile solo ai clienti inclusi nella lista consentita.

StoreSalesThirdPartyMetadata

Metadati per le vendite in negozio di una terza parte. Questo prodotto è destinato solo ai clienti inclusi nella lista consentita. Contatta il tuo rappresentante di sviluppo aziendale Google per i dettagli sulla configurazione del caricamento.

Rappresentazione JSON
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
Campi
advertiserUploadDateTime

string

Ora in cui l'inserzionista ha caricato i dati nel partner. Obbligatoria. Il formato è "AAAA-MM-GG HH:MM:SS". Esempi: "2018-03-05 09:15:00" o "2018-02-01 14:34:30"

validTransactionFraction

number

La frazione di transazioni valide. Le transazioni non valide possono includere formati o valori non validi. Obbligatoria. La frazione deve essere compresa tra 0 e 1 (escluso 0).

partnerMatchFraction

number

La frazione di transazioni valide associate a un ID utente assegnato da terze parti sul lato partner. Obbligatoria. La frazione deve essere compresa tra 0 e 1 (escluso 0).

partnerUploadFraction

number

La frazione di transazioni valide caricate dal partner su Google. Obbligatoria. La frazione deve essere compresa tra 0 e 1 (escluso 0).

bridgeMapVersionId

string

Versione degli ID partner da utilizzare per i caricamenti. Obbligatoria.

partnerId

string (int64 format)

ID del partner terzo che aggiorna il feed delle transazioni.