Notas da versão

Nesta página, você encontra as notas da versão da API Display & Video 360.

Versão mais recente da API: v3

23 de abril de 2024

Novos recursos

Foi adicionado suporte a novos tipos de KPI, trocas e plataformas de apps.

v3

  • Os seguintes campos foram adicionados:

    ResourceCampo(s)
    Kpi (em inglês)

    kpiAlgorithmId

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    Troca

    EXCHANGE_DRAX

    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

28 de fevereiro de 2024

Novos recursos

Agora é possível remover explicitamente os membros dos públicos-alvo segmentados por lista de clientes.

Agora é possível segmentar novas trocas.

v3

v2

29 de janeiro de 2024

Novos recursos

Agora é possível recuperar atividades do Floodlight usando um novo serviço floodlightGroups.floodlightActivities.

Adicionamos um novo campo que informa se um item de linha do YouTube e parceiros inclui inventário do Google TV na segmentação.

Adicionamos um novo campo para redirecionar o horário do último login de um usuário do Display & Video 360.

v3

v2

14 de novembro de 2023

Novos recursos

Foi adicionado suporte à transmissão do consentimento do usuário final ao fazer o upload de membros do público-alvo segmentado por lista de clientes em todas as versões ativas.

v3

v2

31 de outubro de 2023

Novos recursos

Removemos a v3 da versão Beta pública para a disponibilidade geral.

Um valor de enumeração AdGroupFormat foi renomeado na v3 para refletir com mais precisão o formato relevante.

Foi adicionado suporte para arquivos de dados estruturados v7 com a adição do valor de enumeração SDF_VERSION_7 nas versões v2 e v3.

v3

  • Os seguintes valores de enumeração foram removidos:

    Tipo enumeradoValores
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    SdfVersion

    SDF_VERSION_7

2 de outubro de 2023

Novos recursos

Lançamento da v3 na versão Beta pública, que inclui as seguintes mudanças:

Siga as etapas no nosso guia de migração para migrar da v2 para a v3.

Foi adicionado suporte a três novos valores de LineItemType, um novo YoutubeAndPartnersBiddingStrategyType e um novo PartnerCostType nas v2 e v3.

v3

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    LineItemType

    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

    PartnerCostType

    PARTNER_COST_TYPE_SCIBIDS_FEE

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

25 de agosto de 2023

Novos recursos

Agora é possível usar duas trocas e dois novos tipos de estratégias de lances do YouTube e parceiros.

Adicionamos um novo campo effectiveContentCategory aos itens de linha do YouTube & Partners para exibir o YoutubeAndPartnersContentCategory usado pelo item de linha ao considerar os valores atribuídos no nível do anunciante e do item de linha.

v2

5 de junho de 2023

Novos recursos

Foi adicionado um novo valor de SdfVersion para arquivos de dados estruturados (SDF, na sigla em inglês) v6 nas versões v1 e v2.

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    SdfVersion

    SDF_VERSION_6

v1

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    SdfVersion

    SDF_VERSION_6

9 de março de 2023

Novos recursos

Foi adicionado um novo valor LineItemWarningMessage que será atribuído ao campo warningMessages de um item de linha se ele tiver o campo descontinuado excludeFirstPartyAudience definido como true. O campo excludeFirstPartyAudience será desativado e definido como false após 25 de março de 2023.

v2

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 de fevereiro de 2023

Novos recursos

Adicionamos a capacidade de recuperar recursos de YouTubeAdGroup e YouTubeAdGroupAd, além da segmentação de recursos do grupo de anúncios do YouTube. Além disso, adicionamos novos tipos de segmentação recuperáveis usados no nível dos grupos de anúncios do YouTube. Leia nossa nova página de guia sobre como recuperar recursos do YouTube e parceiros para mais informações.

Agora é possível usar mais quatro trocas na v1 e v2.

v2

v1

  • Os seguintes valores de tipo enumerado foram adicionados:

    Tipo enumeradoValores
    Troca

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 de dezembro de 2022

Novos recursos

Removemos a v2 da versão Beta pública para a disponibilidade geral.

