Suspensão de uso anunciada

Cronograma:

• 17 de maio de 2023: os itens de linha que usam gatilhos manuais vão deixar de ser veiculados no Display & Video 360. Se você ativar um acionador manual vinculado a um item de linha ativo após essa data, o item de linha não vai veicular anúncios.
• 1º de agosto de 2023: o serviço advertisers.manualTriggers na API DV360 v1 e v2, o valor de enumeração LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER na API DV360 v1 e o campo LineItemFlight.triggerId na API DV360 v1 serão desativados. Após essa data, as solicitações feitas para esses serviços ou campos vão retornar um erro.

Ações recomendadas:

• Pare de usar acionadores manuais para iniciar e interromper a veiculação de itens de linha.
• Pare de fazer solicitações para o serviço advertisers.manualTriggers.
• Atualize os campos flight.flightDateType e flight.triggerId para todos os itens de linha usando acionadores manuais.

Cronograma:

• 20 de maio de 2023: não será mais possível atribuir recursos GoogleAudience com um GoogleAudienceType de GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS ou GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES à segmentação por público-alvo de itens de linha ou pedidos de inserção. As solicitações que atribuem esses públicos-alvo à segmentação por público-alvo de um item de linha vão retornar um erro. Isso inclui solicitações de advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault, se o item de linha criado incluir públicos-alvo descontinuados na segmentação por público-alvo.
• 8 de junho de 2023: os públicos-alvo afetados serão removidos de todos os itens de linha e segmentações de pedidos de inserção e de todos os públicos-alvo combinados. Se um item de linha não puder veicular anúncios quando esses públicos-alvo forem removidos, ele será pausado. Nessa data, esses públicos-alvo também não poderão mais ser recuperados usando o serviço googleAudiences.

Tarefas recomendadas:

• Recomendamos que você pare de usar imediatamente os públicos-alvo afetados ao fazer atualizações futuras na segmentação do item de linha.
• Remova todos os públicos-alvo afetados da segmentação de itens de linha e pedidos de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia sobre públicos-alvo.

Cronograma:

• 20 de maio de 2023: não será mais possível atribuir recursos FirstAndThirdPartyAudience com um AudienceType de ACTIVITY_BASED ou FREQUENCY_CAP à segmentação por público-alvo de itens de linha ou pedidos de inserção. As solicitações que atribuem esses públicos-alvo à segmentação por público-alvo de um item de linha vão retornar um erro. Isso inclui solicitações de advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault, se o item de linha criado incluir públicos-alvo descontinuados na segmentação por público-alvo.
• 8 de junho de 2023: os públicos-alvo afetados serão removidos de todos os itens de linha e segmentações de ordens de inserção e de todos os públicos-alvo combinados. Se um item de linha não puder veicular anúncios quando esses públicos-alvo forem removidos, ele será pausado. Nessa data, esses públicos-alvo também não poderão mais ser recuperados usando o serviço firstAndThirdPartyAudiences.

Tarefas recomendadas:

• Recomendamos que você pare de usar imediatamente os públicos-alvo afetados ao fazer atualizações futuras na segmentação do item de linha.
• Remova todos os públicos-alvo afetados da segmentação de itens de linha e pedidos de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia sobre públicos-alvo.

Em 30 de maio de 2023, os limites de uso atuais serão substituídos por uma estrutura de cota híbrida que:

1. Elimina as solicitações por dia por cota de projeto.
2. Estabelece uma cota de solicitações por minuto por anunciante por projeto para métodos qualificados.

Esses novos limites vão permitir maior flexibilidade no uso da API e permitir a paralelização de solicitações entre anunciantes. Os detalhes dessa mudança estão na nossa documentação sobre o limite de cota.

Em 21 de junho de 2023, os parâmetros filter da solicitação LIST não vão mais permitir que operadores lógicos OR sejam usados entre restrições de campos diferentes.

Por exemplo, os recursos identificados com a string de filtro lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" precisam ser recuperados usando duas solicitações LIST com as seguintes strings de filtro:

• lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
• insertionOrderId="123"

Consulte nosso guia de como filtrar solicitações LIST para mais detalhes sobre as restrições de operadores lógicos.

Revise os parâmetros de consulta filter de todas as chamadas LIST e verifique se elas estão usando o operador lógico OR corretamente antes de 21 de junho de 2023 para evitar a interrupção do serviço.

Início da vigência inicial atualizado

A partir de 21 de junho de 2023, os campos budget.budget_segments.date_range.end_date e flight.dateRange.endDate não serão mais aceitos nos parâmetros de consulta advertisers.insertionOrders.list e advertisers.lineItems.list filter e orderBy, respectivamente. Após essa data, as solicitações que usam esses campos nos parâmetros de consulta filter e orderBy vão retornar um erro.

