REST Resource: firstAndThirdPartyAudiences

Recurso: FirstAndThirdPartyAudience

Descreve uma lista de público-alvo própria ou de terceiros usada para segmentação. Os públicos-alvo próprios são criados com o uso de dados do cliente. 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 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)

Se o público é primário 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 um vídeo permanece no público-alvo após o evento de qualificação. Se o público-alvo 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 apenas 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 zero 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 ficará oculto e zero 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 da rede do YouTube.

Se o tamanho for menor que 1.000, o número ficará oculto e zero 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 ficará oculto e zero 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 de apps para dispositivos móveis na Rede de Display.

Se o tamanho for menor que 1.000, o número ficará oculto e zero 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 ficará oculto e zero 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 ficará oculto e zero 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.

Aplicável apenas a 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.

Aplicável apenas a 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 com o uso de dados do cliente.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY Público-alvo fornecido por provedores de dados terceirizados.

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 pela correspondência de clientes com IDs de usuário 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.
TAG_BASED O público-alvo foi criado com base em variáveis personalizadas anexadas ao pixel.
YOUTUBE_USERS O público foi criado com base nas interações anteriores com vídeos, anúncios ou canal do YouTube.
LICENSED Subtipo do 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 Criados no Display & Vídeo em 360°.
CAMPAIGN_MANAGER Origem do Campaign Manager 360.
AD_MANAGER Origem do Google Ad Manager.
SEARCH_ADS_360 Origem 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 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. 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 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 do hash, remova todos os espaços em branco e verifique se a string está toda em letras minúsculas.
hashedPhoneNumbers[]

string

Uma lista de números de telefone com hash SHA256 do membro. Antes de usar o hash, todos os números de telefone precisam ser 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 com hash do membro em 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:
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 de consentimento.

Enums
CONSENT_STATUS_UNSPECIFIED O valor do tipo não foi especificado ou é desconhecido nesta versão.
CONSENT_STATUS_GRANTED O consentimento foi dado.
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 dos mobileDeviceIds não pode ser maior que 500.000.
consent

object (Consent)

Somente entrada. 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 retornará um erro.

Métodos

create

 Cria um FirstAndThirdPartyAudience.

editCustomerMatchMembers

 Atualiza a lista de membros de um público-alvo segmentado por lista de clientes.

get

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

list

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

patch

 Atualiza um FirstAndThirdPartyAudience existente.