Foi adicionado um novo campo assignedTargetingOptionIdAlias ao recurso AssignedTargetingOption, que pode ser usado no lugar de assignedTargetingOptionId ao recuperar e excluir a segmentação. Este campo é definido apenas para opções de segmentação atribuídas de tipos de segmentação atribuídos via tipo enumerado. O valor de alias é o valor de tipo enumerado relevante como uma string.

Adicionamos um novo campo billingConfig ao recurso Advertiser.

Foi adicionado suporte para a recuperação de itens de linha over-the-top do YouTube e parceiros, identificados por três novos valores de LineItemType.

Aumento do tamanho máximo da página para 200 em vários métodos list na v1 e v2. O tamanho da página padrão se mantém inalterado.

v2

v1

Problemas conhecidos

Esta atualização corrige os seguintes problemas conhecidos na v2:

27 de outubro de 2022

Agora é possível duplicar um item de linha no InsertionOrder pai.

Introduzimos suporte à gravação da segmentação de pedido de inserção parcial para um subconjunto de tipos de segmentação com a adição dos métodos create e delete ao serviço advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Novos recursos

v2

v1

Nenhum recurso novo foi adicionado à v1.

20 de setembro de 2022

Lançamento da v2 na versão Beta pública, que inclui as seguintes mudanças:

Siga as etapas no nosso guia de migração para migrar da v1 para a v2.

Adicionamos suporte para três novas trocas na v1.

Novos recursos

v2

Veja a seguir uma lista das alterações entre as versões v1 e v2:

v1

  • Os seguintes valores de tipo enumerado foram adicionados à v1:

    Tipo enumeradoValores
    Troca

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 de maio de 2022

Foi adicionada a capacidade de criar recursos InventorySource e gerenciar recursos GuaranteedOrder usando os novos métodos de gravação do serviço inventorySources e um novo serviço guaranteedOrders.

O campo modelReadiness foi introduzido no recurso CustomBiddingAlgorithm. Esse campo lista a prontidão do modelo do algoritmo para cada anunciante que pode acessá-lo.

Ativação da nova funcionalidade de parâmetro de consulta filter para o método advertisers.creatives.list, que permite ao usuário recuperar criativos com um updateTime antes ou depois de um determinado carimbo de data/hora.

Foi adicionado suporte à versão mais recente do SDF, v5.5, com a adição de um valor de enumeração SdfVersion.

Novos recursos

31 de março de 2022

Foi adicionado suporte à recuperação e configuração da segmentação na duração do conteúdo, no tipo de stream e no gênero.

Adicionamos o campo billableOutcome ao objeto InsertionOrder.

O campo raiseBidForDeals foi introduzido ao objeto MaximizeSpendBidStrategy, permitindo que os usuários definam se a estratégia de lances aplica os preços mínimos do anunciante para as transações segmentadas.

Novos recursos

2 de fevereiro de 2022

Agora é possível criar, atualizar e editar membros de determinados recursos FirstAndThirdPartyAudience da Segmentação por lista de clientes. A página Fazer o upload de públicos-alvo segmentados por lista de clientes no novo guia Usar públicos-alvo mostra como utilizar esses novos recursos.

Foi introduzido um novo campo reservationType nos recursos InsertionOrder e LineItem que identifica se um recurso é de tag garantida, programática garantida ou não garantido.

Foi adicionada a capacidade de recuperar e definir se um item de linha segmenta automaticamente novas trocas por meio de um novo campo excludeNewExchanges.

Além dos novos recursos, os limites de cota padrão foram dobrados.

Novos recursos

9 de dezembro de 2020 .

Foi adicionado suporte à segmentação por conteúdo de áudio no tipo de segmentação TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Novos recursos

8 de novembro de 2021

Suporte completo para gerenciar algoritmos de lances personalizados e os scripts deles. Isso inclui:

Adicionamos uma nova página Implementar lances personalizados no guia Como gerenciar itens de linha. Ela descreve o processo de criação de um algoritmo de lances personalizados, upload de um script e atribuição desse algoritmo como a estratégia de lances de um item de linha.

Foi adicionado suporte à versão mais recente do SDF, v5.4, com a adição de um valor de enumeração SdfVersion.

Novos recursos

14 de setembro de 2021

