- Recurso: FirstAndThirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- Consentimiento
- ConsentStatus
- MobileDeviceIdList
- Métodos
Recurso: FirstAndThirdPartyAudience
Describe una lista de público propia o de terceros que se utiliza para la segmentación. Los públicos propios se crean a través del uso de datos del cliente. Los públicos de terceros son proporcionados por Proveedores de datos Externos y solo se les puede otorgar licencia a los clientes.
Representación JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
Campos | |
---|---|
name |
Solo salida. Es el nombre de recurso del público propio y de terceros. |
firstAndThirdPartyAudienceId |
Solo salida. Es el ID único del público de origen y el de terceros. Lo asigna el sistema. |
displayName |
Es el nombre visible del público de origen y el de terceros. |
description |
Es la descripción del público proporcionada por el usuario. Solo se aplica a los públicos propios. |
firstAndThirdPartyAudienceType |
Si se trata de un público propio o de terceros |
audienceType |
Es el tipo de público. |
audienceSource |
Solo salida. Es la fuente del público. |
membershipDurationDays |
Es el tiempo (expresado en días) que una postulación permanece en el público después del evento que califica. Si el público no tiene vencimiento, establece el valor de este campo en 10,000. De lo contrario, el valor establecido debe ser superior a 0 e inferior o igual a 540. Solo se aplica a los públicos propios. Este campo es obligatorio si se utiliza uno de los siguientes
|
displayAudienceSize |
Solo salida. Indica el tamaño estimado del público para la Red de Display. Si el tamaño es inferior a 1,000, se ocultará el número y se mostrará 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos. Solo se muestra en la solicitud GET. |
activeDisplayAudienceSize |
Solo salida. Indica el tamaño del público estimado para la Red de Display durante el último mes. Si el tamaño es inferior a 1,000, se ocultará el número y se mostrará 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos. Solo se muestra en la solicitud GET. |
youtubeAudienceSize |
Solo salida. Es el tamaño del público estimado para la red de YouTube. Si el tamaño es inferior a 1,000, se ocultará el número y se mostrará 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos. Solo se aplica a los públicos propios. Solo se muestra en la solicitud GET. |
gmailAudienceSize |
Solo salida. Indica el tamaño del público estimado para la red de Gmail. Si el tamaño es inferior a 1,000, se ocultará el número y se mostrará 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos. Solo se aplica a los públicos propios. Solo se muestra en la solicitud GET. |
displayMobileAppAudienceSize |
Solo salida. Indica el tamaño estimado del público de las aplicaciones para dispositivos móviles en la Red de Display. Si el tamaño es inferior a 1,000, se ocultará el número y se mostrará 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos. Solo se aplica a los públicos propios. Solo se muestra en la solicitud GET. |
displayMobileWebAudienceSize |
Solo salida. Indica el tamaño estimado del público de la Web móvil en la Red de Display. Si el tamaño es inferior a 1,000, se ocultará el número y se mostrará 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos. Solo se aplica a los públicos propios. Solo se muestra en la solicitud GET. |
displayDesktopAudienceSize |
Solo salida. Indica el tamaño estimado del público de computadoras de escritorio en la Red de Display. Si el tamaño es inferior a 1,000, se ocultará el número y se mostrará 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos. Solo se aplica a los públicos propios. Solo se muestra en la solicitud GET. |
appId |
El appId coincide con el tipo de los mobileDeviceIds que se están subiendo. Solo se aplica a |
Campo de unión members . Son los miembros iniciales del público de Segmentación por clientes. Las direcciones (members ) solo pueden ser una de las siguientes opciones: |
|
contactInfoList |
Solo entrada. Una lista con información de contacto para definir los miembros del público inicial. Solo se aplica a |
mobileDeviceIdList |
Solo entrada. Es una lista de ID de dispositivos móviles para definir los miembros iniciales del público. Solo se aplica a |
FirstAndThirdPartyAudienceType
Posibles tipos de recursos de público propios y de terceros.
Enumeradores | |
---|---|
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED |
El valor predeterminado cuando no se especifica el tipo o se desconoce. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY |
Público que se crea mediante el uso de datos del cliente. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY |
Público proporcionado por proveedores de datos externos. |
AudienceType
Tipos de públicos posibles.
Enumeradores | |
---|---|
AUDIENCE_TYPE_UNSPECIFIED |
El valor predeterminado cuando no se especifica el tipo o se desconoce. |
CUSTOMER_MATCH_CONTACT_INFO |
El público se generó a partir de la segmentación de los clientes con información de contacto conocida. |
CUSTOMER_MATCH_DEVICE_ID |
El público se generó vinculando los clientes con los ID de dispositivos móviles conocidos. |
CUSTOMER_MATCH_USER_ID |
El público se generó vinculando los clientes con los IDs de usuario conocidos. |
ACTIVITY_BASED |
El público se creó en función de la actividad de la campaña. |
FREQUENCY_CAP |
El público se creó en función de la cantidad de impresiones que se les mostraron. |
TAG_BASED |
El público se creó en función de las variables personalizadas adjuntas al píxel. |
YOUTUBE_USERS |
El público se creó en función de las interacciones anteriores con videos, anuncios de YouTube o canales de YouTube. |
LICENSED |
Subtipo del tipo de público de terceros. |
AudienceSource
Posibles fuentes de datos del público
Enumeradores | |
---|---|
AUDIENCE_SOURCE_UNSPECIFIED |
Es el valor predeterminado cuando no se especifica la fuente de datos del público o se desconoce. |
DISPLAY_VIDEO_360 |
Se originó en Display & Video 360. |
CAMPAIGN_MANAGER |
Se originó en Campaign Manager 360. |
AD_MANAGER |
Se originó en Google Ad Manager. |
SEARCH_ADS_360 |
Se originó en Search Ads 360. |
YOUTUBE |
Se originó en YouTube. |
ADS_DATA_HUB |
Se originó en el Centro de Datos de Anuncios. |
ContactInfoList
Mensaje de wrapper para una lista con información de contacto que define a los miembros del público de Segmentación por clientes.
Representación JSON |
---|
{ "contactInfos": [ { object ( |
Campos | |
---|---|
contactInfos[] |
Una lista de objetos ContactInfo que definen a los miembros del público de Segmentación por clientes. El tamaño de los miembros después de dividir los contactInfos no debe ser superior a 500,000. |
consent |
Solo entrada. Es la configuración de consentimiento para los usuarios de Si no estableces este campo, no se especificará el consentimiento. Si los campos |
ContactInfo
Información de contacto que define a un miembro del público de Segmentación por clientes
Representación JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
Campos | |
---|---|
hashedEmails[] |
Una lista de correos electrónicos con codificación hash SHA256 del miembro. Antes de generar la codificación hash, quita todos los espacios en blanco y asegúrate de que la cadena esté completamente en minúscula. |
hashedPhoneNumbers[] |
Una lista de números de teléfono con codificación hash SHA256 del miembro. Antes de generar la codificación hash, todos los números de teléfono deben utilizar el formato E.164 y deben incluir el código de llamada de país. |
zipCodes[] |
Una lista de los códigos postales del miembro. También se debe configurar con los siguientes campos: |
hashedFirstName |
Es el nombre del miembro con hash SHA256. Antes de generar la codificación hash, quita todos los espacios en blanco y asegúrate de que la cadena esté completamente en minúscula. También se debe configurar con los siguientes campos: |
hashedLastName |
Es el apellido del miembro con hash SHA256. Antes de generar la codificación hash, quita todos los espacios en blanco y asegúrate de que la cadena esté completamente en minúscula. También se debe configurar con los siguientes campos: |
countryCode |
Es el código de país del miembro. También se debe configurar con los siguientes campos: |
Consentimiento
Estado de consentimiento del usuario
Representación JSON |
---|
{ "adUserData": enum ( |
Campos | |
---|---|
adUserData |
Representa el consentimiento para los datos del usuario del anuncio. |
adPersonalization |
Representa el consentimiento para la personalización de anuncios. |
ConsentStatus
Estado del consentimiento.
Enumeradores | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
No se especificó el valor del tipo o se desconoce en esta versión. |
CONSENT_STATUS_GRANTED |
Se otorga el consentimiento. |
CONSENT_STATUS_DENIED |
Se rechaza el consentimiento. |
MobileDeviceIdList
Mensaje de wrapper para una lista de IDs de dispositivos móviles que define a los miembros del público de Segmentación por clientes.
Representación JSON |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
Campos | |
---|---|
mobileDeviceIds[] |
Lista de IDs de dispositivos móviles que definen a los miembros del público de Segmentación por clientes. El tamaño de mobileDeviceIds no debe ser superior a 500,000. |
consent |
Solo entrada. Es la configuración de consentimiento para los usuarios de Si no estableces este campo, no se especificará el consentimiento. Si los campos |
Métodos |
|
---|---|
|
Crea un elemento FirstAndThirdPartyAudience. |
|
Actualiza la lista de miembros de un público de Segmentación por clientes. |
|
Obtiene un público de origen y de terceros. |
|
Muestra una lista de públicos propios y de terceros. |
|
Actualiza un FirstAndThirdPartyAudience. |