- Risorsa: FirstAndthirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Consenso
- ConsentStatus
- MobileDeviceIdList
- Metodi
Risorsa: FirstAnd ThirdPartyAudience
Descrive un elenco del segmento di pubblico proprietario o di terze parti utilizzato per il targeting. I segmenti di pubblico proprietari vengono creati tramite l'utilizzo dei dati dei clienti. I segmenti di pubblico di terze parti sono forniti da fornitori di dati di terze parti e possono essere concessi in licenza solo ai clienti.
Rappresentazione JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
Campi | |
---|---|
name |
Solo output. Il nome della risorsa del segmento di pubblico proprietario e di terze parti. |
firstAndThirdPartyAudienceId |
Solo output. L'ID univoco del segmento di pubblico proprietario e di terze parti. Assegnato dal sistema. |
displayName |
Il nome visualizzato del segmento di pubblico proprietario e di terze parti. |
description |
La descrizione del segmento di pubblico fornita dall'utente. Applicabile solo ai segmenti di pubblico proprietari. |
firstAndThirdPartyAudienceType |
Se il segmento di pubblico è proprietario o di terze parti. |
audienceType |
Il tipo di pubblico. |
audienceSource |
Solo output. L'origine del pubblico. |
membershipDurationDays |
La durata in giorni in cui una voce rimane nel pubblico dopo l'evento idoneo. Se il segmento di pubblico non ha scadenza, imposta il valore di questo campo su 10.000. In caso contrario, il valore impostato deve essere maggiore di 0 e minore o uguale a 540. Applicabile solo ai segmenti di pubblico proprietari. Questo campo è obbligatorio se si utilizza uno dei seguenti
|
displayAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico per la Rete Display. Se la dimensione è inferiore a 1000, il numero verrà nascosto e verrà restituito 0 per motivi di privacy. In caso contrario, il numero verrà arrotondato a due cifre significative. Restituito solo nella richiesta GET. |
activeDisplayAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico per la Rete Display nell'ultimo mese. Se la dimensione è inferiore a 1000, il numero verrà nascosto e verrà restituito 0 per motivi di privacy. In caso contrario, il numero verrà arrotondato a due cifre significative. Restituito solo nella richiesta GET. |
youtubeAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico per la rete YouTube. Se la dimensione è inferiore a 1000, il numero verrà nascosto e verrà restituito 0 per motivi di privacy. In caso contrario, il numero verrà arrotondato a due cifre significative. Applicabile solo ai segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
gmailAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico per la rete Gmail. Se la dimensione è inferiore a 1000, il numero verrà nascosto e verrà restituito 0 per motivi di privacy. In caso contrario, il numero verrà arrotondato a due cifre significative. Applicabile solo ai segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
displayMobileAppAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico di app per dispositivi mobili nella Rete Display. Se la dimensione è inferiore a 1000, il numero verrà nascosto e verrà restituito 0 per motivi di privacy. In caso contrario, il numero verrà arrotondato a due cifre significative. Applicabile solo ai segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
displayMobileWebAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico per il Web mobile nella Rete Display. Se la dimensione è inferiore a 1000, il numero verrà nascosto e verrà restituito 0 per motivi di privacy. In caso contrario, il numero verrà arrotondato a due cifre significative. Applicabile solo ai segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
displayDesktopAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico su computer nella Rete Display. Se la dimensione è inferiore a 1000, il numero verrà nascosto e verrà restituito 0 per motivi di privacy. In caso contrario, il numero verrà arrotondato a due cifre significative. Applicabile solo ai segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
appId |
L'appId corrisponde al tipo di mobileDeviceIds che stai caricando. Applicabile solo a |
Campo di unione members . I membri iniziali del segmento di pubblico Customer Match. members può essere solo uno dei seguenti: |
|
contactInfoList |
Solo input. Un elenco di dati di contatto per definire i membri iniziali del segmento di pubblico. Applicabile solo a |
mobileDeviceIdList |
Solo input. Un elenco di ID dispositivo mobile per definire i membri iniziali del segmento di pubblico. Applicabile solo a |
FirstAndThirdPartyAudienceType
Possibili tipi di risorse dei segmenti di pubblico proprietari e di terze parti.
Enum | |
---|---|
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED |
Valore predefinito quando il tipo non è specificato o è sconosciuto. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY |
Segmento di pubblico creato tramite l'utilizzo dei dati dei clienti. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY |
Pubblico fornito da fornitori di dati di terze parti. |
AudienceType
Possibili tipi di segmenti di pubblico.
Enum | |
---|---|
AUDIENCE_TYPE_UNSPECIFIED |
Valore predefinito quando il tipo non è specificato o è sconosciuto. |
CUSTOMER_MATCH_CONTACT_INFO |
Il pubblico è stato generato abbinando i clienti ai dati di contatto noti. |
CUSTOMER_MATCH_DEVICE_ID |
Il pubblico è stato generato abbinando i clienti agli ID di dispositivi mobili noti. |
CUSTOMER_MATCH_USER_ID |
Il segmento di pubblico è stato generato abbinando i clienti agli ID utente noti. |
ACTIVITY_BASED |
Il segmento di pubblico è stato creato in base all'attività della campagna. |
FREQUENCY_CAP |
Il segmento di pubblico è stato creato in base all'esclusione del numero di impressioni pubblicate. |
TAG_BASED |
Il segmento di pubblico è stato creato in base a variabili personalizzate associate a pixel. |
YOUTUBE_USERS |
Il segmento di pubblico è stato creato in base alle interazioni passate con video, annunci di YouTube o canali YouTube. |
LICENSED |
Sottotipo di tipo di segmento di pubblico di terze parti. |
AudienceSource
Possibili origini dati del pubblico.
Enum | |
---|---|
AUDIENCE_SOURCE_UNSPECIFIED |
Valore predefinito quando l'origine dati del pubblico non è specificata o è sconosciuta. |
DISPLAY_VIDEO_360 |
Destinato a Display & Video 360. |
CAMPAIGN_MANAGER |
È stato creato da Campaign Manager 360. |
AD_MANAGER |
Destinato a Google Ad Manager. |
SEARCH_ADS_360 |
Destinato a Search Ads 360. |
YOUTUBE |
Hanno origine da YouTube. |
ADS_DATA_HUB |
Ha avuto origine da Ads Data Hub. |
ContactInfoList
Messaggio wrapper per un elenco di dati di contatto che definiscono i membri del segmento di pubblico Customer Match.
Rappresentazione JSON |
---|
{ "contactInfos": [ { object ( |
Campi | |
---|---|
contactInfos[] |
Un elenco di oggetti ContactInfo che definiscono i membri del segmento di pubblico Customer Match. Le dimensioni dei membri dopo la suddivisione dei contactInfo non devono essere superiori a 500.000. |
consent |
Solo input. L'impostazione del consenso per gli utenti in Se questo campo non viene configurato, il consenso non è specificato. Se i campi |
ContactInfo
Dati di contatto che definiscono un membro del segmento di pubblico Customer Match.
Rappresentazione JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
Campi | |
---|---|
hashedEmails[] |
Un elenco di indirizzi email sottoposti ad hashing SHA256 del membro. Prima di eseguire l'hashing, rimuovi tutti gli spazi vuoti e assicurati che la stringa sia tutta in minuscolo. |
hashedPhoneNumbers[] |
Un elenco di numeri di telefono sottoposti ad hashing SHA256 del membro. Prima di eseguire l'hashing, tutti i numeri di telefono devono essere formattati utilizzando il formato E.164 e includere il prefisso internazionale. |
zipCodes[] |
Un elenco di codici postali dei membri. Deve inoltre essere impostato con i seguenti campi: |
hashedFirstName |
Nome del membro sottoposto ad hashing SHA256. Prima di eseguire l'hashing, rimuovi tutti gli spazi vuoti e assicurati che la stringa sia tutta in minuscolo. Deve inoltre essere impostato con i seguenti campi: |
hashedLastName |
Cognome del membro sottoposto ad hashing SHA256. Prima di eseguire l'hashing, rimuovi tutti gli spazi vuoti e assicurati che la stringa sia tutta in minuscolo. Deve inoltre essere impostato con i seguenti campi: |
countryCode |
Codice paese del membro. Deve inoltre essere impostato con i seguenti campi: |
Consenso
Stato del consenso degli utenti.
Rappresentazione JSON |
---|
{ "adUserData": enum ( |
Campi | |
---|---|
adUserData |
Rappresenta il consenso per i dati utente degli annunci. |
adPersonalization |
Rappresenta il consenso per la personalizzazione degli annunci. |
ConsentStatus
Stato del consenso.
Enum | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
Il valore del tipo non è specificato o è sconosciuto in questa versione. |
CONSENT_STATUS_GRANTED |
Il consenso è stato concesso. |
CONSENT_STATUS_DENIED |
Consenso negato. |
MobileDeviceIdList
Messaggio wrapper per un elenco di ID dispositivo mobile che definiscono i membri del segmento di pubblico Customer Match.
Rappresentazione JSON |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
Campi | |
---|---|
mobileDeviceIds[] |
Un elenco di ID dispositivi mobili che definiscono i membri del segmento di pubblico Customer Match. La dimensione di mobileDeviceIds non deve essere maggiore di 500.000. |
consent |
Solo input. L'impostazione del consenso per gli utenti in Se questo campo non viene configurato, il consenso non è specificato. Se i campi |
Metodi |
|
---|---|
|
Crea un FirstAndthirdPartyAudience. |
|
Aggiorna l'elenco dei membri di un segmento di pubblico Customer Match. |
|
Consente di acquisire un segmento di pubblico proprietario e di terze parti. |
|
Elenca i segmenti di pubblico proprietari e di terze parti. |
|
Aggiorna un FirstAnd ThirdPartyAudience esistente. |