Foi adicionado suporte à área de segmentação por proximidade nos tipos TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI.

Foi adicionada a capacidade de pesquisar as opções de segmentação TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI disponíveis usando targetingTypes.targetingOptions.search, já que elas não podem ser recuperadas pelos métodos targetingTypes.targetingOptions.get ou targetingTypes.targetingOptions.list.

Adição dos novos campos sharedAdvertiserIds e customBiddingAlgorithmState ao recurso de algoritmo de lances personalizados e suporte ao tipo de algoritmo de lances personalizados GOAL_BUILDER_BASED.

Foram adicionados dois novos valores ao tipo enumerado Exchange.

Novos recursos

4 de agosto de 2021

Foi adicionado suporte à segmentação de inventário ativada para o Open Measurement no tipo de segmentação TARGETING_TYPE_OMID.

Aumento do número máximo de opções de segmentação atribuídas que podem ser retornadas em uma única página de vários métodos de lista de opções de segmentação de anunciantes, campanhas, pedidos de inserção e itens de linha usando o parâmetro pageSize.

Novos recursos

26 de maio de 2021

Lançamento do serviço advertisers.invoices, que permite que os usuários:

  • recuperar faturas emitidas para um anunciante durante um determinado mês.
  • pesquisar o código de moeda usado por um anunciante durante um determinado mês.

Adicionamos o campo campaignBudgets ao recurso da campanha. Os segmentos de orçamento do pedido de inserção podem ser vinculados a um orçamento da campanha, restringindo o orçamento total dos segmentos associados ao valor total do orçamento da campanha.

Foi adicionado suporte à segmentação por posição de conteúdo nativo no novo tipo de segmentação TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Introdução de um novo campo prismaEnabled ao recurso do anunciante, permitindo que os usuários ativem a integração com a ferramenta Prisma do Mediaocean.

Ativação do suporte para o valor de enumeração ENTITY_STATUS_PAUSED no campo entityStatus do anunciante.

Novos recursos

29 de abril de 2021

Adição de novos campos aos recursos de Canal e Lista de palavras-chave negativas que retornam a contagem de itens de linha que usam o recurso para segmentação. Ativamos as novas propriedades filter para o método de lista de itens de linha que permitem ao usuário recuperar apenas itens de linha que usam canais específicos ou listas de palavras-chave negativas na segmentação.

Novos recursos

30 de março de 2021

Adicionamos um novo método ao serviço de item de linha que gera um item de linha com as configurações padrão. Esses valores padrão são baseados no tipo de item de linha informado, bem como nas configurações e na segmentação atribuída do pedido de inserção pai.

Ativação da recuperação da segmentação da campanha por meio de um novo serviço de segmentação de campanhas e outro método de lista em massa.

A segmentação de apps foi expandida para permitir a segmentação de apps em mais plataformas.

Fizemos várias mudanças nos serviços advertisers.channels.sites, partners.channels.sites e advertisers.negativeKeywordLists.negativeKeywords para facilitar o gerenciamento do conteúdo da lista de palavras-chave negativas e do canal. Essas mudanças incluem:

  • A adição de métodos replace, que permite que um usuário substitua totalmente o conteúdo existente de uma lista de canais ou palavras-chave negativas.
  • Remoção do requisito de que nenhum item existente seja incluído nos campos createdSites ou createdNegativeKeywords das solicitações de edição em massa.
  • O aumento do número máximo de itens que podem ser retornados em uma única página de uma resposta de listar sites ou listar palavras-chave negativas.

Novos recursos

Descontinuações

24 de fevereiro de 2021

Introdução de um novo serviço de segmentação de pedidos de inserção e outro método de lista em massa, que permite a recuperação da segmentação atribuída a pedidos de inserção. Ampliamos o recurso do criativo, adicionando campos de criativos somente de saída para uso por criativos em áudio de terceiros. Adicionamos novos tipos de meta de desempenho para uso por recursos de pedido de inserção e campanha.

Novos recursos

27 de janeiro de 2021

