- Risorsa: FirstAndthirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Consenso
- ConsentStatus
- MobileDeviceIdList
- Metodi
Risorsa: FirstAndthirdPartyAudience
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. Valido solo per i segmenti di pubblico proprietari. |
firstAndThirdPartyAudienceType |
Se il segmento di pubblico è proprietario o di terze parti. |
audienceType |
Il tipo di pubblico. |
audienceSource |
Solo output. La sorgente del pubblico. |
membershipDurationDays |
Il periodo di tempo in cui un video rimane visibile al 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. Valido solo per i segmenti di pubblico proprietari. Questo campo è obbligatorio se viene utilizzato 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. Valido solo per i 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. Valido solo per i segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
displayMobileAppAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico per app 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. Valido solo per i 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. Valido solo per i segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
displayDesktopAudienceSize |
Solo output. La dimensione stimata del segmento di pubblico su computer desktop 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. Valido solo per i segmenti di pubblico proprietari. Restituito solo nella richiesta GET. |
appId |
L'appId corrisponde al tipo di mobileDeviceId che viene caricato. 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 dispositivi mobili per definire i membri iniziali del 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 attraverso la corrispondenza dei clienti con ID dispositivo mobile noti. |
CUSTOMER_MATCH_USER_ID |
Il segmento di pubblico è stato generato attraverso la corrispondenza dei clienti con 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 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 |
Sono nate da Display & Video 360. |
CAMPAIGN_MANAGER |
Sono nate in Campaign Manager 360. |
AD_MANAGER |
Sono nate in Google Ad Manager. |
SEARCH_ADS_360 |
Sono nate in Search Ads 360. |
YOUTUBE |
Provenienza da YouTube. |
ADS_DATA_HUB |
Originario da Ads Data Hub. |
ContactInfoList
Messaggio wrapper per un elenco di informazioni 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 maggiori di 500.000. |
consent |
Solo input. L'impostazione relativa al consenso per gli utenti in Se questo campo non viene configurato, il consenso non è stato 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 email del membro sottoposte ad hashing SHA256. 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 nel formato E.164 e includere il prefisso internazionale. |
zipCodes[] |
Un elenco di codici postali dei membri. Deve essere impostato anche 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 essere impostato anche 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 essere impostato anche con i seguenti campi: |
countryCode |
Codice paese del membro. Deve essere impostato anche con i seguenti campi: |
Consenso
Stato del consenso degli utenti.
Rappresentazione JSON |
---|
{ "adUserData": enum ( |
Campi | |
---|---|
adUserData |
Rappresenta il consenso per i dati utente dell'annuncio. |
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 viene 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 dispositivo mobile che definiscono i membri del segmento di pubblico Customer Match. La dimensione degli ID mobileDevice non deve essere maggiore di 500.000. |
consent |
Solo input. L'impostazione relativa al consenso per gli utenti in Se questo campo non viene configurato, il consenso non è stato specificato. Se i campi |
Metodi |
|
---|---|
|
Crea un FirstAndthirdPartyAudience. |
|
Aggiorna l'elenco dei membri di un segmento di pubblico Customer Match. |
|
Acquisisci un segmento di pubblico proprietario e di terze parti. |
|
Elenca i segmenti di pubblico proprietari e di terze parti. |
|
Aggiorna un segmento di pubblico FirstAndthirdPartyAudience esistente. |