Perguntas mais frequentes

O fórum Microsoft Q&A está disponível para a comunidade de programadores fazer e responder a perguntas sobre as APIs Bing Ads e os Scripts de Publicidade da Microsoft. A Microsoft monitoriza os fóruns e responde a perguntas que a comunidade ainda não respondeu.

Se a investigação envolver uma conta confidencial ou detalhes pessoais ou se não encontrar as informações necessárias para resolver o problema através do Microsoft Q&A, contacte o Suporte publicitário da Microsoft. Para resolver o problema de forma eficiente, forneça suporte com os detalhes pedidos em Contactar o Suporte.

As Notas de Versão e o Guia de Migração são excelentes recursos para começar.

Pode inscrever-se na newsletter mensal através do separador Notícias do Portal do Programador e é também aí que os anúncios mais recentes do blogue são agregados.

Para começar, tem de se inscrever numa conta do Microsoft Advertising e, em seguida, obter o token de programador em através do separador Conta do Portal do Programador.

Pode desenvolver Bing Ads aplicações de API com qualquer linguagem de programação que suporte serviços Web. Os Bing Ads Software Development Kits (SDK) da API melhoram a experiência de desenvolvimento de aplicações API Bing Ads com linguagens .NET, Java, PHP e Python. Cada SDK inclui um proxy para todos os serviços Web da API Bing Ads e abstrai detalhes de baixo nível de autenticação com OAuth. Pode utilizar as interfaces BulkServiceManager e ReportingServiceManager de alto nível para abstrair e executar operações nos serviços de Volume e Relatórios de baixo nível.

Ouvimos pedidos de SDKs adicionais, por exemplo, Perl e Ruby, embora não exista nenhum plano para adicionar suporte a curto prazo.

Além dos Exemplos de Código, encontrará fragmentos de código em muitos dos guias técnicos, por exemplo, o guia Introdução . Pode utilizar o seletor de idioma na parte superior ou direita dessas páginas para ver exemplos em CSharp, Java, Php ou Python. Quando escolhe um idioma, a definição é mantida à medida que navega noutras páginas. O seletor de idiomas só incluirá idiomas que tenham exemplos para essa página específica e a predefinição será C# se o idioma que definiu anteriormente não estiver disponível para a página para a qual navegou.

Recomenda-se o serviço em massa, especialmente se precisar de adicionar ou atualizar anúncios e palavras-chave em vários grupos de anúncios ou campanhas numa conta. Algumas funcionalidades não estão disponíveis em Massa, por exemplo, AddUetTags, GetBMCStoresByCustomerId, GetGeoLocationsFileUrl e GetMediaMetaDataByAccountId. Para estas funcionalidades, é claro que tem de utilizar o serviço Gestão de Campanhas.

O Serviço de relatórios suporta a maioria dos mesmos tipos de relatório que pode encontrar na aplicação Web Microsoft Advertising. Veja os Guias de Atributos de Relatório e Estatísticas de Desempenho ePeríodos de Tempo de Retenção de Dados de Relatórios para obter detalhes de disponibilidade.

Quando um utilizador clica num anúncio, pode demorar até duas horas para o sistema processar o clique (3 horas para conversões) e disponibilizá-lo para relatórios. Quando todos os dados do dia anterior tiverem sido processados e disponibilizados para relatórios, este estado é referido como Livros Fechados. Para obter mais informações sobre quando os livros são fechados para relatórios, consulte Fusos Horários em Relatórios.

Tem de atualizar a aplicação para utilizar o novo msads.manage âmbito através do ponto final plataforma de identidades da Microsoft. Todos os programadores de aplicações têm de tomar medidas para utilizar o novo âmbito.

Tem de pedir consentimento a um utilizador através do novo msads.manage âmbito e do ponto final plataforma de identidades da Microsoft.

Se tiver um ID de aplicação mais antigo (também conhecido como ID de Cliente) formatado como um valor hexadecimal, por exemplo, 0000000012345A67, tem de registar uma nova aplicação. Os IDs de aplicação plataforma de identidades da Microsoft válidos são formatados como um GUID com travessões, por exemplo, 00001111-aaaa-2222-bbbb-3333cccc44444. Se não vir uma aplicação existente no portal do Azure - Registos de aplicações, isso é uma indicação de que deve substituí-la por uma nova aplicação.

