REST Resource: firstPartyAndPartnerAudiences

Risorsa: FirstPartyAndPartnerAudience

Descrive un elenco dei segmenti di pubblico proprietari o dei partner utilizzato per il targeting. I segmenti di pubblico proprietari vengono creati tramite l'utilizzo dei dati dei clienti. I segmenti di pubblico partner vengono forniti da fornitori di dati di terze parti e possono essere concessi in licenza solo ai clienti.

Rappresentazione JSON 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of mutually exclusive fields.
}
Campi
name

string

Solo output. Il nome della risorsa del segmento di pubblico proprietario e di partner.
firstPartyAndPartnerAudienceId

string (int64 format)

Identificatore. L'ID univoco del segmento di pubblico proprietario e di partner. Assegnato dal sistema.
displayName

string

Facoltativo. Il nome visualizzato del segmento di pubblico proprietario e di partner.
description

string

Facoltativo. La descrizione del segmento di pubblico fornita dall'utente.

Applicabile solo ai segmenti di pubblico proprietari.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

Solo output. Indica se il segmento di pubblico è proprietario e di partner.
audienceType

enum (AudienceType)

Immutabile. Il tipo di pubblico.
audienceSource

enum (AudienceSource)

Solo output. L'origine del pubblico.
membershipDurationDays

string (int64 format)

Facoltativo. La durata in giorni per cui una voce rimane nel pubblico dopo l'evento qualificante. 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 viene utilizzato 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 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.
displayMobileWebAudienceSize

string (int64 format)

Solo output. La dimensione stimata del segmento di pubblico 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 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.

Applicabile solo ai segmenti di pubblico proprietari.

Restituito solo nella richiesta GET.
appId

string

Facoltativo. L'appId corrisponde al tipo di mobileDeviceIds caricati.

Applicabile solo a audienceType CUSTOMER_MATCH_DEVICE_ID
I membri iniziali del segmento di pubblico Customer Match. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
contactInfoList

object (ContactInfoList)

Solo input. Un elenco di informazioni 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
Fine dei campi che si escludono a vicenda.

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)
    }
  ],
  "consent": {
    object (Consent)
  }
}
Campi
contactInfos[]

object (ContactInfo)

Facoltativo. Un elenco di oggetti ContactInfo che definiscono i membri del segmento di pubblico Customer Match. La dimensione dei membri dopo la suddivisione di contactInfos non deve essere superiore a 500.000.
consent

object (Consent)

Solo input. L'impostazione del consenso per gli utenti in contactInfos.

Se questo campo non è impostato, significa che il consenso non è specificato.

Se i campi adUserData o adPersonalization sono impostati su CONSENT_STATUS_DENIED, la richiesta restituirà un errore.

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

Facoltativo. Un elenco di email con hash SHA256 del membro. Prima dell'hashing, rimuovi tutti gli spazi bianchi e assicurati che la stringa sia tutta in minuscolo.
hashedPhoneNumbers[]

string

Facoltativo. Un elenco di numeri di telefono sottoposti ad hashing SHA256 del membro. Prima dell'hashing, tutti i numeri di telefono devono essere formattati utilizzando il formato E.164 e includere il codice paese.
zipCodes[]

string

Facoltativo. Un elenco dei codici postali del membro.

Deve essere impostato anche con i seguenti campi:
hashedFirstName

string

Facoltativo. Nome sottoposto ad hashing SHA256 del membro. Prima dell'hashing, rimuovi tutti gli spazi bianchi e assicurati che la stringa sia tutta in minuscolo.

Deve essere impostato anche con i seguenti campi:
hashedLastName

string

Facoltativo. Cognome sottoposto ad hashing SHA256 del membro. Prima dell'hashing, rimuovi tutti gli spazi bianchi e assicurati che la stringa sia tutta in minuscolo.

Deve essere impostato anche con i seguenti campi:
countryCode

string

Facoltativo. Il codice paese del membro.

Deve essere impostato anche con i seguenti campi:

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 dato.
CONSENT_STATUS_DENIED Il 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 (Consent)
  }
}
Campi
mobileDeviceIds[]

string

Facoltativo. Un elenco di ID dispositivo mobile che definiscono i membri del segmento di pubblico Customer Match. La dimensione di mobileDeviceIds non deve essere superiore a 500.000.
consent

object (Consent)

Solo input. L'impostazione del consenso per gli utenti in mobileDeviceIds.

Se questo campo non è impostato, significa che il consenso non è specificato.

Se i campi adUserData o adPersonalization sono impostati su CONSENT_STATUS_DENIED, la richiesta restituirà un errore.

FirstPartyAndPartnerAudienceType

Possibili tipi di risorsa del segmento di pubblico proprietario e di partner.

Enum
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED Valore predefinito quando il tipo non è specificato o è sconosciuto.
TYPE_FIRST_PARTY Segmento di pubblico creato tramite l'utilizzo dei dati dei clienti.
TYPE_PARTNER 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 segmento di pubblico è stato generato tramite la corrispondenza dei clienti con dati di contatto noti.
CUSTOMER_MATCH_DEVICE_ID Il segmento di pubblico è stato generato tramite la corrispondenza dei clienti con ID dispositivo mobile noti.
CUSTOMER_MATCH_USER_ID Il segmento di pubblico è stato generato tramite la corrispondenza dei clienti con gli ID utente noti.
ACTIVITY_BASED

Deprecato: il segmento di pubblico è stato creato in base all'attività della campagna.
FREQUENCY_CAP

Ritirato: 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 alle variabili personalizzate associate al pixel.
YOUTUBE_USERS Il pubblico è stato creato in base alle interazioni passate con i video, gli annunci di YouTube o il canale YouTube.
THIRD_PARTY Il segmento di pubblico è stato concesso in licenza per l'utilizzo da una terza parte.
COMMERCE Segmento di pubblico fornito dai partner commerciali a pagamento.
LINEAR Pubblico per i contenuti TV lineari.
AGENCY Pubblico fornito da un'agenzia.

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 Ha avuto origine in Display & Video 360.
CAMPAIGN_MANAGER Originato da Campaign Manager 360.
AD_MANAGER Originato da Google Ad Manager.
SEARCH_ADS_360 Originato da Search Ads 360.
YOUTUBE Origine: YouTube.
ADS_DATA_HUB Originato da Ads Data Hub.

Metodi

create

 Crea un oggetto FirstPartyAndPartnerAudience.

editCustomerMatchMembers

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

get

 Recupera un segmento di pubblico proprietario o di partner.

list

 Elenca i segmenti di pubblico proprietari e di partner.

patch

 Aggiorna un FirstPartyAndPartnerAudience esistente.