REST Resource: advertisers

Recurso: anunciante

É um único anunciante no Display & Video 360 (DV360).

Representação JSON 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean
}
Campos
name

string

Apenas saída. O nome do recurso do anunciante.
advertiserId

string (int64 format)

Apenas saída. O ID exclusivo do anunciante. Atribuído pelo sistema.
partnerId

string (int64 format)

Obrigatório. Imutável. O ID exclusivo do parceiro ao qual o anunciante pertence.
displayName

string

Obrigatório. O nome de exibição do anunciante.

Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
entityStatus

enum (EntityStatus)

Obrigatório. Controla se os pedidos de inserção e os itens de linha do anunciante podem gastar os orçamentos e dar lances no inventário.

  • Os valores aceitos são ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED e ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Se definido como ENTITY_STATUS_SCHEDULED_FOR_DELETION, o anunciante será excluído 30 dias após a data de agendamento da primeira exclusão.
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o anunciante foi atualizado pela última vez. Atribuído pelo sistema.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
generalConfig

object (AdvertiserGeneralConfig)

Obrigatório. Configurações gerais do anunciante.
adServerConfig

object (AdvertiserAdServerConfig)

Obrigatório. Imutável. Configurações relacionadas ao servidor de anúncios do anunciante.
creativeConfig

object (AdvertiserCreativeConfig)

Obrigatório. Configurações relacionadas ao criativo do anunciante.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Configurações que controlam como os dados do anunciante podem ser acessados.
integrationDetails

object (IntegrationDetails)

Detalhes da integração do anunciante. No momento, apenas integrationCode é aplicável ao anunciante. Outros campos de IntegrationDetails não são aceitos e serão ignorados, se fornecidos.
servingConfig

object (AdvertiserTargetingConfig)

Configurações de segmentação relacionadas à veiculação de anúncios do anunciante.
prismaEnabled

boolean

Se a integração com o Mediaocean (Prisma) está ativada. Ao ativar essa opção, você concorda com o seguinte:

Em nome da minha empresa, eu autorizo a Mediaocean (Prisma) a enviar planos de segmento de orçamento ao Google e autorizo o Google a enviar relatórios e faturas correspondentes do DV360 à Mediaocean para fins de planejamento de orçamento, faturamento e reconciliação para este anunciante.

AdvertiserGeneralConfig

São as configurações gerais de um anunciante.

Representação JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Campos
domainUrl

string

Obrigatório. O URL de domínio do site principal do anunciante. O sistema vai enviar essas informações aos editores que solicitam que o URL do site associe uma campanha a um anunciante.

Forneça um URL sem caminho ou string de consulta, começando com http: ou https:. Por exemplo, http://www.example.com
timeZone

string

Apenas saída. O nome padrão do banco de dados TZ do fuso horário do anunciante. Por exemplo, America/New_York.

Saiba mais em: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Para anunciantes híbridos do CM360, o fuso horário é o mesmo da conta associada do CM360. Para anunciantes somente de terceiros, o fuso horário é o mesmo do parceiro pai.
currencyCode

string

Obrigatório. Imutável. Moeda do anunciante no formato ISO 4217.

Os códigos aceitos e as moedas que eles representam são:

Código da moeda : nome da moeda

  • ARS : peso argentino
  • AUD : dólar australiano
  • BRL : real brasileiro
  • CAD : dólar canadense
  • CHF : franco suíço
  • CLP : peso chileno
  • CNY : Yuan chinês
  • COP : peso colombiano
  • CZK : coroa tcheca
  • DKK : coroa dinamarquesa
  • EGP : libra egípcia
  • EUR : euro
  • GBP : libra esterlina
  • HKD : dólar de Hong Kong
  • HUF : forint húngara
  • IDR : rúpia indonésia
  • ILS : shekel israelense
  • INR : rúpia indiana
  • JPY : iene japonês
  • KRW : won sul-coreano
  • MXN : pesos mexicanos
  • MYR : ringgit malaio
  • NGN : naira nigeriana
  • NOK : coroa norueguesa
  • NZD : dólar neozelandês
  • PEN : novo sol peruano
  • PLN : zloti polonês
  • RON : novo leu romeno
  • RUB : rublo russo
  • SEK : coroa sueca
  • TRY : lira turca
  • TWD : novo dólar taiwanês
  • USD : dólar americano
  • ZAR : rand sul-africano

AdvertiserAdServerConfig

Configurações relacionadas ao servidor de anúncios de um anunciante.

Representação JSON 
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Campos
Campo de união ad_server_config_scheme. Obrigatório. ad_server_config_scheme pode ser apenas de um dos tipos a seguir:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

A configuração para anunciantes que usam apenas servidores de anúncios de terceiros.
cmHybridConfig

object (CmHybridConfig)

