REST Resource: firstAndThirdPartyAudiences

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 (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
Campi
name

string

Solo output. Il nome della risorsa del segmento di pubblico proprietario e di terze parti.
firstAndThirdPartyAudienceId

string (int64 format)

Solo output. L'ID univoco del segmento di pubblico proprietario e di terze parti. Assegnato dal sistema.
displayName

string

Il nome visualizzato del segmento di pubblico proprietario e di terze parti.
description

string

La descrizione del segmento di pubblico fornita dall'utente.

Applicabile solo ai segmenti di pubblico proprietari.
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

Se il segmento di pubblico è proprietario o di terze parti.
audienceType

enum (AudienceType)

Il tipo di pubblico.
audienceSource

enum (AudienceSource)

Solo output. L'origine del pubblico.
membershipDurationDays

string (int64 format)

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 audienceType:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

L'appId corrisponde al tipo di mobileDeviceIds che stai caricando.

Applicabile solo a audienceType CUSTOMER_MATCH_DEVICE_ID
Campo di unione members. I membri iniziali del segmento di pubblico Customer Match. members può essere solo uno dei seguenti:
contactInfoList

object (ContactInfoList)

Solo input. Un elenco di dati di contatto per definire i membri iniziali del segmento di pubblico.

Applicabile solo a audienceType CUSTOMER_MATCH_CONTACT_INFO
mobileDeviceIdList

object (MobileDeviceIdList)

Solo input. Un elenco di ID dispositivo mobile per definire i membri iniziali del segmento di pubblico.

Applicabile solo a audienceType CUSTOMER_MATCH_DEVICE_ID

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 (ContactInfo)
    }
  ]
}
Campi
contactInfos[]

object (ContactInfo)

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.

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[]

string

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[]

string

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[]

string

Un elenco di codici postali dei membri.

Deve inoltre essere impostato con i seguenti campi:
hashedFirstName

string

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

string

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

string

Codice paese del membro.

Deve inoltre essere impostato con i seguenti campi:

MobileDeviceIdList

Messaggio wrapper per un elenco di ID dispositivo mobile che definiscono i membri del segmento di pubblico Customer Match.

Rappresentazione JSON 
{
  "mobileDeviceIds": [
    string
  ]
}
Campi
mobileDeviceIds[]

string

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.

Metodi

create

 Crea un FirstAndthirdPartyAudience.

editCustomerMatchMembers

 Aggiorna l'elenco dei membri di un segmento di pubblico Customer Match.

get

 Consente di acquisire un segmento di pubblico proprietario e di terze parti.

list

 Elenca i segmenti di pubblico proprietari e di terze parti.

patch

 Aggiorna un FirstAnd ThirdPartyAudience esistente.