REST Resource: firstAndThirdPartyAudiences

Recurso: FirstAndThirdPartyAudience

Descreve uma lista de público-alvo próprio ou de terceiros usada para segmentação. Os públicos-alvo próprios são criados usando dados de clientes. Os públicos-alvo de terceiros são fornecidos por provedores de dados de terceiros e só podem ser licenciados para clientes.

Representação 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

Apenas saída. O nome do recurso do público primário e de terceiros.
firstAndThirdPartyAudienceId

string (int64 format)

Apenas saída. O ID exclusivo do público-alvo próprio e de terceiros. Atribuído pelo sistema.
displayName

string

O nome de exibição do público-alvo próprio e de terceiros.
description

string

A descrição do público-alvo fornecida pelo usuário.

Aplicável apenas a públicos-alvo próprios.
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

Indica se o público-alvo é próprio ou de terceiros.
audienceType

enum (AudienceType)

O tipo de público-alvo.
audienceSource

enum (AudienceSource)

Apenas saída. É a origem do público-alvo.
membershipDurationDays

string (int64 format)

A duração em dias que uma entrada permanece no público-alvo após o evento qualificado. Se o público-alvo não tiver expiração, defina o valor desse campo como 10000. Caso contrário, o valor definido precisa ser maior que 0 e menor ou igual a 540.

Aplicável apenas a públicos-alvo próprios.

Este campo é obrigatório se um dos seguintes audienceType for usado:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

Apenas saída. O tamanho estimado do público-alvo da Rede de Display.

Se o tamanho for menor que 1.000, o número será ocultado e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Retornado apenas na solicitação GET.
activeDisplayAudienceSize

string (int64 format)

Apenas saída. O tamanho estimado do público-alvo da Rede de Display no último mês.

Se o tamanho for menor que 1.000, o número será ocultado e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Retornado apenas na solicitação GET.
youtubeAudienceSize

string (int64 format)

Apenas saída. O tamanho estimado do público-alvo da Rede de Display do YouTube.

Se o tamanho for menor que 1.000, o número será ocultado e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Aplicável apenas a públicos-alvo próprios.

Retornado apenas na solicitação GET.
gmailAudienceSize

string (int64 format)

Apenas saída. O tamanho estimado do público da rede do Gmail.

Se o tamanho for menor que 1.000, o número será ocultado e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Aplicável apenas a públicos-alvo próprios.

Retornado apenas na solicitação GET.
displayMobileAppAudienceSize

string (int64 format)

Apenas saída. O tamanho estimado do público-alvo do app para dispositivos móveis na Rede de Display.

Se o tamanho for menor que 1.000, o número será ocultado e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Aplicável apenas a públicos-alvo próprios.

Retornado apenas na solicitação GET.
displayMobileWebAudienceSize

string (int64 format)

Apenas saída. O tamanho estimado do público-alvo da Web para dispositivos móveis na Rede de Display.

Se o tamanho for menor que 1.000, o número será ocultado e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Aplicável apenas a públicos-alvo próprios.

Retornado apenas na solicitação GET.
displayDesktopAudienceSize

string (int64 format)

Apenas saída. O tamanho estimado do público-alvo de computadores na Rede de Display.

Se o tamanho for menor que 1.000, o número será ocultado e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Aplicável apenas a públicos-alvo próprios.

Retornado apenas na solicitação GET.
appId

string

O appId corresponde ao tipo de mobileDeviceIds que está sendo enviado.

Aplicável apenas a audienceType CUSTOMER_MATCH_DEVICE_ID
Campo de união members. Os membros iniciais do público-alvo segmentado por lista de clientes. members pode ser apenas de um dos tipos a seguir:
contactInfoList

object (ContactInfoList)

Somente entrada. Uma lista de dados de contato para definir os membros iniciais do público-alvo.

Válido apenas para audienceType CUSTOMER_MATCH_CONTACT_INFO
mobileDeviceIdList

object (MobileDeviceIdList)

Somente entrada. Uma lista de IDs de dispositivos móveis para definir os membros iniciais do público-alvo.

Válido apenas para audienceType CUSTOMER_MATCH_DEVICE_ID

FirstAndThirdPartyAudienceType

Tipos possíveis de um recurso de público-alvo próprio e de terceiros.

Enums
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED Valor padrão quando o tipo não é especificado ou é desconhecido.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY Público-alvo criado usando dados do cliente.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY Público-alvo fornecido por provedores de dados de terceiros.

AudienceType

Possíveis tipos de público-alvo.

