REST Resource: firstAndThirdPartyAudiences

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 (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.
}
Campos
name

string

Solo salida. Es el nombre de recurso del público propio y de terceros.

firstAndThirdPartyAudienceId

string (int64 format)

Solo salida. Indica el ID único del público propio y de terceros. Lo asigna el sistema.

displayName

string

Es el nombre visible del público de origen y el de terceros.

description

string

Es la descripción del público proporcionada por el usuario.

Solo se aplica a públicos propios.

firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

Si se trata de un público propio o de terceros

audienceType

enum (AudienceType)

Es el tipo de público.

audienceSource

enum (AudienceSource)

Solo salida. Es la fuente del público.

membershipDurationDays

string (int64 format)

Es el tiempo (en días) que una entrada 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 10000. De lo contrario, el valor establecido debe ser superior a 0 e inferior o igual a 540.

Solo se aplica a públicos propios.

Este campo es obligatorio si se usa uno de los siguientes audienceType:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

Solo salida. Indica el tamaño estimado del público para la Red de Display.

Si el tamaño es inferior a 1,000, el número se ocultará 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

string (int64 format)

Solo salida. Indica el tamaño estimado del público de la Red de Display durante el último mes.

Si el tamaño es inferior a 1,000, el número se ocultará 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

string (int64 format)

Solo salida. Es el tamaño estimado del público de la red de YouTube.

Si el tamaño es inferior a 1,000, el número se ocultará 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 públicos propios.

Solo se muestra en la solicitud GET.

gmailAudienceSize

string (int64 format)

Solo salida. Es el tamaño del público estimado para la red de Gmail.

Si el tamaño es inferior a 1,000, el número se ocultará 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 públicos propios.

Solo se muestra en la solicitud GET.

displayMobileAppAudienceSize

string (int64 format)

Solo salida. Indica el tamaño estimado del público de aplicaciones para dispositivos móviles en la Red de Display.

Si el tamaño es inferior a 1,000, el número se ocultará 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 públicos propios.

Solo se muestra en la solicitud GET.

displayMobileWebAudienceSize

string (int64 format)

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, el número se ocultará 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 públicos propios.

Solo se muestra en la solicitud GET.

displayDesktopAudienceSize

string (int64 format)

Solo salida. Es 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, el número se ocultará 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 públicos propios.

Solo se muestra en la solicitud GET.

appId

string

El appId coincide con el tipo de mobileDeviceIds que se está subiendo.

Solo se aplica a audienceType CUSTOMER_MATCH_DEVICE_ID

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

object (ContactInfoList)

Solo entrada. Una lista de información de contacto para definir los miembros iniciales del público.

Solo se aplica a audienceType CUSTOMER_MATCH_CONTACT_INFO

mobileDeviceIdList

object (MobileDeviceIdList)

Solo entrada. Es una lista de ID de dispositivos móviles para definir los miembros iniciales del público.

Solo se aplica a audienceType CUSTOMER_MATCH_DEVICE_ID

FirstAndThirdPartyAudienceType

Posibles tipos de un recurso de público propio 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 vinculación de los clientes con la información de contacto conocida.
CUSTOMER_MATCH_DEVICE_ID El público se generó a partir de la vinculación de 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 publicaron.

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 o canales de YouTube.
LICENSED Subtipo de 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 Creado en YouTube.
ADS_DATA_HUB Se originó en el Centro de Datos de Anuncios.

ContactInfoList

Mensaje de envoltorio para una lista de información de contacto que define a los miembros del público de Segmentación por clientes.

Representación JSON
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ]
}
Campos
contactInfos[]

object (ContactInfo)

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 la información de contacto no debe ser superior a 500,000.

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

string

Una lista de correos electrónicos del miembro con codificación hash SHA256. Antes de generar un hash, quita todos los espacios en blanco y asegúrate de que la string esté completamente en minúsculas.

hashedPhoneNumbers[]

string

Una lista de los números de teléfono del miembro con codificación hash SHA256. Antes de aplicar la codificación hash, todos los números de teléfono deben utilizar el formato E.164 y, además, incluir el código de llamada de país.

zipCodes[]

string

Una lista de los códigos postales del miembro.

También se debe configurar con los siguientes campos:

hashedFirstName

string

Es el nombre del miembro con hash SHA256. Antes de generar un hash, quita todos los espacios en blanco y asegúrate de que la string esté completamente en minúsculas.

También se debe configurar con los siguientes campos:

hashedLastName

string

Es el apellido del miembro con hash SHA256. Antes de generar un hash, quita todos los espacios en blanco y asegúrate de que la string esté completamente en minúsculas.

También se debe configurar con los siguientes campos:

countryCode

string

Es el código de país del miembro.

También se debe configurar con los siguientes campos:

MobileDeviceIdList

Mensaje de wrapper para una lista de ID de dispositivos móviles en el que se definen los miembros del público de Segmentación por clientes.

Representación JSON
{
  "mobileDeviceIds": [
    string
  ]
}
Campos
mobileDeviceIds[]

string

Es una lista de ID de dispositivos móviles en la que se definen los miembros del público de Segmentación por clientes. El tamaño de mobileDeviceIds no debe ser superior a 500,000.

Métodos

create

Crea un FirstAndThirdPartyAudience.

editCustomerMatchMembers

Actualiza la lista de miembros de un público de Segmentación por clientes.

get

Obtiene un público propio y de terceros.

list

Muestra una lista de públicos propios y de terceros.

patch

Actualiza un FirstAndThirdPartyAudience existente.