Remova toda a lógica de ordenação e filtro usando esses dois campos antes de 21 de junho de 2023 para evitar a interrupção do serviço.

A partir de 21 de junho de 2023, o advertisers.lineItems.list não vai mais oferecer suporte à filtragem pelos seguintes campos:

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

Remova toda a lógica de filtro que usa esses quatro campos antes de 21 de junho de 2023 para evitar a interrupção do serviço.

Em 1º de agosto de 2023, os pedidos de inserção que usam a compra com base em resultados, definidos por um valor de campo billableOutcome de BILLABLE_OUTCOME_PAY_PER_CLICK ou BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, e os itens de linha filhos serão arquivados.

Essa mudança vai afetar as seguintes solicitações:

• Tentar usar advertisers.insertionOrders.create para criar um pedido de inserção usando a compra com base em resultados vai retornar um erro 400
• A tentativa de usar advertisers.lineItems.create, advertisers.lineItems.duplicate ou advertisers.lineItems.generateDefault para criar um item de linha em um pedido de inserção usando a compra com base em resultados vai retornar um erro 400.
• Como os recursos arquivados não são incluídos nas solicitações LIST por padrão, os recursos afetados não são mais retornados pelos métodos advertisers.insertionOrders.list e advertisers.lineItems.list por padrão.

A partir de 26 de junho de 2024, o campo publisherReviewStatuses será desativado e vai ficar vazio ao recuperar recursos Creative.

Em 30 de setembro de 2024, os seguintes valores dos tipos de segmentação identificados serão desativados para os itens de linha do YouTube e parceiros:

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

As opções de segmentação descontinuadas serão removidas automaticamente da segmentação de itens de linha. Esses valores ainda vão estar disponíveis para uso na segmentação no nível do anunciante.

Para evitar interrupções no serviço, remova essa segmentação de todos os itens de linha do YouTube e parceiros antes da data de desativação.

Em 30 de setembro de 2024, as origens de recursos do FirstAndThirdPartyAudience do Oracle serão desativadas. Após o desativamento, esses públicos-alvo serão removidos de qualquer segmentação de público-alvo combinada e segmentação de recursos. Se um item de linha segmenta apenas públicos-alvo descontinuados ou segmenta negativamente qualquer público-alvo descontinuado, essa atualização pausa automaticamente o item de linha.

Para evitar interrupções no serviço, identifique e remova todos os públicos-alvo da Oracle da segmentação de público-alvo de linhas e dos públicos-alvo combinados antes da data de desativação.

A partir de 30 de setembro de 2024, os recursos LineItem que usam um subconjunto de estratégias de lances não serão mais compatíveis com a segmentação otimizada. Com essa mudança, os recursos LineItem com targetingExpansion.enableOptimizedTargeting definido como True e bidStrategy.maximizeSpendAutoBid.performanceGoalType definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN ou BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ou bidStrategy.performanceGoalAutoBid.performanceGoalType definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM serão atualizados para definir targetingExpansion.enableOptimizedTargeting como False.

Para evitar interrupções no serviço, atualize e verifique se os itens de linha que usam essas estratégias de lances não têm a segmentação otimizada ativada.

Em 5 de novembro de 2024, o PACING_TYPE_ASAP não será mais compatível com PACING_PERIOD_FLIGHT ao definir o campo pacing do pedido de inserção. O pacingType de todos os pedidos de inserção com essa configuração será atualizado para PACING_TYPE_AHEAD.

Para evitar interrupções no serviço, atualize o pacing de todos os pedidos de inserção usando PACING_TYPE_ASAP e PACING_PERIOD_FLIGHT.

Em 28 de fevereiro de 2025:

• As solicitações que criam ou atualizam os recursos LineItem, InsertionOrder e Campaign para usar um objeto FrequencyCap com um campo timeUnit definido como TIME_UNIT_LIFETIME ou um campo timeUnit definido como TIME_UNIT_MONTH e um campo timeUnitCount definido como 2 vão retornar um erro 400.
• As entradas nos arquivos de dados estruturados Item de linha, Pedido de inserção e Campanha com o valor da coluna "Período de frequência" como "Vida útil" ou "Meses" e o valor da coluna "Quantidade de frequência" como "2" não podem ser criadas ou atualizadas no upload de arquivos.
• As campanhas, os pedidos de inserção e os itens de linha atuais serão atualizados para usar um período de limite de frequência de 30 dias ou menos.

Para evitar interrupções no serviço:

