Erros e avisos

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página discute os diferentes tipos de erros e avisos que você pode encontrar ao usar a API Display & Video 360.

Erros da API

As solicitações feitas à API que não podem ser concluídas retornam uma mensagem de erro. As solicitações que retornam erros são contabilizadas na cota do usuário e são consideradas ao analisar solicitações de cota adicional. As respostas de erro precisam ser processadas e tratadas para evitar erros futuros.

Uma resposta de erro tem o seguinte formato e inclui um código de resposta HTTP, uma mensagem de erro e um status de código RPC do Google:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Confira abaixo uma lista de erros comuns de API e a ação recomendada se eles forem retornados:

Erros de SDF

A API Display & Video 360 usa um método assíncrono para gerar e fazer o download de arquivos de dados estruturados (SDFs). Por esse motivo, os erros gerados durante a geração de SDF são retornados na tarefa de download de SDF concluída. Uma tarefa de download de SDF que termina em error é marcada como concluída, mas tem um campo de erro preenchido em vez de um nome de recurso de mídia no campo response, como mostrado neste exemplo truncado:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Se você receber uma mensagem de erro útil ao tentar gerar SDFs, siga as instruções dela. Se a mensagem de erro não for clara, recomendamos as seguintes ações:

• Verifique se o usuário tem as permissões adequadas para os recursos parceiro ou anunciante pai.
• Confirme se os IDs fornecidos no filtro são precisos, correspondem ao tipo de recurso pretendido e estão no contexto do ID raiz fornecido.
• Verifique se você não está excedendo o limite de 20 tarefas de download de SDF simultâneas por usuário.

Se você ainda estiver com erros, entre em contato com o suporte para informar o problema.

Avisos não bloqueadores

Os avisos não bloqueadores são atribuídos a itens de linha para indicar um problema que pode afetar a veiculação de um item de linha. Avisos semelhantes são comunicados na interface por um banner de notificação. Esses avisos são passivos e são listados no campo warningMessages de um item de linha.

Embora passivos, os problemas que causam esses avisos podem afetar a veiculação de um item de linha a ponto de impedir completamente.

Prevenção

Muitos problemas que causam avisos não bloqueadores podem ser evitados com a configuração adequada das configurações do item de linha, incluindo:

• Período de veiculação: se o período de veiculação de um item de linha for inválido ou se o período de veiculação do pedido de inserção pai tiver expirado, o item de linha vai gerar um aviso e não será veiculado. Para evitar o último problema, verifique se o período de veiculação de um item de linha não termina depois do período do pedido de inserção principal.
• Criativo atribuído: se não houver um criativo válido atribuído a um item de linha, ele vai gerar um aviso e não será exibido.
• Segmentação: se a segmentação de um item de linha não for atribuída corretamente, ele poderá gerar um aviso e a veiculação poderá ser afetada ou totalmente impedida.

Se você estiver replicando configurações de um item de linha, verifique se ele não está gerando avisos inesperados.

Monitoramento

Problemas que causam avisos não bloqueadores podem surgir enquanto um item de linha está em andamento. Para garantir que os itens de linha sejam veiculados corretamente, monitore os itens de linha ativos em busca de avisos recém-gerados. Os itens de linha podem ser recuperados em massa usando a função advertisers.lineItems.list. Se um item de linha estiver gerando um alerta inesperado, resolva o problema imediatamente para reduzir o impacto na veiculação.

Os problemas podem surgir mesmo que as configurações ou a segmentação de um item de linha não tenham mudado. Exemplos incluem a pausa ou expiração do pedido de inserção pai e a descontinuação de listas de usuários ou outras segmentações.