Sim. Tem de pedir consentimento a um utilizador através do novo msads.manage âmbito e do ponto final plataforma de identidades da Microsoft.

Quando pede consentimento a um utilizador (utilizando o inquilino comum) com o ponto final plataforma de identidades da Microsoft, a experiência de início de sessão do utilizador irá variar consoante a identidade subjacente subjacente às respetivas credenciais.

• Uma pessoa que tenha apenas uma identidade MSA será direcionada para a página de início de sessão da MSA.
• Uma pessoa que tenha apenas uma identidade Azure AD será direcionada para a respetiva página de início de sessão organizacional.
• Uma pessoa cujas credenciais são válidas tanto no MSA como nos domínios de Azure AD irá encontrar uma página de desambiguação que lhe pede para escolher entre a respetiva identidade pessoal e escolar ou profissional. Esta desambiguação estará sempre presente, desde que este utilizador tenha duas identidades associadas ao mesmo endereço de e-mail. O utilizador pode deixar de ver isto ao alterar o endereço de e-mail da respetiva conta Microsoft pessoal. Para obter mais informações, consulte https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/.

Se o utilizador já não tiver uma identidade de conta pessoal do MSA, Bing Ads API deixará de aceitar o token de acesso existente. Da mesma forma, o token de atualização já não pode ser utilizado para pedir um novo token de acesso, pelo que terá de pedir novamente o consentimento do utilizador para que a sua aplicação faça a gestão das respetivas contas Microsoft Advertising. Deve eliminar o token de atualização anterior.

Não. As contas escolares ou profissionais só são suportadas na produção.

Para gerir programaticamente uma conta do Microsoft Advertising, tem de dar consentimento, pelo menos, uma vez através do fluxo de consentimento da aplicação Web. Para autenticação de repetição ou de longo prazo, deve seguir o fluxo de concessão de código de autorização para obter um token de acesso e um token de atualização. A partir daí, pode utilizar o token de atualização mais recente para pedir novos tokens de acesso e atualização sem qualquer interação adicional do utilizador. Poderá ter de pedir novamente o consentimento do utilizador, por exemplo, se o utilizador tiver passado pela recuperação da conta, tiver alterado a palavra-passe ou removido as permissões para a sua aplicação se autenticar em seu nome.

Normalmente, o token de acesso expira após uma hora, embora deva verificar sempre a hora de expiração sempre que pedir um novo token.

Os tokens de atualização são, e serão sempre, completamente opacos para a sua aplicação. São de longa duração, por exemplo, 90 dias para clientes públicos, mas a aplicação não deve ser escrita para esperar que um token de atualização dure um período de tempo. Os tokens de atualização podem ser invalidados a qualquer momento e a única forma de uma aplicação saber se um token de atualização é válido é tentar resgatá-lo ao fazer um pedido de token. Mesmo que atualize continuamente o token no mesmo dispositivo com o token de atualização mais recente, deverá começar novamente e pedir o consentimento do utilizador se, por exemplo, tiver sessão iniciada pelo utilizador, o utilizador do Microsoft Advertising tiver alterado a palavra-passe, removido um dispositivo da lista de dispositivos fidedignos ou removido as permissões para a sua aplicação se autenticar em seu nome. A qualquer momento, sem aviso prévio, a Microsoft pode determinar que o consentimento do utilizador deve ser concedido novamente. Como melhor prática, deve sempre armazenar em segurança o token de atualização mais recente sempre que pedir novos tokens de acesso e atualização.

O token de acesso representa as credenciais de utilizador que têm acesso a uma ou mais contas do Microsoft Advertising. O ID da aplicação (também conhecido como client_id) identifica a sua aplicação para cada utilizador do Microsoft Advertising que concede consentimento. O token de programador dá permissão à aplicação para utilizar a API de Bing Ads.

Bing Ads agora é o Microsoft Advertising. O nosso novo nome reflete a forma como estamos a desenvolver as nossas soluções de publicidade para o ajudar a alcançar mais clientes. Não existem planos para mudar o nome de nenhuma das versões atuais da API. A tabela abaixo lista os nomes que tenham ou não sido alterados. Para obter mais informações, veja o anúncio da marca.