REST Resource: firstPartyAndPartnerAudiences

Recurso: FirstPartyAndPartnerAudience

Describe una lista de público de origen o de socios que se usa para la segmentación. Los públicos propios se crean a partir del uso de los datos de los clientes. Los proveedores de datos externos proporcionan los públicos de socios, y solo se pueden otorgar licencias de ellos a los clientes.

Representación 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
}
Campos
name

string

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

string (int64 format)

Es el identificador. Es el ID único del público propio y del socio. Asignado por el sistema.
displayName

string

Opcional. Es el nombre visible del público propio y del socio.
description

string

Opcional. Es la descripción del público que proporciona el usuario.

Solo se aplica a los públicos propios.
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

Solo salida. Indica si el público es propio y de socios.
audienceType

enum (AudienceType)

Inmutable. Es el tipo de público.
audienceSource

enum (AudienceSource)

Solo salida. Es la fuente del público.
membershipDurationDays

string (int64 format)

Opcional. Es la duración en días que una entrada permanece en el público después del evento apto. El valor establecido debe ser mayor que 0 y menor o igual que 540.

Solo se aplica a los 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. Es 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 devolverá 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos.

Solo se devuelve en la solicitud GET.
activeDisplayAudienceSize

string (int64 format)

Solo salida. Es 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, se ocultará el número y se devolverá 0 por motivos de privacidad. De lo contrario, el número se redondeará a dos dígitos significativos.

Solo se devuelve en la solicitud GET.
youtubeAudienceSize

string (int64 format)

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

Si el tamaño es inferior a 1,000, se ocultará el número y se devolverá 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 devuelve en la solicitud GET.
gmailAudienceSize

string (int64 format)

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

Si el tamaño es inferior a 1,000, se ocultará el número y se devolverá 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 devuelve en la solicitud GET.
displayMobileAppAudienceSize

string (int64 format)

Solo salida. Es el tamaño estimado del público de la app 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 devolverá 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 devuelve en la solicitud GET.
displayMobileWebAudienceSize

string (int64 format)

Solo salida. Es 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 devolverá 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 devuelve 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, se ocultará el número y se devolverá 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 devuelve en la solicitud GET.
appId

string

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

Solo se aplica a audienceType CUSTOMER_MATCH_DEVICE_ID

FirstPartyAndPartnerAudienceType

Son los tipos posibles de un recurso de público propio y de socios.

Enums
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED Es el valor predeterminado cuando no se especifica el tipo o es desconocido.
TYPE_FIRST_PARTY Es el público que se crea a través del uso de los datos del cliente.
TYPE_PARTNER Es el público que proporcionan los proveedores de datos externos.

AudienceType

Son los posibles tipos de públicos.

Enums
AUDIENCE_TYPE_UNSPECIFIED Es el valor predeterminado cuando no se especifica el tipo o es desconocido.
CUSTOMER_MATCH_CONTACT_INFO El público se generó correlacionando a los clientes con información de contacto conocida.
CUSTOMER_MATCH_DEVICE_ID El público se generó a través de la coincidencia de clientes con IDs de dispositivos móviles conocidos.
CUSTOMER_MATCH_USER_ID El público se generó mediante la correlación de clientes con IDs de usuario conocidos.
ACTIVITY_BASED

Obsoleto: El público se creó en función de la actividad de la campaña.
FREQUENCY_CAP

Obsoleto: El público se creó en función de la exclusión de la cantidad de impresiones que se 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 de YouTube o el canal de YouTube.
THIRD_PARTY Se otorgó una licencia de uso del público a un tercero.
COMMERCE Es el público que proporcionan los socios comerciales por una tarifa.
LINEAR Es el público del contenido de TV lineal.
AGENCY Público proporcionado por una agencia.

AudienceSource

Son las posibles fuentes de datos del público.

Enums
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.

Métodos

get

 Obtiene un público propio o de un socio.

list

 Muestra una lista de los públicos propios y de socios.