Ativamos a recuperação e o gerenciamento de pedidos de inserção de TV e itens de linha over-the-top com a introdução de um novo campo InsertOrderType e novo valor de enumeração LineItemType. Foi adicionado suporte a itens de linha de apps para dispositivos móveis por meio de um campo de item de linha mobileApp. Compatibilidade com troca, público-alvo do Google e SDF expandidos com outros valores de tipo enumerado. Foi introduzido o recurso de filtrar e ordenar os valores de advertisers.list pelo horário da última atualização.

Novos recursos

4 de dezembro de 2020

Foi adicionado o recurso para pesquisar as opções de segmentação de região geográfica e filtrar vários resultados do método da lista de recursos pelo horário da última atualização. Introdução de um novo LineItemWarningMessage para informar aos usuários quando um item de linha estiver usando uma segmentação geográfica descontinuada.

Novos recursos

5 de novembro de 2020

Foi adicionado o recurso de criar, atribuir e ativar acionadores manuais que iniciam os gastos dos itens de linha associados. Introdução das opções de expansão de segmentação que, quando definidas, podem expandir a segmentação de um item de linha para incluir usuários semelhantes aos dos públicos-alvo segmentados. Os campos de ID do segmento personalizados foram anexados aos objetos DoubleVerify e Integral Ad Science usados na segmentação por verificação de terceiros.

Novos recursos

12 de outubro de 2020

Introdução de mensagens de aviso recuperáveis ao recurso de item de linha e um tipo de meta de desempenho de taxa de cliques (CTR). warningMessages foi adicionado como um campo filtrável ao listar itens de linha.

Além dos novos recursos, novos limites de cota agora estão em vigor, e uma nova documentação sobre a utilização de solicitações em lote está disponível.

Novos recursos

28 de agosto de 2020

Adicionamos novos campos à resposta do método de auditoria do anunciante e novos campos filtráveis a vários métodos de lista.

Novos recursos

4 de agosto de 2020

Lançamento de novos serviços de gerenciamento de usuários, parceiros e parceiros de segmentação. Introdução de ferramentas para ajudar os usuários a evitar proativamente atingir os limites de entidades da conta. Agora é possível usar itens de linha de áudio e usar algoritmos de lances personalizados nas estratégias de lances de itens de linha e pedido de inserção.

Novos recursos

24 de junho de 2020

Lançamento de uma pequena atualização que adiciona um método de criação para canais de parceiros e anunciante, novos campos FirstAndThirdPartyAudience e outros valores de tipo enumerado de troca.

Novos recursos

2 de junho de 2020

Introduzimos a capacidade de criar, corrigir e preencher um subconjunto de entidades segmentáveis. Além disso, adicionamos a capacidade de modificar a segmentação no nível do anunciante para três tipos de segmentação: canal, exclusão de rótulo de conteúdo digital e exclusão de categoria sensível.

Novos recursos

27 de abril de 2020

Lançamos um grande conjunto de recursos, ampliando o escopo da API para além do SDF. Adicionado o gerenciamento de recursos principais que permite criar, recuperar, atualizar e excluir entidades, como anunciantes, campanhas, pedidos de inserção, itens de linha e criativos. Os novos recursos também permitem a edição da segmentação no nível do item de linha.

Novos recursos

Os seguintes serviços foram adicionados:

ServiçoMétodos
anunciantes

criar

excluir

get

lista

patch

advertisers.assets

fazer upload

advertisers.campaigns

criar

excluir

get

lista

patch

advertisers.channels

get

lista

advertisers.creatives

criar

excluir

get

lista

patch

advertisers.insertionOrders

criar

excluir

get

lista

patch

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

criar

excluir

get

lista

patch

advertisers.lineItems.targetingTypes.assignedTargetingOptions

criar

excluir

get

lista

advertisers.locationLists

get

lista

advertisers.negativeKeywordLists

get

lista

combinedAudiences

get

lista

customLists

get

lista

firstAndThirdPartyAudiences

get

lista

floodlightGroups

get

patch

googleAudiences

get

lista

inventorySourceGroups

get

lista

inventorySources

get

lista

partners.channels

get

lista

partners.channels

get

lista

9 de março de 2020

Lançamento da API Display & Video 360 v1. Essa é a versão inicial da API.

Problemas conhecidos

Nenhum.