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 com o uso de dados do cliente. Os públicos-alvo de terceiros são fornecidos por provedores de dados terceirizados 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-alvo próprio 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

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

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

enum (FirstAndThirdPartyAudienceType)

Se o público é 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)

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

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

Esse campo será obrigatório se uma das seguintes audienceType for usada:

  • 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 ficará oculto e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Retornado somente 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 ficará oculto e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

Retornado somente na solicitação GET.
youtubeAudienceSize

string (int64 format)

Apenas saída. É o tamanho estimado do público da rede do YouTube.

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

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

Retornado somente na solicitação GET.
gmailAudienceSize

string (int64 format)

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

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

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

Retornado somente 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 ficará oculto e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

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

Retornado somente 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 ficará oculto e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

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

Retornado somente 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 ficará oculto e 0 será retornado por motivos de privacidade. Caso contrário, o número será arredondado para dois dígitos significativos.

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

Retornado somente 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)

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

Aplicável apenas a audienceType CUSTOMER_MATCH_CONTACT_INFO
mobileDeviceIdList

object (MobileDeviceIdList)

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

Aplicável apenas a audienceType CUSTOMER_MATCH_DEVICE_ID

FirstAndThirdPartyAudienceType

Tipos possíveis de 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 com o uso de 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 corresponder clientes a dados de contato conhecidos.
CUSTOMER_MATCH_DEVICE_ID O público-alvo foi gerado pela correspondência entre clientes e IDs de dispositivos móveis conhecidos.
CUSTOMER_MATCH_USER_ID O público-alvo foi gerado pela correspondência entre clientes e 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 excluindo o número de impressões veiculadas.
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 ou canal do YouTube.
LICENSED Subtipo de tipo 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 Criado no Display & Video 360.
CAMPAIGN_MANAGER Criado no Campaign Manager 360.
AD_MANAGER Tem origem no Google Ad Manager.
SEARCH_ADS_360 Criado no Search Ads 360.
YOUTUBE Proveniente do YouTube.
ADS_DATA_HUB Criado no Ads Data Hub.

ContactInfoList

Mensagem de wrapper para uma lista de dados de contato que definem os participantes 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 membros do público-alvo segmentado por lista de clientes. O tamanho dos membros após a divisão dos contactInfo não pode ser maior que 500.000.
consent

object (Consent)

Apenas entrada. A configuração de consentimento para os usuários em contactInfos.

Se esse campo não for definido, o consentimento não será especificado.

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

ContactInfo

Dados de contato que definem um participante 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 do hash, remova todos os espaços em branco e verifique se a string está toda em minúsculas.
hashedPhoneNumbers[]

string

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

string

Uma lista de CEPs do membro.

Precisa também ser definido com os seguintes campos:
hashedFirstName

string

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

Precisa também ser definido com os seguintes campos:
hashedLastName

string

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

Precisa também ser definido com os seguintes campos:
countryCode

string

Código do país do membro.

Precisa também ser definido com os seguintes campos:

ConsentStatus

Status do consentimento.

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

MobileDeviceIdList

Mensagem de wrapper para uma lista de IDs de dispositivos móveis que definem os participantes 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 dos mobileDeviceIds não pode ser maior que 500.000.
consent

object (Consent)

Apenas entrada. A configuração de consentimento para os usuários em mobileDeviceIds.

Se esse campo não for definido, o consentimento não será especificado.

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

Métodos

create

 Cria um FirstAndThirdPartyAudience.

editCustomerMatchMembers

 Atualiza a lista de participantes de um público-alvo segmentado 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 um FirstAndThirdPartyAudience existente.