Indice
IngestionService(interfaccia)MarketingDataInsightsService(interfaccia)PartnerLinkService(interfaccia)UserListDirectLicenseService(interfaccia)UserListGlobalLicenseService(interfaccia)UserListService(interfaccia)AdIdentifiers(messaggio)AddressInfo(messaggio)AgeRange(enum)AudienceMember(messaggio)AwsWrappedKeyInfo(messaggio)AwsWrappedKeyInfo.KeyType(enum)Baseline(messaggio)Baseline.Location(messaggio)CartData(messaggio)Consent(messaggio)ConsentStatus(enum)ContactIdInfo(messaggio)CreatePartnerLinkRequest(messaggio)CreateUserListDirectLicenseRequest(messaggio)CreateUserListGlobalLicenseRequest(messaggio)CreateUserListRequest(messaggio)CustomVariable(messaggio)CustomerType(enum)CustomerValueBucket(enum)DataSourceType(enum)DeletePartnerLinkRequest(messaggio)DeleteUserListRequest(messaggio)Destination(messaggio)DeviceInfo(messaggio)Encoding(enum)EncryptionInfo(messaggio)ErrorCount(messaggio)ErrorInfo(messaggio)ErrorReason(enum)Event(messaggio)EventParameter(messaggio)EventSource(enum)ExperimentalField(messaggio)GcpWrappedKeyInfo(messaggio)GcpWrappedKeyInfo.KeyType(enum)Gender(enum)GetUserListDirectLicenseRequest(messaggio)GetUserListGlobalLicenseRequest(messaggio)GetUserListRequest(messaggio)IngestAudienceMembersRequest(messaggio)IngestAudienceMembersResponse(messaggio)IngestEventsRequest(messaggio)IngestEventsResponse(messaggio)IngestedUserListInfo(messaggio)IngestedUserListInfo.UploadKeyType(enum)Item(messaggio)ItemParameter(messaggio)ListUserListDirectLicensesRequest(messaggio)ListUserListDirectLicensesResponse(messaggio)ListUserListGlobalLicenseCustomerInfosRequest(messaggio)ListUserListGlobalLicenseCustomerInfosResponse(messaggio)ListUserListGlobalLicensesRequest(messaggio)ListUserListGlobalLicensesResponse(messaggio)ListUserListsRequest(messaggio)ListUserListsResponse(messaggio)MatchRateRange(enum)MobileData(messaggio)MobileIdInfo(messaggio)MobileIdInfo.KeySpace(enum)PairData(messaggio)PairIdInfo(messaggio)PartnerAudienceInfo(messaggio)PartnerAudienceInfo.PartnerAudienceSource(enum)PartnerLink(messaggio)PpidData(messaggio)ProcessingErrorReason(enum)ProcessingWarningReason(enum)Product(enum) (obsoleto)ProductAccount(messaggio)ProductAccount.AccountType(enum)PseudonymousIdInfo(messaggio)PseudonymousIdInfo.SyncStatus(enum)RemoveAudienceMembersRequest(messaggio)RemoveAudienceMembersResponse(messaggio)RequestStatusPerDestination(messaggio)RequestStatusPerDestination.IngestAudienceMembersStatus(messaggio)RequestStatusPerDestination.IngestEventsStatus(messaggio)RequestStatusPerDestination.IngestMobileDataStatus(messaggio)RequestStatusPerDestination.IngestPairDataStatus(messaggio)RequestStatusPerDestination.IngestPpidDataStatus(messaggio)RequestStatusPerDestination.IngestUserDataStatus(messaggio)RequestStatusPerDestination.IngestUserIdDataStatus(messaggio)RequestStatusPerDestination.RemoveAudienceMembersStatus(messaggio)RequestStatusPerDestination.RemoveMobileDataStatus(messaggio)RequestStatusPerDestination.RemovePairDataStatus(messaggio)RequestStatusPerDestination.RemovePpidDataStatus(messaggio)RequestStatusPerDestination.RemoveUserDataStatus(messaggio)RequestStatusPerDestination.RemoveUserIdDataStatus(messaggio)RequestStatusPerDestination.RequestStatus(enum)RetrieveInsightsRequest(messaggio)RetrieveInsightsResponse(messaggio)RetrieveInsightsResponse.MarketingDataInsight(messaggio)RetrieveInsightsResponse.MarketingDataInsight.AudienceInsightsDimension(enum)RetrieveInsightsResponse.MarketingDataInsight.MarketingDataInsightsAttribute(messaggio)RetrieveRequestStatusRequest(messaggio)RetrieveRequestStatusResponse(messaggio)SearchPartnerLinksRequest(messaggio)SearchPartnerLinksResponse(messaggio)SizeInfo(messaggio)TargetNetworkInfo(messaggio)TermsOfService(messaggio)TermsOfServiceStatus(enum)UpdateUserListDirectLicenseRequest(messaggio)UpdateUserListGlobalLicenseRequest(messaggio)UpdateUserListRequest(messaggio)UserData(messaggio)UserIdData(messaggio)UserIdInfo(messaggio)UserIdentifier(messaggio)UserList(messaggio)UserList.AccessReason(enum)UserList.AccessStatus(enum)UserList.ClosingReason(enum)UserList.MembershipStatus(enum)UserListDirectLicense(messaggio)UserListGlobalLicense(messaggio)UserListGlobalLicenseCustomerInfo(messaggio)UserListGlobalLicenseType(enum)UserListLicenseClientAccountType(enum)UserListLicenseMetrics(messaggio)UserListLicensePricing(messaggio)UserListLicensePricing.UserListPricingBuyerApprovalState(enum)UserListLicensePricing.UserListPricingCostType(enum)UserListLicenseStatus(enum)UserProperties(messaggio)UserProperty(messaggio)WarningCount(messaggio)WarningInfo(messaggio)
IngestionService
Servizio per l'invio dei dati del pubblico alle destinazioni supportate.
| IngestAudienceMembers |
|---|
|
Carica un elenco di risorse
|
| IngestEvents |
|---|
|
Carica un elenco di risorse
|
| RemoveAudienceMembers |
|---|
|
Rimuove un elenco di risorse
|
| RetrieveRequestStatus |
|---|
|
Recupera lo stato di una richiesta dato l'ID richiesta.
|
MarketingDataInsightsService
Servizio per restituire approfondimenti sui dati di marketing.
Questa funzionalità è disponibile solo per i partner di dati.
| RetrieveInsights |
|---|
|
Recupera approfondimenti sui dati di marketing per un determinato elenco di utenti. Questa funzionalità è disponibile solo per i partner di dati. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
PartnerLinkService
Servizio per la gestione dei link dei partner.
| CreatePartnerLink |
|---|
|
Crea un link partner per l'account specificato. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
| DeletePartnerLink |
|---|
|
Elimina un link partner per l'account specificato. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
| SearchPartnerLinks |
|---|
|
Cerca tutti i link partner da e verso un determinato account. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
UserListDirectLicenseService
Servizio per la gestione delle licenze dirette per gli elenchi di utenti. L'eliminazione non è un'operazione supportata per UserListDirectLicenses. I chiamanti devono aggiornare lo stato della licenza su DISABILITATO per disattivarla.
Questa funzionalità è disponibile solo per i partner di dati.
| CreateUserListDirectLicense |
|---|
|
Crea una licenza diretta per l'elenco di utenti. Questa funzionalità è disponibile solo per i partner di dati.
|
| GetUserListDirectLicense |
|---|
|
Recupera una licenza diretta per l'elenco utenti. Questa funzionalità è disponibile solo per i partner di dati.
|
| ListUserListDirectLicenses |
|---|
|
Elenca tutte le licenze dirette degli elenchi di utenti di proprietà dell'account genitore. Questa funzionalità è disponibile solo per i partner di dati.
|
| UpdateUserListDirectLicense |
|---|
|
Aggiorna una licenza diretta dell'elenco di utenti. Questa funzionalità è disponibile solo per i partner di dati.
|
UserListGlobalLicenseService
Servizio per la gestione delle licenze globali per gli elenchi utenti. L'eliminazione non è un'operazione supportata per UserListGlobalLicenses. I chiamanti devono aggiornare lo stato della licenza su DISABILITATO per disattivarla.
Questa funzionalità è disponibile solo per i partner di dati.
| CreateUserListGlobalLicense |
|---|
|
Crea una licenza globale per l'elenco di utenti. Questa funzionalità è disponibile solo per i partner di dati.
|
| GetUserListGlobalLicense |
|---|
|
Recupera una licenza globale per l'elenco utenti. Questa funzionalità è disponibile solo per i partner di dati.
|
| ListUserListGlobalLicenseCustomerInfos |
|---|
|
Elenca tutte le informazioni sui clienti per una licenza globale dell'elenco utenti. Questa funzionalità è disponibile solo per i partner di dati.
|
| ListUserListGlobalLicenses |
|---|
|
Elenca tutte le licenze globali per gli elenchi di utenti di proprietà dell'account genitore. Questa funzionalità è disponibile solo per i partner di dati.
|
| UpdateUserListGlobalLicense |
|---|
|
Aggiorna una licenza globale per l'elenco di utenti. Questa funzionalità è disponibile solo per i partner di dati.
|
UserListService
Servizio per la gestione delle risorse UserList.
| CreateUserList |
|---|
|
Crea un UserList. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
| DeleteUserList |
|---|
|
Elimina un elenco utenti. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
| GetUserList |
|---|
|
Recupera un UserList. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
| ListUserLists |
|---|
|
Elenca UserLists. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
| UpdateUserList |
|---|
|
Aggiorna un UserList. Intestazioni di autorizzazione: Questo metodo supporta le seguenti intestazioni facoltative per definire in che modo l'API autorizza l'accesso per la richiesta:
|
AdIdentifiers
Identificatori e altre informazioni utilizzate per abbinare l'evento di conversione ad altre attività online (ad esempio clic sugli annunci).
| Campi | |
|---|---|
session_attributes |
Facoltativo. Attributi sessione per l'attribuzione e la modellazione degli eventi. |
gclid |
Facoltativo. L'ID clic Google (gclid) associato a questo evento. |
gbraid |
Facoltativo. L'identificatore dei clic associati agli eventi app e provenienti da dispositivi iOS a partire da iOS 14. |
wbraid |
Facoltativo. L'identificatore dei clic associati agli eventi web e provenienti da dispositivi iOS a partire da iOS 14. |
landing_page_device_info |
Facoltativo. Informazioni raccolte sul dispositivo utilizzato (se presente) al momento dell'arrivo sul sito dell'inserzionista dopo l'interazione con l'annuncio. |
AddressInfo
Informazioni sull'indirizzo dell'utente.
| Campi | |
|---|---|
given_name |
Obbligatorio. Nome (di battesimo) dell'utente, tutto in minuscolo, senza punteggiatura, senza spazi iniziali o finali e sottoposto ad hashing come SHA-256. |
family_name |
Obbligatorio. Cognome dell'utente, tutto in minuscolo, senza punteggiatura, senza spazi iniziali o finali e sottoposto ad hashing come SHA-256. |
region_code |
Obbligatorio. Il codice regione di due lettere nel formato ISO-3166-1 alpha-2 dell'indirizzo dell'utente. |
postal_code |
Obbligatorio. Il codice postale dell'indirizzo dell'utente. |
Intervallo età
Le fasce d'età demografiche
| Enum | |
|---|---|
AGE_RANGE_UNSPECIFIED |
Non specificato. |
AGE_RANGE_UNKNOWN |
Sconosciuto. |
AGE_RANGE_18_24 |
Tra i 18 e i 24 anni. |
AGE_RANGE_25_34 |
Tra i 25 e i 34 anni. |
AGE_RANGE_35_44 |
Tra i 35 e i 44 anni. |
AGE_RANGE_45_54 |
Tra i 45 e i 54 anni. |
AGE_RANGE_55_64 |
Tra i 55 e i 64 anni. |
AGE_RANGE_65_UP |
65 anni e oltre. |
AudienceMember
Il membro del pubblico su cui eseguire l'operazione.
| Campi | |
|---|---|
destination_references[] |
Facoltativo. Definisce a quale |
consent |
Facoltativo. L'impostazione del consenso per l'utente. |
Campo unione data. Il tipo di dati identificativi su cui operare. data può essere solo uno dei seguenti tipi: |
|
user_data |
Dati forniti dall'utente che lo identificano. |
pair_data |
ID Publisher Advertiser Identity Reconciliation (PAIR). Questa funzionalità è disponibile solo per i partner di dati. |
mobile_data |
Dati che identificano i dispositivi mobili dell'utente. |
user_id_data |
Dati relativi agli identificatori unici per un utente, come definiti dall'inserzionista. |
ppid_data |
Dati relativi agli identificatori forniti dal publisher. Questa funzionalità è disponibile solo per i partner di dati. |
AwsWrappedKeyInfo
Una chiave di crittografia dei dati sottoposta a wrapping da una chiave AWS KMS.
| Campi | |
|---|---|
key_type |
Obbligatorio. Il tipo di algoritmo utilizzato per criptare i dati. |
role_arn |
Obbligatorio. L'Amazon Resource Name del ruolo IAM da utilizzare per l'accesso alla decrittografia KMS. Deve essere nel formato |
kek_uri |
Obbligatorio. L'URI della chiave AWS KMS utilizzata per decriptare la DEK. Deve essere nel formato |
encrypted_dek |
Obbligatorio. La chiave di crittografia dei dati criptati con codifica base64. |
KeyType
Il tipo di algoritmo utilizzato per criptare i dati.
| Enum | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Tipo di chiave non specificato. Non deve mai essere utilizzato. |
XCHACHA20_POLY1305 |
Algoritmo XChaCha20-Poly1305 |
Base di riferimento
Criteri di base rispetto ai quali vengono confrontati gli approfondimenti.
| Campi | |
|---|---|
Campo unione baseline. La posizione di riferimento con cui vengono confrontati gli approfondimenti. baseline può essere solo uno dei seguenti tipi: |
|
baseline_location |
La posizione di base della richiesta. La posizione di base è un elenco OR delle regioni richieste. |
location_auto_detection_enabled |
Se impostato su true, il servizio tenterà di rilevare automaticamente la posizione di base per gli approfondimenti. |
Località
La posizione di base della richiesta. La posizione di base si trova nell'elenco OR dei codici regione ISO 3166-1 alpha-2 delle regioni richieste.
| Campi | |
|---|---|
region_codes[] |
Elenco dei codici regione ISO 3166-1 alpha-2. |
CartData
I dati del carrello associati all'evento.
| Campi | |
|---|---|
merchant_id |
Facoltativo. L'ID Merchant Center associato agli articoli. |
merchant_feed_label |
Facoltativo. L'etichetta del feed di Merchant Center associata al feed degli articoli. |
merchant_feed_language_code |
Facoltativo. Il codice lingua ISO 639-1 associato al feed Merchant Center degli articoli in cui vengono caricati i tuoi articoli. |
transaction_discount |
Facoltativo. La somma di tutti gli sconti associati alla transazione. |
items[] |
Facoltativo. L'elenco degli elementi associati all'evento. |
Consenso
Impostazioni per il consenso ai sensi del Digital Markets Act (DMA) per l'utente.
| Campi | |
|---|---|
ad_user_data |
Facoltativo. Indica se l'utente acconsente all'utilizzo dei dati utente per la pubblicità. |
ad_personalization |
Facoltativo. Indica se l'utente acconsente alla personalizzazione degli annunci. |
ConsentStatus
Indica se l'utente ha concesso, negato o non ha specificato il consenso.
| Enum | |
|---|---|
CONSENT_STATUS_UNSPECIFIED |
Non specificato. |
CONSENT_GRANTED |
Concesso. |
CONSENT_DENIED |
Ricorso rifiutato. |
ContactIdInfo
Informazioni aggiuntive quando CONTACT_ID è uno dei upload_key_types.
| Campi | |
|---|---|
match_rate_percentage |
Solo output. Tasso di corrispondenza per gli elenchi utenti Customer Match. |
data_source_type |
Facoltativo. Immutabile. Origine dei dati di caricamento |
CreatePartnerLinkRequest
Richiedi di creare una risorsa PartnerLink. Restituisce un valore PartnerLink.
| Campi | |
|---|---|
parent |
Obbligatorio. L'elemento principale, proprietario di questa raccolta di link dei partner. Formato: accountTypes/{account_type}/accounts/{account} |
partner_link |
Obbligatorio. Il link del partner da creare. |
CreateUserListDirectLicenseRequest
Richiedi di creare una risorsa UserListDirectLicense.
| Campi | |
|---|---|
parent |
Obbligatorio. L'account proprietario dell'elenco utenti per cui viene concessa la licenza. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_direct_license |
Obbligatorio. L'elenco degli utenti a cui assegnare la licenza diretta da creare. |
CreateUserListGlobalLicenseRequest
Richiedi di creare una risorsa UserListGlobalLicense.
| Campi | |
|---|---|
parent |
Obbligatorio. L'account proprietario dell'elenco utenti per cui viene concessa la licenza. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
user_list_global_license |
Obbligatorio. La licenza globale per la creazione dell'elenco utenti. |
CreateUserListRequest
Messaggio di richiesta per CreateUserList.
| Campi | |
|---|---|
parent |
Obbligatorio. L'account genitore in cui verrà creato questo elenco di utenti. Formato: accountTypes/{account_type}/accounts/{account} |
user_list |
Obbligatorio. L'elenco di utenti da creare. |
validate_only |
Facoltativo. Se impostato su true, la richiesta viene convalidata, ma non eseguita. |
CustomVariable
Variabile personalizzata per le conversioni degli annunci.
| Campi | |
|---|---|
variable |
Facoltativo. Il nome della variabile personalizzata da impostare. Se la variabile non viene trovata per la destinazione specificata, verrà ignorata. |
value |
Facoltativo. Il valore da memorizzare per la variabile personalizzata. |
destination_references[] |
Facoltativo. Stringa di riferimento utilizzata per determinare a quale dei |
CustomerType
Tipo di cliente associato all'evento.
| Enum | |
|---|---|
CUSTOMER_TYPE_UNSPECIFIED |
CustomerType non specificato. Non deve mai essere utilizzato. |
NEW |
Il cliente non ha mai interagito con l'inserzionista. |
RETURNING |
Il cliente sta tornando all'inserzionista. |
REENGAGED |
Il cliente ha interagito di nuovo con l'inserzionista. |
CustomerValueBucket
Il valore del cliente valutato dall'inserzionista.
| Enum | |
|---|---|
CUSTOMER_VALUE_BUCKET_UNSPECIFIED |
Unspecified CustomerValueBucket. Non deve mai essere utilizzato. |
LOW |
Il cliente ha un valore basso. |
MEDIUM |
Il cliente ha un valore medio. |
HIGH |
Il cliente è di alto valore. |
DataSourceType
Indica l'origine dei dati di caricamento.
| Enum | |
|---|---|
DATA_SOURCE_TYPE_UNSPECIFIED |
Non specificato. |
DATA_SOURCE_TYPE_FIRST_PARTY |
I dati caricati sono dati proprietari. |
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU |
I dati caricati provengono da un'agenzia di credito di terze parti. |
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE |
I dati caricati provengono da un file di elettori di terze parti. |
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA |
I dati caricati sono dati di partner terzi. |
DeletePartnerLinkRequest
Richiedi l'eliminazione di una risorsa PartnerLink. Restituisce un valore google.protobuf.Empty.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa del link del partner da eliminare. Formato: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
DeleteUserListRequest
Messaggio di richiesta per DeleteUserList.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome dell'elenco di utenti da eliminare. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
validate_only |
Facoltativo. Se impostato su true, la richiesta viene convalidata, ma non eseguita. |
Destinazione
Il prodotto Google a cui invii i dati. Ad esempio, un account Google Ads.
| Campi | |
|---|---|
reference |
Facoltativo. ID per questa risorsa |
login_account |
Facoltativo. L'account utilizzato per effettuare questa chiamata API. Per aggiungere o rimuovere dati da |
linked_account |
Facoltativo. Un account a cui il |
operating_account |
Obbligatorio. L'account a cui inviare i dati o da cui rimuoverli. |
product_destination_id |
Obbligatorio. L'oggetto all'interno dell'account prodotto in cui eseguire l'importazione. Ad esempio, un ID segmento di pubblico Google Ads, un ID segmento di pubblico Display & Video 360 o un ID azione di conversione Google Ads. |
DeviceInfo
Informazioni sul dispositivo utilizzato (se presente) quando si è verificato l'evento.
| Campi | |
|---|---|
user_agent |
Facoltativo. La stringa user agent del dispositivo per il contesto specificato. |
ip_address |
Facoltativo. L'indirizzo IP del dispositivo per il contesto specificato. Nota:Google Ads non supporta la corrispondenza degli indirizzi IP per gli utenti finali nello Spazio economico europeo (SEE), nel Regno Unito (UK) o in Svizzera (CH). Aggiungi una logica per escludere in modo condizionale la condivisione degli indirizzi IP degli utenti di queste regioni e assicurati di fornire agli utenti informazioni chiare e complete sui dati raccolti sui tuoi siti, nelle tue app e in altre proprietà e di ottenere il consenso ove richiesto dalla legge o da eventuali norme di Google vigenti. Per ulteriori dettagli, consulta la pagina Informazioni sulle importazioni delle conversioni offline. |
Codifica
Il tipo di codifica delle informazioni identificative sottoposte ad hashing.
| Enum | |
|---|---|
ENCODING_UNSPECIFIED |
Tipo di codifica non specificato. Non deve mai essere utilizzato. |
HEX |
Codifica esadecimale. |
BASE64 |
Codifica Base64. |
EncryptionInfo
Informazioni sulla crittografia per i dati di cui viene eseguito l'inserimento.
| Campi | |
|---|---|
Campo unione wrapped_key. La chiave sottoposta a wrapping utilizzata per criptare i dati. wrapped_key può essere solo uno dei seguenti tipi: |
|
gcp_wrapped_key_info |
Informazioni sulla chiave di wrapping di Google Cloud. |
aws_wrapped_key_info |
Informazioni sulla chiave con wrapping di Amazon Web Services. |
ErrorCount
Il conteggio degli errori per un determinato motivo.
| Campi | |
|---|---|
record_count |
Il conteggio dei record che non sono stati caricati per un determinato motivo. |
reason |
Il motivo dell'errore dei record non riusciti. |
ErrorInfo
Conteggi degli errori per ogni tipo di errore.
| Campi | |
|---|---|
error_counts[] |
Un elenco di errori e conteggi per motivo dell'errore. Potrebbe non essere compilato in tutti i casi. |
ErrorReason
Motivi dell'errore per l'API Data Manager. NOTA: questo enum non è bloccato e in futuro potrebbero essere aggiunti nuovi valori.
| Enum | |
|---|---|
ERROR_REASON_UNSPECIFIED |
Non utilizzare questo valore predefinito. |
INTERNAL_ERROR |
Si è verificato un errore interno. |
DEADLINE_EXCEEDED |
La richiesta ha impiegato troppo tempo per rispondere. |
RESOURCE_EXHAUSTED |
Numero richieste eccessivo. |
NOT_FOUND |
Risorsa non trovata. |
PERMISSION_DENIED |
L'utente non dispone dell'autorizzazione o la risorsa non è stata trovata. |
INVALID_ARGUMENT |
Si è verificato un problema con la richiesta. |
REQUIRED_FIELD_MISSING |
Manca un campo obbligatorio. |
INVALID_FORMAT |
Il formato non è valido. |
INVALID_HEX_ENCODING |
Il formato del valore codificato esadecimale non è valido. |
INVALID_BASE64_ENCODING |
Il formato del valore con codifica Base64 non è valido. |
INVALID_SHA256_FORMAT |
Il formato del valore codificato SHA256 non è valido. |
INVALID_POSTAL_CODE |
Codice postale non valido. |
INVALID_COUNTRY_CODE |
Il codice paese non è valido. |
INVALID_ENUM_VALUE |
Il valore enum non può essere utilizzato. |
INVALID_USER_LIST_TYPE |
Il tipo di elenco utenti non è applicabile a questa richiesta. |
INVALID_AUDIENCE_MEMBER |
Questo membro del segmento di pubblico non è valido. |
TOO_MANY_AUDIENCE_MEMBERS |
Il numero massimo di membri del pubblico consentiti per richiesta è 10.000. |
TOO_MANY_USER_IDENTIFIERS |
Il numero massimo di identificatori utente consentiti per ogni membro del segmento di pubblico è 10. |
TOO_MANY_DESTINATIONS |
Il numero massimo di destinazioni consentite per richiesta è 10. |
INVALID_DESTINATION |
Questa destinazione non è valida. |
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED |
Il partner di dati non ha accesso all'elenco utenti di proprietà dell'account operativo. |
INVALID_MOBILE_ID_FORMAT |
Il formato dell'ID dispositivo mobile non è valido. |
INVALID_USER_LIST_ID |
L'elenco di utenti non è valido. |
MULTIPLE_DATA_TYPES_NOT_ALLOWED |
Non è consentito l'importazione di più tipi di dati in una singola richiesta. |
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER |
Le configurazioni di destinazione contenenti un account di accesso DataPartner devono avere lo stesso account di accesso in tutte le configurazioni di destinazione. |
TERMS_AND_CONDITIONS_NOT_SIGNED |
I termini e le condizioni obbligatori non sono accettati. |
INVALID_NUMBER_FORMAT |
Formato del numero non valido. |
INVALID_CONVERSION_ACTION_ID |
L'ID azione di conversione non è valido. |
INVALID_CONVERSION_ACTION_TYPE |
Il tipo di azione di conversione non è valido. |
INVALID_CURRENCY_CODE |
Il codice valuta non è supportato. |
INVALID_EVENT |
Questo evento non è valido. |
TOO_MANY_EVENTS |
Il numero massimo di eventi consentiti per richiesta è 10.000. |
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS |
L'account di destinazione non è abilitato per le conversioni avanzate per i lead. |
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS |
Impossibile utilizzare le conversioni avanzate per l'account di destinazione a causa delle norme sui dati dei clienti di Google. Contatta il tuo rappresentante di Google. |
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
L'account di destinazione non ha accettato i termini per le conversioni avanzate. |
DUPLICATE_DESTINATION_REFERENCE |
Due o più destinazioni nella richiesta hanno lo stesso riferimento. |
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER |
Account operativo non supportato per l'autorizzazione del partner di dati. |
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER |
Account collegato non supportato per l'autorizzazione del partner di dati. |
NO_IDENTIFIERS_PROVIDED |
I dati sugli eventi non contengono identificatori utente o pubblicità. |
INVALID_PROPERTY_TYPE |
Il tipo di proprietà non è supportato. |
INVALID_STREAM_TYPE |
Il tipo di stream non è supportato. |
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT |
L'account collegato è supportato solo se l'account di accesso è un account DATA_PARTNER. |
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH |
L'account di accesso deve essere lo stesso dell'account operativo per il caso d'uso specifico. |
EVENT_TIME_INVALID |
L'evento non si è verificato nell'intervallo di tempo accettabile. |
RESERVED_NAME_USED |
Il parametro utilizza un nome riservato. |
INVALID_EVENT_NAME |
Il nome dell'evento non è supportato. |
NOT_ALLOWLISTED |
L'account non è inserito nella lista consentita per la funzionalità specificata. |
INVALID_REQUEST_ID |
L'ID richiesta utilizzato per recuperare lo stato di una richiesta non è valido. Lo stato può essere recuperato solo per le richieste andate a buon fine e che non presentano validate_only=true. |
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT |
Un evento aveva due o più destinazioni Google Analytics. |
FIELD_VALUE_TOO_LONG |
Il valore del campo è troppo lungo. |
TOO_MANY_ELEMENTS |
Troppi elementi in un elenco nella richiesta. |
ALREADY_EXISTS |
La risorsa esiste già. |
IMMUTABLE_FIELD_FOR_UPDATE |
Tentativo di impostare un campo immutabile per una richiesta di aggiornamento. |
INVALID_RESOURCE_NAME |
Il nome della risorsa non è valido. |
INVALID_FILTER |
Il filtro della query non è valido. |
INVALID_UPDATE_MASK |
La maschera di aggiornamento non è valida. |
INVALID_PAGE_TOKEN |
Il token della pagina non è valido. |
CANNOT_UPDATE_DISABLED_LICENSE |
Impossibile aggiornare una licenza disattivata. |
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST |
Gli elenchi di utenti sensibili non possono essere concessi in licenza a questo cliente. |
INSUFFICIENT_COST |
Costo troppo basso per questa licenza. |
CANNOT_DISABLE_LICENSE |
La licenza del rivenditore non può essere disattivata perché è in uso. |
INVALID_CLIENT_ACCOUNT_ID |
ID account cliente non valido. |
PRICING_ONLY_ZERO_COST_ALLOWED |
Costo diverso da zero non consentito per questo account cliente. |
PRICE_TOO_HIGH |
Il costo è troppo elevato per questa licenza. |
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE |
Il cliente non è autorizzato a creare una licenza. |
INVALID_PRICING_END_DATE |
La data di fine dei prezzi non è valida per questa licenza. |
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT |
L'elenco logico degli utenti con un segmento condiviso o autorizzato non può essere autorizzato. |
MISMATCHED_ACCOUNT_TYPE |
Il tipo di account cliente del cliente nella richiesta non corrisponde al tipo di account effettivo del cliente. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE |
Il tipo di licenza non supporta il costo della quota di contenuti multimediali. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER |
Il tipo di cliente non supporta il costo della quota di media. |
INVALID_MEDIA_SHARE_COST |
Costo della quota media non valido. |
INVALID_COST_TYPE |
Tipo di costo non valido. |
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST |
Il tipo UserList non supporta il costo della condivisione di contenuti multimediali. |
MAX_COST_NOT_ALLOWED |
Il costo massimo è consentito solo per cost_type MEDIA_SHARE. |
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED |
Il segmento di pubblico Commerce può essere concesso in licenza solo direttamente. |
INVALID_DESCRIPTION |
La descrizione non è valida. |
INVALID_DISPLAY_NAME |
Il nome visualizzato non è valido. |
DISPLAY_NAME_ALREADY_USED |
Il nome visualizzato è già in uso per un altro elenco utenti dell'account. |
OWNERSHIP_REQUIRED_FOR_UPDATE |
La proprietà è necessaria per modificare l'elenco degli utenti. |
USER_LIST_MUTATION_NOT_SUPPORTED |
Il tipo di elenco utenti è di sola lettura e non supporta la mutazione. |
SENSITIVE_USER_LIST_IMMUTABLE |
Un elenco di utenti sensibile alla privacy o rifiutato per motivi legali non può essere modificato da utenti esterni. |
BILLABLE_RECORD_COUNT_IMMUTABLE |
Una volta impostato, il campo del record fatturabile dell'elenco di utenti per il remarketing non può essere modificato. |
USER_LIST_NAME_RESERVED |
Il nome dell'elenco utenti è riservato agli elenchi di sistema. |
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA |
L'inserzionista deve essere inserito nella lista consentita per utilizzare gli elenchi per il remarketing creati a partire dai dati caricati dall'inserzionista. |
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE |
L'origine del segmento di pubblico partner non è supportata per il tipo di elenco utenti. |
COMMERCE_PARTNER_NOT_ALLOWED |
L'impostazione del campo commerce_partner è supportata solo se partner_audience_source è COMMERCE_AUDIENCE. |
UNSUPPORTED_PARTNER_AUDIENCE_INFO |
Il campo partner_audience_info non è supportato per il tipo di elenco utenti. |
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED |
Gli elenchi utenti Partner Match non possono essere creati dagli account amministratore. |
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
Il partner di dati non è incluso nella lista consentita per THIRD_PARTY_PARTNER_DATA. |
ADVERTISER_TOS_NOT_ACCEPTED |
L'inserzionista non ha accettato i Termini di servizio del partner. |
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA |
L'inserzionista non è incluso nella lista consentita per THIRD_PARTY_PARTNER_DATA. |
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT |
Questo tipo di elenco utenti non è supportato per questo account. |
INVALID_COMMERCE_PARTNER |
Il campo commerce_partner non è valido. |
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE |
Il fornitore di dati non è incluso nella lista consentita per creare segmenti di pubblico commerciali. |
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES |
I tipi di chiavi di caricamento dell'elenco utenti non sono supportati. |
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG |
La configurazione delle informazioni dell'elenco utenti importato non è supportata. |
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE |
I tipi di account non sono supportati per il tipo di elenco utenti. |
UNSUPPORTED_ACCOUNT_TYPE_FOR_PARTNER_LINK |
I tipi di account non sono supportati per il collegamento del partner. |
Evento
Un evento che rappresenta un'interazione utente con il sito web o l'app di un inserzionista.
| Campi | |
|---|---|
destination_references[] |
Facoltativo. Stringa di riferimento utilizzata per determinare la destinazione. Se è vuoto, l'evento verrà inviato a tutti i |
transaction_id |
Facoltativo. L'identificatore univoco di questo evento. Obbligatorio per le conversioni che utilizzano più origini dati. |
event_timestamp |
Obbligatorio. L'ora in cui si è verificato l'evento. |
last_updated_timestamp |
Facoltativo. L'ultima volta che l'evento è stato aggiornato. |
user_data |
Facoltativo. Parti di dati forniti dall'utente, che rappresentano l'utente a cui è associato l'evento. |
consent |
Facoltativo. Informazioni sul fatto che l'utente associato abbia fornito diversi tipi di consenso. |
ad_identifiers |
Facoltativo. Identificatori e altre informazioni utilizzate per abbinare l'evento di conversione ad altre attività online (ad esempio clic sugli annunci). |
currency |
Facoltativo. Il codice valuta associato a tutti i valori monetari all'interno di questo evento. |
event_source |
Facoltativo. Indicatore del luogo in cui si è verificato l'evento (web, app, negozio fisico e così via). |
event_device_info |
Facoltativo. Informazioni raccolte sul dispositivo utilizzato (se presente) al momento dell'evento. |
cart_data |
Facoltativo. Informazioni sulla transazione e sugli articoli associati all'evento. |
custom_variables[] |
Facoltativo. Informazioni aggiuntive sulle coppie chiave/valore da inviare ai contenitori di conversione (azione di conversione o attività Floodlight). |
experimental_fields[] |
Facoltativo. Un elenco di coppie chiave/valore per i campi sperimentali che potrebbero essere promossi per far parte dell'API. |
user_properties |
Facoltativo. Informazioni valutate dall'inserzionista sull'utente al momento dell'evento. |
event_name |
Facoltativo. Il nome dell'evento. Obbligatorio per gli eventi GA4. |
client_id |
Facoltativo. Un identificatore univoco per l'istanza utente di un client web per questo stream web GA4. |
user_id |
Facoltativo. Un identificatore univoco per un utente, come definito dall'inserzionista. |
additional_event_parameters[] |
Facoltativo. Un bucket di parametri evento da includere nell'evento che non sono già stati specificati utilizzando altri campi strutturati. |
conversion_value |
Facoltativo. Il valore di conversione associato all'evento, per le conversioni basate sul valore. |
EventParameter
Parametro evento per gli eventi GA4.
| Campi | |
|---|---|
parameter_name |
Obbligatorio. Il nome del parametro da utilizzare. |
value |
Obbligatorio. La rappresentazione stringa del valore del parametro da impostare. |
EventSource
L'origine dell'evento.
| Enum | |
|---|---|
EVENT_SOURCE_UNSPECIFIED |
EventSource non specificato. Non deve mai essere utilizzato. |
WEB |
L'evento è stato generato da un browser web. |
APP |
L'evento è stato generato da un'app. |
IN_STORE |
L'evento è stato generato da una transazione in negozio. |
PHONE |
L'evento è stato generato da una chiamata. |
OTHER |
L'evento è stato generato da altre fonti. |
ExperimentalField
Campo sperimentale che rappresenta i campi non ufficiali.
| Campi | |
|---|---|
field |
Facoltativo. Il nome del campo da utilizzare. |
value |
Facoltativo. Il valore del campo da impostare. |
GcpWrappedKeyInfo
Informazioni sulla chiave di wrapping di Google Cloud Platform.
| Campi | |
|---|---|
key_type |
Obbligatorio. Il tipo di algoritmo utilizzato per criptare i dati. |
wip_provider |
Obbligatorio. Il provider di pool Workload Identity richiesto per utilizzare la KEK. |
kek_uri |
Obbligatorio. ID risorsa Cloud Key Management Service della piattaforma Google Cloud. Deve essere nel formato |
encrypted_dek |
Obbligatorio. La chiave di crittografia dei dati criptati con codifica base64. |
KeyType
Il tipo di algoritmo utilizzato per criptare i dati.
| Enum | |
|---|---|
KEY_TYPE_UNSPECIFIED |
Tipo di chiave non specificato. Non deve mai essere utilizzato. |
XCHACHA20_POLY1305 |
Algoritmo XChaCha20-Poly1305 |
Genere
Il tipo di genere demografico (ad esempio, femminile).
| Enum | |
|---|---|
GENDER_UNSPECIFIED |
Non specificato. |
GENDER_UNKNOWN |
Sconosciuto. |
GENDER_MALE |
Uomo. |
GENDER_FEMALE |
Donna. |
GetUserListDirectLicenseRequest
Richiesta per ottenere una risorsa UserListDirectLicense.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome risorsa della licenza diretta dell'elenco utenti. |
GetUserListGlobalLicenseRequest
Richiesta per ottenere una risorsa UserListGlobalLicense.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome risorsa della licenza globale dell'elenco utenti. |
GetUserListRequest
Messaggio di richiesta per GetUserList.
| Campi | |
|---|---|
name |
Obbligatorio. Il nome della risorsa UserList da recuperare. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
IngestAudienceMembersRequest
Richiedi di caricare i membri del segmento di pubblico nelle destinazioni fornite. Restituisce un IngestAudienceMembersResponse.
| Campi | |
|---|---|
destinations[] |
Obbligatorio. L'elenco delle destinazioni a cui inviare i membri del segmento di pubblico. |
audience_members[] |
Obbligatorio. L'elenco degli utenti da inviare alle destinazioni specificate. In una singola richiesta possono essere inviate al massimo 10.000 risorse |
consent |
Facoltativo. Consenso a livello di richiesta da applicare a tutti gli utenti della richiesta. Il consenso a livello di utente sostituisce il consenso a livello di richiesta e può essere specificato in ogni |
validate_only |
Facoltativo. A scopo di test. Se |
encoding |
Facoltativo. Obbligatorio per i caricamenti di |
encryption_info |
Facoltativo. Informazioni sulla crittografia per i caricamenti di |
terms_of_service |
Facoltativo. I Termini di servizio che l'utente ha accettato/rifiutato. |
IngestAudienceMembersResponse
Risposta da IngestAudienceMembersRequest.
| Campi | |
|---|---|
request_id |
L'ID generato automaticamente della richiesta. |
IngestEventsRequest
Richiedi di caricare i membri del segmento di pubblico nelle destinazioni fornite. Restituisce un IngestEventsResponse.
| Campi | |
|---|---|
destinations[] |
Obbligatorio. L'elenco delle destinazioni a cui inviare gli eventi. |
events[] |
Obbligatorio. L'elenco degli eventi da inviare alle destinazioni specificate. In una singola richiesta possono essere inviate al massimo 2000 risorse |
consent |
Facoltativo. Consenso a livello di richiesta da applicare a tutti gli utenti della richiesta. Il consenso a livello di utente sostituisce il consenso a livello di richiesta e può essere specificato in ogni |
validate_only |
Facoltativo. A scopo di test. Se |
encoding |
Facoltativo. Obbligatorio per i caricamenti di |
encryption_info |
Facoltativo. Informazioni sulla crittografia per i caricamenti di |
IngestEventsResponse
Risposta da IngestEventsRequest.
| Campi | |
|---|---|
request_id |
L'ID generato automaticamente della richiesta. |
IngestedUserListInfo
Rappresenta un elenco utenti compilato con i dati forniti dagli utenti.
| Campi | |
|---|---|
upload_key_types[] |
Obbligatorio. Immutabile. Tipi di chiavi di caricamento di questo elenco utenti. |
contact_id_info |
Facoltativo. Informazioni aggiuntive quando |
mobile_id_info |
Facoltativo. Informazioni aggiuntive quando |
user_id_info |
Facoltativo. Informazioni aggiuntive quando |
pair_id_info |
Facoltativo. Informazioni aggiuntive quando Questa funzionalità è disponibile solo per i partner di dati. |
pseudonymous_id_info |
Facoltativo. Ulteriori informazioni per |
partner_audience_info |
Facoltativo. Informazioni aggiuntive per i segmenti di pubblico dei partner. Questa funzionalità è disponibile solo per i partner di dati. |
UploadKeyType
Enumerazione contenente i possibili tipi di chiavi di caricamento di un elenco utenti.
| Enum | |
|---|---|
UPLOAD_KEY_TYPE_UNSPECIFIED |
Non specificato. |
CONTACT_ID |
Informazioni sul cliente, come indirizzo email, numero di telefono o indirizzo fisico. |
MOBILE_ID |
ID pubblicità mobile. |
USER_ID |
ID utente forniti da terze parti. |
PAIR_ID |
ID di riconciliazione dell'identità dell'inserzionista del publisher. |
PSEUDONYMOUS_ID |
ID piattaforma di gestione dei dati: - ID utente Google - ID fornito dal partner - ID fornito dal publisher - IDFA di iOS - ID pubblicità per Android - ID Roku - ID Amazon Fire TV - ID Xbox o Microsoft |
Elemento
Rappresenta un articolo nel carrello associato all'evento.
| Campi | |
|---|---|
merchant_product_id |
Facoltativo. L'ID prodotto all'interno dell'account Merchant Center. |
quantity |
Facoltativo. Il numero di questo elemento associato all'evento. |
unit_price |
Facoltativo. Il prezzo unitario al netto di tasse, spese di spedizione ed eventuali sconti a livello di transazione. |
item_id |
Facoltativo. Un identificatore univoco per fare riferimento all'elemento. |
additional_item_parameters[] |
Facoltativo. Un bucket di parametri evento correlati a un elemento da includere nell'evento che non sono già stati specificati utilizzando altri campi strutturati. |
ItemParameter
Un bucket di parametri evento correlati a un elemento da includere nell'evento che non sono già stati specificati utilizzando altri campi strutturati.
| Campi | |
|---|---|
parameter_name |
Obbligatorio. Il nome del parametro da utilizzare. |
value |
Obbligatorio. La rappresentazione stringa del valore del parametro da impostare. |
ListUserListDirectLicensesRequest
Richiesta di elencare tutte le risorse UserListDirectLicense per un determinato account.
| Campi | |
|---|---|
parent |
Obbligatorio. L'account le cui licenze sono oggetto della query. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Facoltativo. Filtri da applicare alla richiesta di elenco. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio: user_list_id = 123). Operazioni supportate:
Campi non supportati:
|
page_size |
Facoltativo. Il numero massimo di licenze da restituire per pagina. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non è specificato, verranno restituite al massimo 50 licenze. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. |
page_token |
Facoltativo. Un token di pagina, ricevuto da una precedente chiamata Durante la paginazione, tutti gli altri parametri forniti a |
ListUserListDirectLicensesResponse
Risposta da ListUserListDirectLicensesRequest.
| Campi | |
|---|---|
user_list_direct_licenses[] |
Le licenze per l'elenco utenti specificato nella richiesta. |
next_page_token |
Un token, che può essere inviato come |
ListUserListGlobalLicenseCustomerInfosRequest
Richiedi di elencare tutte le risorse UserListGlobalLicenseCustomerInfo per una determinata licenza globale di elenco utenti.
| Campi | |
|---|---|
parent |
Obbligatorio. La licenza globale di cui vengono richieste le informazioni sul cliente. Deve essere nel formato |
filter |
Facoltativo. Filtri da applicare alla richiesta di elenco. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio: user_list_id = 123). Operazioni supportate:
Campi non supportati:
|
page_size |
Facoltativo. Il numero massimo di licenze da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non è specificato, verranno restituite al massimo 50 licenze. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. |
page_token |
Facoltativo. Un token di pagina, ricevuto da una precedente chiamata Durante la paginazione, tutti gli altri parametri forniti a |
ListUserListGlobalLicenseCustomerInfosResponse
Risposta da [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].
| Campi | |
|---|---|
user_list_global_license_customer_infos[] |
Le informazioni sul cliente per la licenza specificata nella richiesta. |
next_page_token |
Un token, che può essere inviato come |
ListUserListGlobalLicensesRequest
Richiesta di elencare tutte le risorse UserListGlobalLicense per un determinato account.
| Campi | |
|---|---|
parent |
Obbligatorio. L'account le cui licenze sono oggetto della query. Deve essere nel formato accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} |
filter |
Facoltativo. Filtri da applicare alla richiesta di elenco. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio: user_list_id = 123). Operazioni supportate:
Campi non supportati:
|
page_size |
Facoltativo. Il numero massimo di licenze da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non è specificato, verranno restituite al massimo 50 licenze. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. |
page_token |
Facoltativo. Un token di pagina, ricevuto da una precedente chiamata Durante la paginazione, tutti gli altri parametri forniti a |
ListUserListGlobalLicensesResponse
Risposta da ListUserListGlobalLicensesRequest.
| Campi | |
|---|---|
user_list_global_licenses[] |
Le licenze per l'elenco utenti specificato nella richiesta. |
next_page_token |
Un token, che può essere inviato come |
ListUserListsRequest
Messaggio di richiesta per ListUserLists.
| Campi | |
|---|---|
parent |
Obbligatorio. L'account genitore proprietario di questa raccolta di elenchi utenti. Formato: accountTypes/{account_type}/accounts/{account} |
page_size |
Facoltativo. Il numero massimo di elenchi di utenti da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 50 elenchi di utenti. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. |
page_token |
Facoltativo. Un token di pagina, ricevuto da una precedente chiamata Durante la paginazione, tutti gli altri parametri forniti a |
filter |
Facoltativo. Una stringa di filtro. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio, Operazioni supportate:
Campi supportati:
|
ListUserListsResponse
Messaggio di risposta per ListUserLists.
| Campi | |
|---|---|
user_lists[] |
Gli elenchi di utenti dell'account specificato. |
next_page_token |
Un token, che può essere inviato come |
MatchRateRange
L'intervallo del tasso di corrispondenza del caricamento o dell'elenco utenti.
| Enum | |
|---|---|
MATCH_RATE_RANGE_UNKNOWN |
L'intervallo del tasso di corrispondenza è sconosciuto. |
MATCH_RATE_RANGE_NOT_ELIGIBLE |
L'intervallo del tasso di corrispondenza non è idoneo. |
MATCH_RATE_RANGE_LESS_THAN_20 |
L'intervallo del tasso di corrispondenza è inferiore al 20% (nell'intervallo [0, 20)). |
MATCH_RATE_RANGE_20_TO_30 |
L'intervallo del tasso di corrispondenza è compreso tra il 20% e il 30% (nell'intervallo [20, 31)). |
MATCH_RATE_RANGE_31_TO_40 |
L'intervallo del tasso di corrispondenza è compreso tra il 31% e il 40% (nell'intervallo [31, 41)). |
MATCH_RATE_RANGE_41_TO_50 |
L'intervallo del tasso di corrispondenza è compreso tra il 41% e il 50% (nell'intervallo [41, 51)). |
MATCH_RATE_RANGE_51_TO_60 |
L'intervallo del tasso di corrispondenza è compreso tra il 51% e il 60% (nell'intervallo [51, 61). |
MATCH_RATE_RANGE_61_TO_70 |
L'intervallo del tasso di corrispondenza è compreso tra il 61% e il 70% (nell'intervallo [61, 71)). |
MATCH_RATE_RANGE_71_TO_80 |
L'intervallo del tasso di corrispondenza è compreso tra il 71% e l'80% (nell'intervallo [71, 81)). |
MATCH_RATE_RANGE_81_TO_90 |
L'intervallo del tasso di corrispondenza è compreso tra l'81% e il 90% (nell'intervallo [81, 91)). |
MATCH_RATE_RANGE_91_TO_100 |
L'intervallo del tasso di corrispondenza è compreso tra il 91% e il 100% (nell'intervallo |
MobileData
ID mobile per il pubblico. È richiesto almeno un ID dispositivo mobile.
| Campi | |
|---|---|
mobile_ids[] |
Obbligatorio. L'elenco degli ID dispositivo mobile (ID pubblicità/IDFA). Possono essere forniti al massimo 10 |
MobileIdInfo
Informazioni aggiuntive quando MOBILE_ID è uno dei upload_key_types.
| Campi | |
|---|---|
data_source_type |
Facoltativo. Immutabile. Origine dei dati di caricamento. |
key_space |
Obbligatorio. Immutabile. Lo spazio delle chiavi degli ID mobile. |
app_id |
Obbligatorio. Immutabile. Una stringa che identifica in modo univoco un'applicazione mobile da cui sono stati raccolti i dati. |
KeySpace
Spazio chiave per l'ID mobile.
| Enum | |
|---|---|
KEY_SPACE_UNSPECIFIED |
Non specificato. |
IOS |
Lo spazio delle chiavi iOS. |
ANDROID |
Lo spazio delle chiavi Android. |
PairData
ID PAIR per il pubblico. È richiesto almeno un ID coppia.
Questa funzionalità è disponibile solo per i partner di dati.
| Campi | |
|---|---|
pair_ids[] |
Obbligatorio. Dati PII forniti dalla data clean room, sottoposti ad hashing con SHA256 e criptati con una cifratura commutativa EC utilizzando la chiave del publisher per l'elenco utenti PAIR. Possono essere forniti al massimo 10 |
PairIdInfo
Informazioni aggiuntive quando PAIR_ID è uno dei upload_key_types.
Questa funzionalità è disponibile solo per i partner di dati.
| Campi | |
|---|---|
match_rate_percentage |
Solo output. Questo campo indica la percentuale di corrispondenza dell'inclusione di questo elenco utenti con i dati proprietari del publisher corrispondente. Deve essere compreso tra 0 e 100 inclusi. |
advertiser_identifier_count |
Solo output. Il conteggio dei record di dati proprietari dell'inserzionista caricati in un fornitore di data clean room. Ciò non indica le dimensioni di un elenco di utenti PAIR. |
publisher_id |
Obbligatorio. Immutabile. Identifica l'editore con cui viene riconciliato l'elenco utenti Publisher Advertiser Identity Reconciliation. Questo campo è fornito dal fornitore della clean room ed è univoco solo nell'ambito di quella clean room. Non può essere utilizzato come identificatore globale in più cleanroom. |
publisher_name |
Facoltativo. Nome descrittivo del publisher da visualizzare nell'interfaccia utente per una migliore esperienza di targeting. |
clean_room_identifier |
Obbligatorio. Immutabile. Identifica una relazione univoca tra inserzionista e publisher con un fornitore di data clean room o con più fornitori. |
PartnerAudienceInfo
Informazioni aggiuntive per i segmenti di pubblico dei partner.
Questa funzionalità è disponibile solo per i partner di dati.
| Campi | |
|---|---|
partner_audience_source |
Obbligatorio. Immutabile. L'origine del segmento di pubblico partner. |
commerce_partner |
Facoltativo. Il nome del partner commerciale. Consentito solo se |
PartnerAudienceSource
Origine dati del pubblico partner.
| Enum | |
|---|---|
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED |
Non specificato. |
COMMERCE_AUDIENCE |
L'origine dati del pubblico partner è il segmento di pubblico commerciale. |
LINEAR_TV_AUDIENCE |
L'origine dati del pubblico del partner è il pubblico della TV lineare. |
AGENCY_PROVIDER_AUDIENCE |
L'origine dati del pubblico partner è il segmento di pubblico agenzia/fornitore. |
PartnerLink
Un collegamento partner tra un account proprietario e un account partner.
| Campi | |
|---|---|
name |
Identificatore. Il nome del link del partner. Formato: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link} |
partner_link_id |
Solo output. L'ID link partner. |
owning_account |
Obbligatorio. L'account proprietario che concede l'accesso all'account partner. |
partner_account |
Obbligatorio. L'account partner a cui è stato concesso l'accesso dall'account proprietario. |
PpidData
Dati degli identificatori forniti dal publisher contenenti i PPID. È richiesto almeno un ppid.
Questa funzionalità è disponibile solo per i partner di dati.
| Campi | |
|---|---|
ppids[] |
Obbligatorio. L'elenco degli identificatori forniti dal publisher per un utente. |
ProcessingErrorReason
Il motivo dell'errore di elaborazione.
| Enum | |
|---|---|
PROCESSING_ERROR_REASON_UNSPECIFIED |
Il motivo dell'errore di elaborazione è sconosciuto. |
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE |
La variabile personalizzata non è valida. |
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED |
Lo stato della variabile personalizzata non è attivato. |
PROCESSING_ERROR_REASON_EVENT_TOO_OLD |
La conversione è precedente all'età massima supportata. |
PROCESSING_ERROR_REASON_DENIED_CONSENT |
I dati utente dell'annuncio vengono rifiutati, dall'utente o nelle impostazioni predefinite dell'inserzionista. |
PROCESSING_ERROR_REASON_NO_CONSENT |
L'inserzionista non ha dato il consenso di terze parti per i servizi della piattaforma principale di Google Ads. |
PROCESSING_ERROR_REASON_UNKNOWN_CONSENT |
Il consenso complessivo (determinato dal consenso a livello di riga, dal consenso a livello di richiesta e dalle impostazioni dell'account) non è stato possibile determinarlo per questo utente |
PROCESSING_ERROR_REASON_DUPLICATE_GCLID |
Nel sistema esiste già una conversione con lo stesso GCLID e la stessa ora. |
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID |
È già stata caricata una conversione con la stessa combinazione di ID ordine e azione di conversione. |
PROCESSING_ERROR_REASON_INVALID_GBRAID |
Impossibile decodificare il GBRAID. |
PROCESSING_ERROR_REASON_INVALID_GCLID |
Non è stato possibile decodificare l'ID clic Google. |
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID |
L'ID commerciante contiene caratteri non numerici. |
PROCESSING_ERROR_REASON_INVALID_WBRAID |
Impossibile decodificare il WBRAID. |
PROCESSING_ERROR_REASON_INTERNAL_ERROR |
Errore interno. |
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED |
I termini delle conversioni avanzate non sono firmati nell'account di destinazione. |
PROCESSING_ERROR_REASON_INVALID_EVENT |
L'evento non è valido. |
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS |
Le transazioni corrispondenti sono inferiori alla soglia minima. |
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS |
Le transazioni sono inferiori alla soglia minima. |
PROCESSING_ERROR_REASON_INVALID_FORMAT |
L'evento presenta un errore di formato. |
PROCESSING_ERROR_REASON_DECRYPTION_ERROR |
L'evento presenta un errore di decrittografia. |
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR |
Impossibile decriptare la chiave DEK. |
PROCESSING_ERROR_REASON_INVALID_WIP |
Il WIP non è formattato correttamente o non esiste. |
PROCESSING_ERROR_REASON_INVALID_KEK |
La KEK non può decriptare i dati perché è la KEK errata o non esiste. |
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED |
L'intento WIP non può essere utilizzato perché è stato rifiutato dalla relativa condizione di attestazione. |
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED |
Il sistema non disponeva delle autorizzazioni necessarie per accedere alla KEK. |
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED |
Il sistema non è riuscito a eseguire l'autenticazione con AWS. |
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Impossibile decriptare i dati UserIdentifier utilizzando la chiave DEK. |
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER |
L'utente ha tentato di importare eventi con un identificatore pubblicità che non proviene dagli annunci dell'account operativo. |
ProcessingWarningReason
Il motivo dell'avviso di elaborazione.
| Enum | |
|---|---|
PROCESSING_WARNING_REASON_UNSPECIFIED |
Il motivo dell'avviso di elaborazione è sconosciuto. |
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED |
Il sistema non disponeva delle autorizzazioni necessarie per accedere alla KEK. |
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR |
Impossibile decriptare la chiave DEK. |
PROCESSING_WARNING_REASON_DECRYPTION_ERROR |
L'evento presenta un errore di decrittografia. |
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED |
L'intento WIP non può essere utilizzato perché è stato rifiutato dalla relativa condizione di attestazione. |
PROCESSING_WARNING_REASON_INVALID_WIP |
Il WIP non è formattato correttamente o non esiste. |
PROCESSING_WARNING_REASON_INVALID_KEK |
La KEK non può decriptare i dati perché è la KEK errata o non esiste. |
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR |
Impossibile decrittografare i dati UserIdentifier utilizzando la chiave DEK. |
PROCESSING_WARNING_REASON_INTERNAL_ERROR |
Errore interno. |
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED |
Il sistema non è riuscito a eseguire l'autenticazione con AWS. |
Prodotto
Deprecato. Utilizza invece AccountType
| Enum | |
|---|---|
PRODUCT_UNSPECIFIED |
Prodotto non specificato. Non deve mai essere utilizzato. |
GOOGLE_ADS |
Google Ads. |
DISPLAY_VIDEO_PARTNER |
Partner Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
Inserzionista Display & Video 360. |
DATA_PARTNER |
Partner di dati. |
ProductAccount
Rappresenta un account specifico.
| Campi | |
|---|---|
product |
Deprecato. Utilizza invece |
account_id |
Obbligatorio. L'ID dell'account. Ad esempio, l'ID account Google Ads. |
account_type |
Facoltativo. Il tipo di account. Ad esempio, |
AccountType
Rappresenta i tipi di Account Google. Utilizzato per individuare account e destinazioni.
| Enum | |
|---|---|
ACCOUNT_TYPE_UNSPECIFIED |
Prodotto non specificato. Non deve mai essere utilizzato. |
GOOGLE_ADS |
Google Ads. |
DISPLAY_VIDEO_PARTNER |
Partner Display & Video 360. |
DISPLAY_VIDEO_ADVERTISER |
Inserzionista Display & Video 360. |
DATA_PARTNER |
Partner di dati. |
GOOGLE_ANALYTICS_PROPERTY |
Google Analytics. |
GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Collegamento al segmento di pubblico Google Ad Manager. |
PseudonymousIdInfo
Informazioni aggiuntive quando PSEUDONYMOUS_ID è uno dei upload_key_types.
| Campi | |
|---|---|
sync_status |
Solo output. Stato della sincronizzazione dell'elenco utenti. |
billable_record_count |
Facoltativo. Immutabile. Il numero di record fatturabili (ad es. caricati o corrispondenti). |
SyncStatus
Stato della sincronizzazione dell'elenco utenti.
| Enum | |
|---|---|
SYNC_STATUS_UNSPECIFIED |
Non specificato. |
CREATED |
L'elenco utenti è stato creato come segnaposto. I contenuti e/o i metadati dell'elenco sono ancora in fase di sincronizzazione. L'elenco utenti non è pronto per l'uso. |
READY_FOR_USE |
L'elenco utenti è pronto per l'uso. I contenuti e i cookie sono stati sincronizzati correttamente. |
FAILED |
Si è verificato un errore durante la sincronizzazione dei contenuti e/o dei metadati dell'elenco utenti. L'elenco utenti non può essere utilizzato. |
RemoveAudienceMembersRequest
Richiedi la rimozione degli utenti da un segmento di pubblico nelle destinazioni fornite. Restituisce un valore RemoveAudienceMembersResponse.
| Campi | |
|---|---|
destinations[] |
Obbligatorio. L'elenco delle destinazioni da cui rimuovere gli utenti. |
audience_members[] |
Obbligatorio. L'elenco degli utenti da rimuovere. |
validate_only |
Facoltativo. A scopo di test. Se |
encoding |
Facoltativo. Obbligatorio per i caricamenti di |
encryption_info |
Facoltativo. Informazioni sulla crittografia per i caricamenti di |
RemoveAudienceMembersResponse
Risposta da RemoveAudienceMembersRequest.
| Campi | |
|---|---|
request_id |
L'ID generato automaticamente della richiesta. |
RequestStatusPerDestination
Uno stato della richiesta per destinazione.
| Campi | |
|---|---|
destination |
Una destinazione all'interno di una richiesta API DM. |
request_status |
Lo stato della richiesta della destinazione. |
error_info |
Un errore di informazioni sull'errore contenente il motivo e i conteggi degli errori relativi al caricamento. |
warning_info |
Informazioni di avviso contenenti il motivo dell'avviso e i conteggi degli avvisi relativi al caricamento. |
Campo unione status. Lo stato della destinazione. status può essere solo uno dei seguenti tipi: |
|
audience_members_ingestion_status |
Lo stato della richiesta di inserimento dei membri del segmento di pubblico. |
events_ingestion_status |
Lo stato della richiesta di eventi di importazione. |
audience_members_removal_status |
Lo stato della richiesta di rimozione dei membri del segmento di pubblico. |
IngestAudienceMembersStatus
Lo stato della richiesta di inserimento dei membri del segmento di pubblico.
| Campi | |
|---|---|
Campo unione status. Lo stato dell'importazione dei membri del segmento di pubblico nella destinazione. status può essere solo uno dei seguenti tipi: |
|
user_data_ingestion_status |
Lo stato dell'importazione dei dati utente nella destinazione. |
mobile_data_ingestion_status |
Lo stato dell'importazione dei dati mobili nella destinazione. |
pair_data_ingestion_status |
Lo stato dell'importazione dei dati della coppia nella destinazione. |
user_id_data_ingestion_status |
Lo stato dell'importazione dei dati dell'ID utente nella destinazione. |
ppid_data_ingestion_status |
Lo stato dell'importazione dei dati PPID nella destinazione. |
IngestEventsStatus
Lo stato dell'importazione degli eventi nella destinazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale degli eventi inviati nella richiesta di caricamento. Include tutti gli eventi nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
IngestMobileDataStatus
Lo stato dell'importazione dei dati mobili nella destinazione contenente le statistiche relative all'importazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
mobile_id_count |
Il conteggio totale degli ID dispositivo mobile inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID mobile nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
IngestPairDataStatus
Lo stato dell'importazione dei dati della coppia nella destinazione contenente le statistiche correlate all'importazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
pair_id_count |
Il conteggio totale degli ID coppia inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID coppia nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
IngestPpidDataStatus
Lo stato dell'importazione dei dati PPID nella destinazione contenente le statistiche correlate all'importazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
ppid_count |
Il conteggio totale degli ID pubblicità inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID pubblicità personale nella richiesta, indipendentemente dal fatto che siano stati importati correttamente o meno. |
IngestUserDataStatus
Lo stato dell'importazione dei dati utente nella destinazione contenente statistiche correlate all'importazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
user_identifier_count |
Il conteggio totale degli identificatori utente inviati nella richiesta di caricamento per la destinazione. Include tutti gli identificatori utente nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
upload_match_rate_range |
L'intervallo del tasso di corrispondenza del caricamento. |
IngestUserIdDataStatus
Lo stato dell'importazione dei dati dell'ID utente nella destinazione contenente statistiche relative all'importazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di caricamento per la destinazione. Include tutti i membri del pubblico nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
user_id_count |
Il conteggio totale degli ID utente inviati nella richiesta di caricamento per la destinazione. Include tutti gli ID utente nella richiesta, indipendentemente dal fatto che siano stati inseriti correttamente o meno. |
RemoveAudienceMembersStatus
Lo stato della richiesta di rimozione dei membri del segmento di pubblico.
| Campi | |
|---|---|
Campo unione status. Stato della rimozione dei membri del segmento di pubblico dalla destinazione. status può essere solo uno dei seguenti tipi: |
|
user_data_removal_status |
Lo stato della rimozione dei dati utente dalla destinazione. |
mobile_data_removal_status |
Lo stato della rimozione dei dati mobili dalla destinazione. |
pair_data_removal_status |
Lo stato della rimozione dei dati della coppia dalla destinazione. |
user_id_data_removal_status |
Lo stato della rimozione dei dati dello User-ID dalla destinazione. |
ppid_data_removal_status |
Lo stato della rimozione dei dati PPID dalla destinazione. |
RemoveMobileDataStatus
Lo stato della rimozione dei dati mobili dalla destinazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno. |
mobile_id_count |
Il conteggio totale degli ID dispositivo mobile inviati nella richiesta di rimozione. Include tutti gli ID mobile nella richiesta, indipendentemente dal fatto che siano stati rimossi o meno. |
RemovePairDataStatus
Lo stato della rimozione dei dati della coppia dalla destinazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno. |
pair_id_count |
Il conteggio totale degli ID coppia inviati nella richiesta di rimozione. Include tutti gli ID coppia nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno. |
RemovePpidDataStatus
Lo stato della rimozione dei dati PPID dalla destinazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno. |
ppid_count |
Il conteggio totale degli ID pubblicità inviati nella richiesta di rimozione. Include tutti gli ID pubblicità nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno. |
RemoveUserDataStatus
Lo stato della rimozione dei dati utente dalla destinazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno. |
user_identifier_count |
Il conteggio totale degli identificatori utente inviati nella richiesta di rimozione. Include tutti gli identificatori utente nella richiesta, indipendentemente dal fatto che siano stati rimossi o meno. |
RemoveUserIdDataStatus
Lo stato della rimozione dei dati dello User-ID dalla destinazione.
| Campi | |
|---|---|
record_count |
Il conteggio totale dei membri del segmento di pubblico inviati nella richiesta di rimozione. Include tutti i membri del segmento di pubblico nella richiesta, indipendentemente dal fatto che siano stati rimossi correttamente o meno. |
user_id_count |
Il conteggio totale degli ID utente inviati nella richiesta di rimozione. Include tutti gli ID utente nella richiesta, indipendentemente dal fatto che siano stati rimossi o meno. |
RequestStatus
Lo stato della richiesta.
| Enum | |
|---|---|
REQUEST_STATUS_UNKNOWN |
Lo stato della richiesta è sconosciuto. |
SUCCESS |
La richiesta è stata completata. |
PROCESSING |
La richiesta è in fase di elaborazione. |
FAILED |
Richiesta non riuscita. |
PARTIAL_SUCCESS |
La richiesta è riuscita parzialmente. |
RetrieveInsightsRequest
Messaggio di richiesta per DM API MarketingDataInsightsService.RetrieveInsights
| Campi | |
|---|---|
parent |
Obbligatorio. L'account genitore proprietario dell'elenco utenti. Formato: |
baseline |
Obbligatorio. Il valore di base per gli approfondimenti richiesti. |
user_list_id |
Obbligatorio. L'ID elenco utenti per cui vengono richieste informazioni. |
RetrieveInsightsResponse
Messaggio di risposta per DM API MarketingDataInsightsService.RetrieveInsights
| Campi | |
|---|---|
marketing_data_insights[] |
Contiene gli approfondimenti sui dati di marketing. |
MarketingDataInsight
Approfondimenti per i dati di marketing.
Questa funzionalità è disponibile solo per i partner di dati.
| Campi | |
|---|---|
dimension |
La dimensione a cui appartiene l'approfondimento. |
attributes[] |
Approfondimenti per i valori di una determinata dimensione. |
AudienceInsightsDimension
Dimensioni possibili da utilizzare per generare approfondimenti.
| Enum | |
|---|---|
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED |
Non specificato. |
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN |
Il valore è sconosciuto in questa versione. |
AFFINITY_USER_INTEREST |
Un UserInterest di affinità. |
IN_MARKET_USER_INTEREST |
Un UserInterest in-market. |
AGE_RANGE |
Una fascia d'età. |
GENDER |
Un genere. |
MarketingDataInsightsAttribute
Approfondimenti per una raccolta di attributi correlati della stessa dimensione.
| Campi | |
|---|---|
user_interest_id |
L'ID dell'interesse dell'utente. |
lift |
Misura dell'incremento che il pubblico ha per il valore dell'attributo rispetto al valore di base. Intervallo [0-1]. |
age_range |
La fascia d'età del pubblico per cui viene fornito il sollevamento. |
gender |
Il genere del pubblico per cui viene fornito l'incremento. |
RetrieveRequestStatusRequest
Richiesta per ottenere lo stato della richiesta effettuata all'API DM per un determinato ID richiesta. Restituisce un valore RetrieveRequestStatusResponse.
| Campi | |
|---|---|
request_id |
Obbligatorio. Obbligatorio. L'ID richiesta della richiesta dell'API Data Manager. |
RetrieveRequestStatusResponse
Risposta da RetrieveRequestStatusRequest.
| Campi | |
|---|---|
request_status_per_destination[] |
Un elenco degli stati delle richieste per destinazione. L'ordine degli stati corrisponde all'ordine delle destinazioni nella richiesta originale. |
SearchPartnerLinksRequest
Richiesta di ricerca di risorse PartnerLink. Restituisce un valore SearchPartnerLinksResponse.
| Campi | |
|---|---|
parent |
Obbligatorio. Account in cui cercare i link partner. Se non viene specificato alcun Formato: |
page_size |
Il numero massimo di link dei partner da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 10 link partner. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100. |
page_token |
Un token di pagina, ricevuto da una precedente chiamata Durante la paginazione, tutti gli altri parametri forniti a |
filter |
Facoltativo. Una stringa di filtro. Tutti i campi devono trovarsi sul lato sinistro di ogni condizione (ad esempio, Operazioni supportate:
Campi supportati:
Esempio: |
SearchPartnerLinksResponse
Risposta da SearchPartnerLinksRequest.
| Campi | |
|---|---|
partner_links[] |
I link partner per l'account specificato. |
next_page_token |
Un token, che può essere inviato come |
SizeInfo
Numero stimato di membri di questo elenco di utenti in diverse reti di destinazione.
| Campi | |
|---|---|
display_network_members_count |
Solo output. Numero stimato di membri di questo elenco utenti sulla Rete Display di Google. |
search_network_members_count |
Solo output. Numero stimato di membri di questo elenco utenti nel dominio google.com. Questi sono i membri disponibili per il targeting nelle campagne sulla rete di ricerca. |
TargetNetworkInfo
Informazioni sull'idoneità per diverse reti di destinazione.
| Campi | |
|---|---|
eligible_for_display |
Solo output. Indica che questo elenco utenti è idoneo per la Rete Display di Google. |
eligible_for_search |
Facoltativo. Indica se questo elenco di utenti è idoneo per la rete di ricerca Google. |
TermsOfService
I Termini di servizio che l'utente ha accettato/rifiutato.
| Campi | |
|---|---|
customer_match_terms_of_service_status |
Facoltativo. Termini di servizio di Customer Match: https://support.google.com/adspolicy/answer/6299717. Deve essere accettato durante l'importazione di |
TermsOfServiceStatus
Rappresenta la decisione del chiamante di accettare o rifiutare i termini di servizio.
| Enum | |
|---|---|
TERMS_OF_SERVICE_STATUS_UNSPECIFIED |
Non specificato. |
ACCEPTED |
Stato che indica che il chiamante ha scelto di accettare i termini di servizio. |
REJECTED |
Stato che indica che il chiamante ha scelto di rifiutare i termini di servizio. |
UpdateUserListDirectLicenseRequest
Richiedi l'aggiornamento di una risorsa UserListDirectLicense.
| Campi | |
|---|---|
user_list_direct_license |
Obbligatorio. Il campo |
update_mask |
Facoltativo. L'elenco dei campi da aggiornare. Il carattere speciale |
UpdateUserListGlobalLicenseRequest
Richiedi l'aggiornamento di una risorsa UserListGlobalLicense.
| Campi | |
|---|---|
user_list_global_license |
Obbligatorio. Il campo |
update_mask |
Facoltativo. L'elenco dei campi da aggiornare. Il carattere speciale |
UpdateUserListRequest
Messaggio di richiesta per UpdateUserList.
| Campi | |
|---|---|
user_list |
Obbligatorio. L'elenco utenti da aggiornare. Il campo |
update_mask |
Facoltativo. L'elenco dei campi da aggiornare. |
validate_only |
Facoltativo. Se impostato su true, la richiesta viene convalidata, ma non eseguita. |
UserData
Dati che identificano l'utente. È richiesto almeno un identificatore.
| Campi | |
|---|---|
user_identifiers[] |
Obbligatorio. Gli identificatori dell'utente. È possibile fornire più istanze dello stesso tipo di dati (ad esempio, più indirizzi email). Per aumentare la probabilità di una corrispondenza, fornisci il maggior numero possibile di identificatori. Possono essere forniti al massimo 10 |
UserIdData
Dati User-ID contenenti l'ID utente.
| Campi | |
|---|---|
user_id |
Obbligatorio. Un identificatore univoco per un utente, come definito dall'inserzionista. |
UserIdInfo
Informazioni aggiuntive quando USER_ID è uno dei upload_key_types.
| Campi | |
|---|---|
data_source_type |
Facoltativo. Immutabile. Origine dei dati di caricamento. |
UserIdentifier
Un unico identificatore per l'utente.
| Campi | |
|---|---|
Campo unione identifier. Deve essere specificato esattamente un valore. identifier può essere solo uno dei seguenti tipi: |
|
email_address |
Indirizzo email sottoposto ad hashing utilizzando la funzione hash SHA-256 dopo la normalizzazione. |
phone_number |
Numero di telefono sottoposto ad hashing utilizzando la funzione hash SHA-256 dopo la normalizzazione (standard E164). |
address |
I componenti noti dell'indirizzo di un utente. Contiene un raggruppamento di identificatori che vengono abbinati contemporaneamente. |
UserList
Una risorsa elenco degli utenti.
| Campi | |
|---|---|
name |
Identificatore. Il nome risorsa dell'elenco utenti. Formato: accountTypes/{account_type}/accounts/{account}/userLists/{user_list} |
id |
Solo output. L'ID univoco dell'elenco utenti. |
read_only |
Solo output. Un'opzione che indica se un utente può modificare un elenco. |
membership_duration |
Facoltativo. La durata per cui un utente rimane nell'elenco utenti. Le durate valide sono multipli esatti di 24 ore (86.400 secondi). Se fornisci un valore che non è un multiplo esatto di 24 ore, verrà generato un errore INVALID_ARGUMENT. |
access_reason |
Solo output. Il motivo per cui a questo account è stato concesso l'accesso all'elenco. |
size_info |
Solo output. Numero stimato di membri di questo elenco di utenti in diverse reti di destinazione. |
target_network_info |
Facoltativo. Informazioni sull'idoneità per diverse reti di destinazione. |
display_name |
Obbligatorio. Il nome visualizzato dell'elenco utenti. |
description |
Facoltativo. Una descrizione dell'elenco di utenti. |
membership_status |
Facoltativo. Stato dell'abbonamento di questo elenco di utenti. |
integration_code |
Facoltativo. Un ID del sistema esterno. Viene utilizzato dai venditori di elenchi di utenti per correlare gli ID sui loro sistemi. |
closing_reason |
Solo output. Il motivo per cui lo stato di abbonamento a questo elenco di utenti è chiuso. |
account_access_status |
Facoltativo. Indica se questa condivisione è ancora attiva. Quando un elenco di utenti viene condiviso con l'account, questo campo è impostato su |
Campo unione user_list_info. Informazioni aggiuntive sull'elenco di utenti. user_list_info può essere solo uno dei seguenti tipi: |
|
ingested_user_list_info |
Facoltativo. Rappresenta un elenco utenti compilato con i dati inseriti dagli utenti. |
AccessReason
Enumerazione che descrive i possibili motivi di accesso.
| Enum | |
|---|---|
ACCESS_REASON_UNSPECIFIED |
Non specificato. |
OWNED |
La risorsa è di proprietà dell'utente. |
SHARED |
La risorsa viene condivisa con l'utente. |
LICENSED |
La risorsa è concessa in licenza all'utente. |
SUBSCRIBED |
L'utente si è abbonato alla risorsa. |
AFFILIATED |
La risorsa è accessibile all'utente. |
AccessStatus
Indica se questo cliente ha ancora accesso alla lista.
| Enum | |
|---|---|
ACCESS_STATUS_UNSPECIFIED |
Non specificato. |
ENABLED |
L'accesso è attivato. |
DISABLED |
L'accesso è disattivato. |
ClosingReason
Indica il motivo per cui l'elenco utenti è stato chiuso. Questa enumerazione viene utilizzata solo quando un elenco viene chiuso automaticamente dal sistema.
| Enum | |
|---|---|
CLOSING_REASON_UNSPECIFIED |
Non specificato. |
UNUSED |
L'elenco di utenti è stato chiuso perché non è stato utilizzato di recente per il targeting. Per ulteriori dettagli, consulta la pagina https://support.google.com/google-ads/answer/2472738. |
MembershipStatus
Stato dell'elenco utenti.
| Enum | |
|---|---|
MEMBERSHIP_STATUS_UNSPECIFIED |
Non specificato. |
OPEN |
Stato aperto: l'elenco di utenti sta accumulando membri e può essere scelto come target. |
CLOSED |
Stato Chiuso: non vengono aggiunti nuovi membri. |
UserListDirectLicense
Una licenza diretta per l'elenco utenti.
Questa funzionalità è disponibile solo per i partner di dati.
| Campi | |
|---|---|
name |
Identificatore. Il nome risorsa della licenza diretta dell'elenco utenti. |
user_list_display_name |
Solo output. Nome dell'elenco utenti per cui viene concessa la licenza. Questo campo è di sola lettura. |
client_account_display_name |
Solo output. Nome del cliente del cliente a cui viene concessa la licenza dell'elenco utenti. Questo campo è di sola lettura. |
pricing |
Facoltativo. Prezzi di UserListDirectLicense. |
historical_pricings[] |
Solo output. Cronologia dei prezzi di questa licenza per l'elenco di utenti. Questo campo è di sola lettura. |
metrics |
Solo output. Metriche correlate a questa licenza Questo campo è di sola lettura e viene compilato solo se le date di inizio e di fine sono impostate nella chiamata ListUserListDirectLicenses |
user_list_id |
Immutabile. ID dell'elenco utenti per cui viene concessa la licenza. |
client_account_type |
Immutabile. Tipo di account del cliente a cui viene concessa la licenza per l'elenco utenti. |
client_account_id |
Immutabile. ID del cliente cliente a cui viene concessa la licenza dell'elenco utenti. |
status |
Facoltativo. Stato di UserListDirectLicense: ENABLED o DISABLED. |
UserListGlobalLicense
Una licenza globale per l'elenco utenti.
Questa funzionalità è disponibile solo per i partner di dati.
| Campi | |
|---|---|
name |
Identificatore. Il nome risorsa della licenza globale dell'elenco utenti. |
user_list_display_name |
Solo output. Nome dell'elenco utenti per cui viene concessa la licenza. Questo campo è di sola lettura. |
pricing |
Facoltativo. Prezzi delle licenze globali UserList. |
historical_pricings[] |
Solo output. Cronologia dei prezzi di questa licenza per l'elenco di utenti. Questo campo è di sola lettura. |
metrics |
Solo output. Metriche correlate a questa licenza Questo campo è di sola lettura e viene compilato solo se le date di inizio e di fine sono impostate nella chiamata ListUserListGlobalLicenses |
user_list_id |
Immutabile. ID dell'elenco utenti per cui viene concessa la licenza. |
license_type |
Immutabile. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti. |
status |
Facoltativo. Stato di UserListGlobalLicense: ENABLED o DISABLED. |
UserListGlobalLicenseCustomerInfo
Informazioni su un cliente di una licenza globale per l'elenco di utenti. Verrà creato automaticamente dal sistema quando un cliente acquista una licenza globale.
| Campi | |
|---|---|
name |
Identificatore. Il nome risorsa del cliente con licenza globale dell'elenco utenti. |
user_list_id |
Solo output. ID dell'elenco utenti per cui viene concessa la licenza. |
user_list_display_name |
Solo output. Nome dell'elenco utenti per cui viene concessa la licenza. |
license_type |
Solo output. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti. |
status |
Solo output. Stato di UserListDirectLicense: ENABLED o DISABLED. |
pricing |
Solo output. Prezzi di UserListDirectLicense. |
client_account_type |
Solo output. Tipo di prodotto del cliente a cui viene concessa la licenza dell'elenco utenti. |
client_account_id |
Solo output. ID del cliente cliente a cui viene concessa la licenza dell'elenco utenti. |
client_account_display_name |
Solo output. Nome del cliente del cliente a cui viene concessa la licenza dell'elenco utenti. |
historical_pricings[] |
Solo output. Cronologia dei prezzi di questa licenza per l'elenco di utenti. |
metrics |
Solo output. Metriche correlate a questa licenza Questo campo viene compilato solo se le date di inizio e fine sono impostate nella chiamata ListUserListGlobalLicenseCustomerInfos. |
UserListGlobalLicenseType
Tipi di licenze globali per gli elenchi utenti.
| Enum | |
|---|---|
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED |
NON SPECIFICATO. |
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER |
Licenza del rivenditore. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE |
Licenza DataMart Sell Side. |
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE |
Licenza DataMart Buy Side. |
UserListLicenseClientAccountType
Possibile prodotto di un account cliente per una licenza di elenco utenti.
| Enum | |
|---|---|
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN |
Sconosciuto. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS |
Cliente Google Ads. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER |
Partner Display & Video 360. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER |
Inserzionista Display & Video 360. |
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_AD_MANAGER_AUDIENCE_LINK |
Collegamento al segmento di pubblico Google Ad Manager. |
UserListLicenseMetrics
Metriche relative a una licenza per l'elenco di utenti.
| Campi | |
|---|---|
click_count |
Solo output. Il numero di clic per la licenza dell'elenco utenti. |
impression_count |
Solo output. Il numero di impressioni per la licenza dell'elenco utenti. |
revenue_usd_micros |
Solo output. Le entrate per la licenza dell'elenco utenti in micro USD. |
start_date |
Solo output. La data di inizio (inclusa) delle metriche nel formato AAAAMMGG. Ad esempio, 20260102 rappresenta il 2 gennaio 2026. Se |
end_date |
Solo output. La data di fine (inclusa) delle metriche nel formato AAAAMMGG. Ad esempio, 20260102 rappresenta il 2 gennaio 2026. Se |
UserListLicensePricing
Prezzi delle licenze per elenco utenti.
| Campi | |
|---|---|
pricing_id |
Solo output. L'ID di questo prezzo. |
start_time |
Solo output. Ora di inizio del prezzo. |
end_time |
Facoltativo. Ora di fine del prezzo. |
pricing_active |
Solo output. Indica se questi prezzi sono attivi. |
buyer_approval_state |
Solo output. Lo stato di approvazione dell'acquirente di questo prezzo. Questo campo è di sola lettura. |
cost_micros |
Facoltativo. Il costo associato al modello, in micro-unità (10^-6), nella valuta specificata dal campo currency_code. Ad esempio, 2000000 significa 2 $se |
currency_code |
Facoltativo. La valuta in cui sono specificati costo e max_cost. Deve essere un codice valuta di tre lettere definito nello standard ISO 4217. |
cost_type |
Immutabile. Il tipo di costo di questo prezzo. Può essere impostato solo nell'operazione |
max_cost_micros |
Facoltativo. Il CPM massimo che può essere addebitato a un pubblico commerciale quando viene utilizzato il tipo di costo MEDIA_SHARE. Il valore è in micro unità (10^-6) e nella valuta specificata dal campo currency_code. Ad esempio, 2000000 significa 2 $se Questo valore è pertinente solo quando cost_type è MEDIA_SHARE. Quando cost_type non è MEDIA_SHARE e questo campo è impostato, viene restituito un errore MAX_COST_NOT_ALLOWED. Se non viene impostato o viene impostato su |
UserListPricingBuyerApprovalState
Stato di approvazione dell'acquirente del prezzo dell'elenco utenti.
| Enum | |
|---|---|
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED |
NON SPECIFICATO. |
PENDING |
Il cliente dell'elenco di utenti non ha ancora accettato i termini di prezzo impostati dal proprietario dell'elenco di utenti. |
APPROVED |
Il client dell'elenco utenti ha accettato i termini di prezzo impostati dal proprietario dell'elenco utenti. |
REJECTED |
Il client dell'elenco utenti ha rifiutato i termini di prezzo impostati dal proprietario dell'elenco utenti. |
UserListPricingCostType
Tipo di costo per il prezzo dell'elenco di utenti.
| Enum | |
|---|---|
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED |
Non specificato. |
CPC |
Costo per clic. |
CPM |
Costo per mille impressioni. |
MEDIA_SHARE |
Quota dei contenuti multimediali. |
UserListLicenseStatus
Stato della licenza dell'elenco utenti.
| Enum | |
|---|---|
USER_LIST_LICENSE_STATUS_UNSPECIFIED |
Sconosciuto. |
USER_LIST_LICENSE_STATUS_ENABLED |
Stato attivo: la licenza dell'elenco utenti è ancora in corso. |
USER_LIST_LICENSE_STATUS_DISABLED |
Stato Inattivo: la licenza per l'elenco di utenti non è più attiva. |
UserProperties
Informazioni valutate dall'inserzionista sull'utente al momento dell'evento. Per maggiori dettagli, consulta la pagina https://support.google.com/google-ads/answer/14007601.
| Campi | |
|---|---|
customer_type |
Facoltativo. Tipo di cliente associato all'evento. |
customer_value_bucket |
Facoltativo. Il valore del cliente valutato dall'inserzionista. |
additional_user_properties[] |
Facoltativo. Un bucket di eventuali proprietà utente aggiuntive per l'utente associato a questo evento. |
UserProperty
Un bucket di eventuali proprietà utente aggiuntive per l'utente associato a questo evento.
| Campi | |
|---|---|
property_name |
Obbligatorio. Il nome della proprietà utente da utilizzare. |
value |
Obbligatorio. La rappresentazione stringa del valore della proprietà utente da utilizzare. |
WarningCount
Il conteggio degli avvisi per un determinato motivo.
| Campi | |
|---|---|
record_count |
Il conteggio dei record che presentano un avviso. |
reason |
Il motivo dell'avviso. |
WarningInfo
Conteggi degli avvisi per ogni tipo di avviso.
| Campi | |
|---|---|
warning_counts[] |
Un elenco di avvisi e conteggi per motivo dell'avviso. |