É a configuração para anunciantes que usam o Campaign Manager 360 (CM360) e servidores de anúncios de terceiros.

ThirdPartyOnlyConfig

Configurações para anunciantes que usam apenas servidores de anúncios de terceiros.

Representação JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
Campos
pixelOrderIdReportingEnabled

boolean

Se o relatório de ID do pedido para pixels está ativado ou não. Não será possível mudar esse valor depois de definido como true.

CmHybridConfig

Configurações para anunciantes que usam o Campaign Manager 360 (CM360) e servidores de anúncios de terceiros.

Representação JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Campos
cmAccountId

string (int64 format)

Obrigatório. Imutável. É o ID da conta da configuração do Floodlight do CM360 vinculada ao anunciante do DV360.
cmFloodlightConfigId

string (int64 format)

Obrigatório. Imutável. ID da configuração do Floodlight do CM360 vinculada ao anunciante do DV360.
cmSyncableSiteIds[]

string (int64 format)

Uma lista de sites do CM360 com posições que serão sincronizadas com o DV360 como criativos.

Se ausente ou vazio no método advertisers.create, o sistema vai criar automaticamente um site do CM360.

Remover sites desta lista talvez exclua os criativos do DV360 sincronizados do CM360. Pelo menos um site precisa ser especificado.
dv360ToCmDataSharingEnabled

boolean

Incluir ou não os dados do DV360 nos relatórios de transferência de dados do CM360.
dv360ToCmCostReportingEnabled

boolean

Indica se o custo do DV360 será informado ou não ao CM360.
cmFloodlightLinkingAuthorized

boolean

Obrigatório. Imutável. Ao definir este campo como true, você, em nome da sua empresa, autoriza o compartilhamento de informações da configuração do Floodlight em questão com este anunciante do Display & Video 360.

AdvertiserCreativeConfig

Configurações relacionadas aos criativos de um anunciante.

Representação JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Campos
iasClientId

string (int64 format)

Um ID para configurar o monitoramento de campanha fornecido pela Integral Ad Service (IAS). O sistema do DV360 anexará uma tag "Campaign Monitor" da IAS com esse ID à tag do criativo.
obaComplianceDisabled

boolean

Indica se é preciso ou não usar a conformidade com a Publicidade comportamental on-line (OBA) do DV360.

Aviso: alterar as configurações da OBA pode fazer com que o status de auditoria dos criativos seja redefinido por algumas trocas de anúncios, impedindo a veiculação deles até que sejam aprovados novamente.
dynamicCreativeEnabled

boolean

Indica se o anunciante está ativado ou não para os criativos dinâmicos.
videoCreativeDataSharingAuthorized

boolean

Ao definir este campo como true, você, em nome da sua empresa, autoriza o Google a usar criativos de vídeo associados a este anunciante do Display & Video 360 para fornecer relatórios e recursos relacionados às campanhas de televisão do anunciante.

Aplicável somente quando o anunciante tem uma configuração de servidor de anúncios CM360 hybrid.

AdvertiserDataAccessConfig

Configurações que controlam como os dados relacionados ao anunciante podem ser acessados.

Representação JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Campos
sdfConfig

object (AdvertiserSdfConfig)

São as configurações dos arquivos de dados estruturados (SDF, na sigla em inglês) para o anunciante.

Se não for especificado, as configurações de SDF do parceiro pai serão usadas.

AdvertiserSdfConfig

Configurações dos arquivos de dados estruturados (SDF, na sigla em inglês) de um anunciante.

Representação JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Campos
overridePartnerSdfConfig

boolean

Indica se este anunciante substitui ou não a configuração do SDF do parceiro principal.

Por padrão, um anunciante herda a configuração do SDF do parceiro pai. Para substituir a configuração do parceiro, defina este campo como true e informe a nova configuração em sdfConfig.
sdfConfig

object (SdfConfig)

A configuração do SDF para o anunciante.

AdvertiserTargetingConfig

Configurações de segmentação relacionadas à veiculação de anúncios de um anunciante.

Representação JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Campos
exemptTvFromViewabilityTargeting

boolean

Indica se os dispositivos de smart TV estão isentos da segmentação por visibilidade para todos os itens de linha de vídeo do anunciante.

Métodos

audit

 Audita um anunciante.

bulkEditAdvertiserAssignedTargetingOptions

 Edita em massa as opções de segmentação de um único anunciante.

bulkListAdvertiserAssignedTargetingOptions

 Lista as opções de segmentação atribuídas de um anunciante em todos os tipos de segmentação.

create

 Cria um novo anunciante.

delete

 Exclui um anunciante.

get

 Acessa um anunciante.

list

 Lista os anunciantes acessíveis ao usuário atual.

patch

 Atualiza um anunciante existente.