Enums
AUDIENCE_TYPE_UNSPECIFIED Valor padrão quando o tipo não é especificado ou é desconhecido.
CUSTOMER_MATCH_CONTACT_INFO O público-alvo foi gerado ao fazer a correspondência entre os clientes e os dados de contato conhecidos.
CUSTOMER_MATCH_DEVICE_ID O público-alvo foi gerado pela correspondência de clientes com IDs de dispositivos móveis conhecidos.
CUSTOMER_MATCH_USER_ID O público-alvo foi gerado ao corresponder clientes a IDs de usuários conhecidos.
ACTIVITY_BASED

O público-alvo foi criado com base na atividade da campanha.
FREQUENCY_CAP

O público-alvo foi criado com base na exclusão do número de impressões veiculadas a eles.
TAG_BASED O público-alvo foi criado com base em variáveis personalizadas anexadas ao pixel.
YOUTUBE_USERS O público-alvo foi criado com base em interações anteriores com vídeos, anúncios do YouTube ou o canal da plataforma.
LICENSED Subtipo de público-alvo de terceiros.

AudienceSource

Possíveis origens de público-alvo.

Enums
AUDIENCE_SOURCE_UNSPECIFIED Valor padrão quando a origem de público-alvo não é especificada ou é desconhecida.
DISPLAY_VIDEO_360 Originado no Display & Video 360.
CAMPAIGN_MANAGER Originada no Campaign Manager 360.
AD_MANAGER Originado do Google Ad Manager.
SEARCH_ADS_360 Originado do Search Ads 360.
YOUTUBE Origem do YouTube.
ADS_DATA_HUB Origem do Ads Data Hub.

ContactInfoList

Mensagem de wrapper para uma lista de dados de contato que definem os membros do público-alvo segmentado por lista de clientes.

Representação JSON 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
Campos
contactInfos[]

object (ContactInfo)

Uma lista de objetos ContactInfo que definem os membros do público-alvo segmentado por lista de clientes. O tamanho dos membros após a divisão dos contactInfos não pode ser maior que 500.000.
consent

object (Consent)

Somente entrada. A configuração de consentimento dos usuários em contactInfos.

Se esse campo não for definido, significa que o consentimento não foi especificado.

Se os campos adUserData ou adPersonalization forem definidos como CONSENT_STATUS_DENIED, a solicitação vai retornar um erro.

ContactInfo

Dados de contato que definem um membro do público-alvo segmentado por lista de clientes.

Representação JSON 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
Campos
hashedEmails[]

string

Uma lista de e-mails com hash SHA256 do membro. Antes de gerar o hash, remova todos os espaços em branco e verifique se a string está em letras minúsculas.
hashedPhoneNumbers[]

string

Uma lista de números de telefone com hash SHA256 do membro. Antes de gerar hash, todos os números de telefone precisam estar formatados usando o formato E.164 e incluir o código de chamada do país.
zipCodes[]

string

Uma lista de CEPs do membro.

Também precisa ser definido com os seguintes campos:
hashedFirstName

string

Nome do membro com hash SHA256. Antes de gerar o hash, remova todos os espaços em branco e verifique se a string está em letras minúsculas.

Também precisa ser definido com os seguintes campos:
hashedLastName

string

Sobrenome do membro com hash SHA256. Antes do hash, remova todos os espaços em branco e verifique se a string está toda em letras minúsculas.

Também precisa ser definido com os seguintes campos:
countryCode

string

Código do país do membro.

Também precisa ser definido com os seguintes campos:

ConsentStatus

Status do consentimento.

Enums
CONSENT_STATUS_UNSPECIFIED O valor do tipo não foi especificado ou é desconhecido nesta versão.
CONSENT_STATUS_GRANTED O consentimento foi concedido.
CONSENT_STATUS_DENIED O consentimento foi negado.

MobileDeviceIdList

Mensagem de wrapper para uma lista de IDs de dispositivos móveis que definem os membros do público-alvo segmentado por lista de clientes.

Representação JSON 
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
Campos
mobileDeviceIds[]

string

Uma lista de IDs de dispositivos móveis que definem os membros do público-alvo segmentado por lista de clientes. O tamanho de mobileDeviceIds não pode ser maior que 500.000.
consent

object (Consent)

Somente entrada. A configuração de consentimento dos usuários em mobileDeviceIds.

Se esse campo não for definido, significa que o consentimento não foi especificado.

Se os campos adUserData ou adPersonalization forem definidos como CONSENT_STATUS_DENIED, a solicitação vai retornar um erro.

Métodos

create

 Cria um FirstAndThirdPartyAudience.

editCustomerMatchMembers

 Atualiza a lista de participantes de um público-alvo com Segmentação por lista de clientes.

get

 Recebe um público-alvo próprio e de terceiros.

list

 Lista públicos-alvo próprios e de terceiros.

patch

 Atualiza uma FirstAndThirdPartyAudience.