Sandbox de Publicidade da Microsoft
O Microsoft Advertising fornece um ambiente de sandbox de API onde pode testar a sua aplicação antes de implementá-la no ambiente de produção. Os anúncios que criar no sandbox não são servidos. Os serviços suportados no sandbox variam consoante a produção. Para obter os endereços do serviço Web para serviços suportados, veja Endereços do Serviço Web da API de Anúncios do Bing.
Nota
O sandbox pode estar inativo para manutenção, com ou sem notificação prévia.
Inscrição Inicial do Cliente
O sandbox e os ambientes de produção utilizam credenciais separadas.
Siga estes passos para obter um novo cliente do sandbox. Se já tiver um cliente do sandbox e quiser adicionar um novo utilizador, por exemplo, com as credenciais da conta Microsoft, pode avançar para os passos de convite do utilizador .
Abra um browser e navegue para https://sandbox.bingads.microsoft.com?simpsp=true.
Clique em Inscrever-se no Microsoft Advertising ou Inscrever-se agora
Selecione Criar um novo endereço de e-mail para criar um MSA. Não utilize um endereço de e-mail existente.
Clique em Seguinte
Introduza um endereço de e-mail MSA. O servidor de e-mail tem de ser outlook-int.com (por exemplo, someone@outlook-int.com).
Importante
O Sandbox suporta MSAs criadas apenas com uma conta de e-mail outlook-int.com. Não pode utilizar uma conta de e-mail outlook.com. Além disso, não pode utilizar uma conta de e-mail de outro serviço de e-mail (por exemplo, @contoso.com) mesmo que a conta esteja associada a uma conta de e-mail outlook.com ou outlook-int.com.
Conclua o fluxo de trabalho do MSA ao especificar o resto das informações de segurança e do utilizador. Em seguida, será redirecionado para o Microsoft Advertising para continuar a inscrição do cliente e da conta do sandbox.
Preencha o formulário Criar Conta
Para Importar/Criar Campanha, clique em Ignorar criação de campanha
Para o Go Live, clique em Ignorar informações de pagamento
Convidar Mais Utilizadores
Para se autenticar com o OAuth no sandbox, precisa de uma conta Microsoft (MSA) do sandbox. Se o cliente do sandbox ainda não tiver credenciais de utilizador através de uma conta Microsoft, terá de convidar um utilizador para trabalhar na sua conta do sandbox através dos seguintes passos.
No sandbox Microsoft Advertising, clique no seu nome de utilizador (canto superior direito)
Clique em Contas & Faturação
Clique em Utilizadores
Clique em Convidar utilizador
Introduza o endereço de e-mail do utilizador a convidar. O servidor de e-mail tem de ser outlook.com (por exemplo, someone@outlook.com).
Importante
Pode enviar convites apenas para outlook.com contas de e-mail. Não pode enviar convites para qualquer outro domínio, mesmo que a conta esteja associada a uma conta de e-mail outlook.com. Se tentar enviar um convite para outro domínio (por exemplo, someone@contoso.com), a IU do BingAds mostrará o convite como pendente indefinidamente (o convite nunca é enviado).
Clique em Enviar
O Microsoft Advertising envia um convite por e-mail ao utilizador. Se o convite não aparecer na caixa de entrada, selecione a pasta Email de Lixo. A receção do convite poderá demorar alguns minutos. Os passos seguintes mostram como aceitar o convite.
Abra o e-mail do Microsoft Advertising com o assunto, Convite para o Microsoft Advertising
Clique na ligação incorporada
Selecione Criar um novo endereço de e-mail para criar um MSA. Não utilize um endereço de e-mail existente.
Clique em Seguinte
Introduza um endereço de e-mail MSA. O servidor de e-mail tem de ser outlook-int.com (por exemplo, someone@outlook-int.com).
Importante
O Sandbox suporta MSAs criadas apenas com uma conta de e-mail outlook-int.com. Não pode utilizar uma conta de e-mail outlook.com. Além disso, não pode utilizar uma conta de e-mail de outro serviço de e-mail (por exemplo, @contoso.com) mesmo que a conta esteja associada a uma conta de e-mail outlook.com ou outlook-int.com.
Conclua o fluxo de trabalho ao especificar as restantes informações do utilizador
Saia do Microsoft Advertising depois de concluir o processo MSA.
Nota
O processo de inscrição MSA devolve-o à interface de utilizador SI Microsoft Advertising (ui.si.bingads.microsoft.com). Depois de concluir o processo MSA, termine sessão na interface SI e, em seguida, inicie sessão com o seu novo endereço de e-mail outlook-int.com emhttps://secure.sandbox.bingads.microsoft.com/ .
Obter Acesso à API
O sandbox e os ambientes de produção utilizam credenciais separadas.
Para o ambiente do sandbox, substitua por https://login.microsoftonline.com/commonhttps://login.windows-ppe.net/consumers.
Esta tabela inclui pontos finais de sandbox adicionais.
| Descrição | Produção | Sandbox |
|---|---|---|
| Ponto final para pedidos OAuth | login.microsoftonline.com | login.windows-ppe.net |
| Domínio para e-mail utilizado ao obter uma conta Microsoft | Qualquer endereço de e-mail | outlook-int.com |
| Ponto final para alterar a palavra-passe da conta Microsoft | account.live.com/password/change | account.live-int.com/password/change |
Apesar de, em produção, ter de utilizar o seu próprio token de programador, todos os clientes do Microsoft Advertising podem utilizar o seguinte token de programador universal no sandbox.
BBD37VB98
Apesar de, em produção, ter de utilizar o seu próprio ID de aplicação (também conhecido como ID de cliente), todos os clientes do Microsoft Advertising podem utilizar o seguinte ID de aplicação pública no sandbox. O ID de cliente "Tutorial Sample App" está limitado a aplicações de ambiente de trabalho ou consola e não pode ser utilizado com nenhum segredo do cliente numa aplicação Web.
4c0b021c-00c3-4508-838f-d3127e8167ff
Agora, pode obter tokens de acesso e atualização para o seu utilizador do Microsoft Advertising e fazer a sua primeira chamada de serviço com a API de Anúncios do Bing. Veja o Guia de Introdução .
Sugestão
Para obter detalhes sobre como obter tokens de acesso e atualização com os SDKs de Anúncios do Bing, veja Authentication With the SDKs (Autenticação com os SDKs).
Melhores Práticas do Sandbox
O sandbox não deve ser utilizado na mesma capacidade que a produção.
- Certifique-se de que, ao implementar a aplicação no ambiente de produção, utiliza os WSDLs de produção e as credenciais de produção.
- O Sandbox contém a versão de produção atual e será atualizado com pré-visualizações de funcionalidades com ou sem notificação prévia.
- A capacidade do sandbox é inferior à capacidade de produção e não deve utilizá-la para realizar testes de stress ou capacidade.
- Não utilize mais do que um thread.
Serviço Ad Insight
O Sandbox suporta um conjunto limitado de palavras-chave para testar operações do serviço Ad Insight. Não deve utilizar os dados de teste para inferir ou esperar estimativas semelhantes para as palavras-chave na produção. Algumas das limitações estão descritas na tabela seguinte.
Sugestão
Utilize o serviço Ad Insight na produção em vez do sandbox. O Sandbox oferece apenas um subconjunto de operações de serviço de produção e os dados de informações ficam atrasados em produção. Os dados de oportunidade do Sandbox são atualizados e atualizados todos os fins de semana e estão disponíveis até segunda-feira. Os dados de ideia de palavra-chave no sandbox podem ficar para trás da produção em vários meses. Se uma operação falhar devido a um intervalo de datas inválido, tente submeter o pedido novamente com um intervalo de datas anterior.
| Operação de Serviço | Limitações do Sandbox |
|---|---|
| GetBidLandscapeByKeywordIds | Não suportadas. Pode chamar a operação com identificadores de palavra-chave existentes, mas não são devolvidos dados. |
| GetEstimatedBidByKeywordIds | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. |
| GetEstimatedBidByKeywords | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. |
| GetEstimatedPositionByKeywordIds | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. Para aumentar a probabilidade de obter uma estimativa, o elemento MaxBid deve ser superior ou igual a 5 dólares americanos ou o equivalente noutras moedas. |
| GetEstimatedPositionByKeywords | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. Para aumentar a probabilidade de obter uma estimativa, o elemento MaxBid deve ser superior ou igual a 5 dólares americanos ou o equivalente noutras moedas. |
| GetHistoricalKeywordPerformance | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. Os elementos MatchType e AdPosition têm de ser definidos como Agregar. O elemento Dispositivos tem de ser definido como Computadores ou nulo esquerdo. |
| GetHistoricalSearchCount | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. O elemento EndMonthAndYear tem de ser definido como o mês anterior. Por exemplo, se a data de hoje for 1 de abril de 2020, o mês final deverá ser março de 2020. O elemento Dispositivos tem de ser definido como Computadores ou nulo esquerdo. |
| GetKeywordCategories | Não deve haver diferença no sandbox versus na produção. |
| GetKeywordDemographics | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. O elemento Dispositivos tem de ser definido como Computadores ou nulo esquerdo. |
| GetKeywordIdeas | Os dados de teste do Sandbox são atualizados a cada 3 meses, pelo que terá de definir um intervalo de daters anterior. |
| GetKeywordLocations | É suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações de carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. O elemento Dispositivos tem de ser definido como Computadores ou nulo esquerdo. |
| SuggestKeywordsForUrl | Não deve haver diferença no sandbox versus na produção. |
| SuggestKeywordsFromExistingKeywords | Se o SuggestionType estiver definido como 1, não deverá haver diferença no comportamento em comparação com a produção. Para os valores de tipo de sugestão 2, 3 e 4, é suportado um conjunto limitado de palavras-chave: ar, automóvel, melhores ofertas, reserva, informações do carro, cuidados, negócio do dia, descontos, entretenimento, finanças, jogos, avaliações de hotéis, comparação de seguros, desporto, hotel. |
Serviço em Massa
O limite de tamanho do ficheiro para carregamento em produção é de 100 MB ou 2,5 milhões de linhas. Para sandbox, o limite é de 20 mil linhas. Para obter mais informações, veja Transferência e Carregamento em Massa.
Serviço de Gestão de Campanhas
Suporte Editorial
O Sandbox suporta críticas editoriais e recursos limitados. Não pode obter as razões para problemas editoriais no sandbox, tal como podia em produção, por exemplo, através da operação de serviço GetEditorialReasonsByIds .
Anúncios de Produto
Os anúncios de produtos são suportados no sandbox no Estados Unidos. Para ser aprovado automaticamente, tem de criar um catálogo e uma loja do Microsoft Merchant Center que termine com "sandbox" da seguinte forma.
Na aplicação Web Microsoft Advertising, clique em Ferramentas.
Em Ferramentas de Gestão, clique em Centro de Comerciantes da Microsoft.
Clique em Criar arquivo e introduza um nome de loja que termine com "sandbox" (não sensível a maiúsculas e minúsculas).
Adicione as informações da loja, selecione Anúncios de Produtos em Definições do catálogo e clique em Concluir.
Na nova loja, clique em Gestão de catálogo e, em seguida, clique em Criar catálogo.
Adicione o nome do catálogo, selecione Carregar manualmente o ficheiro mais tarde em Ficheiro de feed de catálogo e clique em Guardar.
Serviço de Faturação do Cliente
Os métodos de pagamento não são suportados no sandbox.
Serviço de Relatórios
Quando cria uma palavra-chave, os dados de desempenho de teste devem ser gerados dentro de algumas horas. Os dados são fornecidos para testar a geração, obtenção e análise de relatórios no sandbox. Não deve utilizar os dados de teste para inferir ou esperar um desempenho semelhante para as palavras-chave na produção.
Os dados de teste são gerados apenas para o mesmo dia em que a entidade foi adicionada ou atualizada. Por exemplo, se adicionar uma palavra-chave hoje e transferir um relatório de desempenho de palavras-chave para a semana passada, não haverá dados. Teria de solicitar um relatório que inclua hoje no período de tempo do relatório.
Os relatórios seguintes podem devolver dados de desempenho no sandbox. Todos os outros tipos de relatório podem ser submetidos com êxito, embora o serviço sandbox não devolva quaisquer dados de exemplo, ou seja, o URL de transferência do relatório não será definido quando consultar os resultados.