• Atualize os recursos de campanha, pedido de inserção e item de linha que usam um período de limite de frequência superior a 30 dias para 30 dias ou menos.
• Verifique se a integração não está definindo um período de limite de frequência superior a 30 dias ao criar ou atualizar recursos de campanha, pedido de inserção ou item de linha usando a API Display & Video 360 ou arquivos de dados estruturados.

Em 6 de março de 2025:

• As solicitações que criam ou atualizam recursos LineItem para definir o campo BiddingStrategy fixedBid e o campo TargetingExpansionConfig enableOptimizedTargeting como verdadeiro vão retornar um erro 400.
• As entradas nos arquivos de dados estruturados do Item de linha com o valor da coluna "Tipo de estratégia de lances" como "Fixo" e o valor da coluna "Alcance otimizado" como "Verdadeiro" não podem ser criadas ou atualizadas no upload de arquivos.
• Os itens de linha que usam lances fixos serão atualizados para desativar a segmentação otimizada.

Para evitar interrupções no serviço:

• Atualize os recursos de itens de linha que usam lances fixos e segmentação otimizada.
• Verifique se a integração não está definindo uma estratégia de lances fixa e segmentação otimizada ao criar ou atualizar recursos de itens de linha usando a API Display & Video 360 ou arquivos de dados estruturados.

Em 6 de março de 2025, o tamanho de página padrão das solicitações firstAndThirdPartyAudiences.list vai ser atualizado de 100 para 5.000.

Para evitar a interrupção do serviço, atualize a integração para definir o parâmetro de consulta pageSize das solicitações firstAndThirdPartyAudiences.list para o tamanho de página desejado.

A partir de 6 de março de 2025, as solicitações sdfdownloadtasks.create que usam um filtro de entidade pai para filtrar por anunciantes que não são filhos do conjunto partnerId vão começar a retornar um erro 400.

Em 1º de abril de 2025:

• As solicitações advertisers.lineItems.create que tentam definir o campo floodlightActivityConfigs do objeto ConversionCountingConfig e o campo customBiddingAlgorithmId dos objetos MaximizeSpendBidStrategy ou PerformanceGoalBidStrategy que não usam atividades do Floodlight correspondentes vão retornar um erro 400.
• As solicitações advertisers.lineItems.patch que tentam atualizar o campo floodlightActivityConfigs do objeto ConversionCountingConfig enquanto o campo customBiddingAlgorithmId dos objetos MaximizeSpendBidStrategy ou PerformanceGoalBidStrategy está definido vão retornar um erro 400.
• As entradas em arquivos de dados estruturados de item de linha que tentam atualizar a coluna "IDs de atividade do Floodlight de conversão" quando a coluna "ID do algoritmo" está definida não vão ser atualizadas no upload do arquivo.
• As solicitações de recursos CustomBiddingAlgorithm atribuídos a um item de linha de customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create e customBiddingAlgorithms.scripts.create vão retornar um erro.

Para evitar interrupções no serviço, atualize a integração para:

• Verifique se as atividades do Floodlight relevantes são atribuídas a um item de linha antes ou ao mesmo tempo que a atribuição de um algoritmo de lances personalizados.
• Os algoritmos de lances personalizados atuais são removidos de todos os itens de linha antes de serem atualizados.

A partir de 7 de abril de 2025, os recursos FirstAndThirdPartyAudience não vão mais permitir a duração infinita de associação ao público-alvo. As solicitações firstAndThirdPartyAudiences.create e firstAndThirdPartyAudiences.patch que definem o valor do campo membershipDurationDays como 10.000 vão retornar um erro 400. Os públicos-alvo atuais com um valor de campo membershipDurationDays de 10.000 vão ser atualizados para 540,e a nova duração da assinatura será aplicada retroativamente às assinaturas atuais. Isso vai fazer com que todas as associações com mais de 540 dias expirem.

Para evitar interrupções no serviço:

• Verifique se a integração não está definindo o valor do campo membershipDurationDays de públicos-alvo novos ou existentes como 10.000.
• Atualize as adesões dos seus públicos-alvo de Segmentação por lista de clientes usando firstAndThirdPartyAudiences.editCustomerMatchMembers.
• Atualize regularmente as associações de público-alvo segmentado por lista de clientes para garantir que o tamanho da lista dos seus públicos-alvo não diminua acidentalmente.

Na v4, essa mudança é refletida nos recursos FirstPartyAndPartnerAudience.

A partir de 1º de maio de 2025, as entradas em arquivos de dados estruturados de item de linha que tentarem definir a coluna "Multiplicadores de lances" não vão conseguir criar ou atualizar o recurso no upload de arquivos.