Instalar o SDK do Microsoft Advertising

Artigo
06/02/2023

Aviso

A partir de 1º de junho de 2020, a plataforma Microsoft Ad Monetization para aplicativos UWP do Windows será desligada. Saiba mais

Para exibir anúncios em seus aplicativos UWP para Windows 10 e Windows 11, instale o SDK do Microsoft Advertising. Esse SDK é uma extensão do Visual Studio 2015 e versões posteriores.

Observação

Se você estiver desenvolvendo um aplicativo UWP JavaScript/HTML e tiver instalado o SDK do Windows 10 versão 10.0.14393 (Atualização de Aniversário) ou posterior, também deverá instalar a biblioteca WinJS . Essa biblioteca costumava ser incluída em versões anteriores do SDK do Windows 10, mas a partir da versão 10.0.14393 do SDK do Windows 10 (Atualização de Aniversário), ela deve ser instalada separadamente.

Instalar por meio de MSI

Para instalar o SDK do Microsoft Advertising por meio do instalador MSI:

Feche todas as instâncias do Visual Studio.
Se você já instalou qualquer versão anterior do SDK do Microsoft Advertising, do SDK do Universal AD Client, da extensão Ad Mediator ou do SDK do Microsoft Store Engagement and Monetization, desinstale essas versões do SDK agora. Opcionalmente, abra uma janela do Prompt de Comando e execute esses comandos para limpar quaisquer versões mais antigas do SDK do Advertising que possam ter sido instaladas com o Visual Studio, mas que podem não aparecer na lista de programas instalados em seu computador:
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
Baixe e instale o SDK do Microsoft Advertising. A instalação pode demorar alguns minutos. Aguarde até o processo terminar.
Reinicie o Visual Studio.
Se você tiver um projeto existente que faça referência a bibliotecas de publicidade de qualquer versão anterior do SDK do Microsoft Advertising, do SDK do Universal Ad Client ou do SDK do Microsoft Store Engagement and Monetization, nós recomendamos que você abra seu projeto no Visual Studio e limpe e recrie seu projeto (em Gerenciador de Soluções, clique com o botão direito do mouse no nó do seu projeto e escolha Limpar e, em seguida, clique com o botão direito do mouse novamente no nó do seu projeto e escolha Recriar).

Caso contrário, se você estiver usando o SDK do Microsoft Advertising pela primeira vez em seu projeto, você estará pronto para adicionar uma referência ao SDK do Microsoft Advertising.

Instalar por meio do NuGet

Para instalar o SDK do Microsoft Advertising em um projeto UWP específico por meio do NuGet:

Feche todas as instâncias do Visual Studio.
Se você já instalou qualquer versão anterior do SDK do Microsoft Advertising, do SDK do Universal AD Client, da extensão Ad Mediator ou do SDK do Microsoft Store Engagement and Monetization, desinstale essas versões do SDK agora. Opcionalmente, abra uma janela do Prompt de Comando e execute esses comandos para limpar quaisquer versões mais antigas do SDK do Advertising que possam ter sido instaladas com o Visual Studio, mas que podem não aparecer na lista de programas instalados em seu computador:
```
MsiExec.exe /x{5C87A4DB-31C7-465E-9356-71B485B69EC8}
MsiExec.exe /x{6AB13C21-C3EC-46E1-8009-6FD5EBEE515B}
MsiExec.exe /x{6AC81125-8485-463D-9352-3F35A2508C11}
```
Inicie o Visual Studio e abra o projeto no qual você deseja usar o SDK do Microsoft Advertising.

Observação

Se seu projeto já inclui referências de biblioteca de uma instalação MSI anterior do SDK, remova essas referências do seu projeto. Essas referências terão ícones de aviso ao lado delas porque as bibliotecas a que fazem referência foram removidas nas etapas anteriores.
No Visual Studio, clique em Projeto e Gerenciar Pacotes NuGet.
Na caixa de pesquisa, digite Microsoft.Advertising.XAML (para um projeto XAML) ou Microsoft.Advertising.JS (para um projeto JavaScript/HTML) e instale o pacote correspondente. Quando terminar a instalação do pacote, salve sua solução.

Observação

Se a janela Saída relatar um erro Pacote-Instalação que indica que o caminho especificado é muito longo, talvez seja necessário configurar o NuGet para extrair pacotes em um local alternativo com um caminho mais curto do que o local padrão. Para fazer isso, adicione o valor repositoryPath a um arquivo nuget.config em seu computador e o atribua a um caminho de pasta curto onde os pacotes NuGet possam ser extraídos. Para obter mais informações, consulte este artigo na documentação do NuGet. Você também pode tentar mover seu projeto do Visual Studio para uma pasta alternativa com um caminho mais curto.
Feche sua solução e depois a reabra.
Se seu projeto já faz referência a bibliotecas de uma versão anterior do SDK do Microsoft Advertising que foi instalado por meio do NuGet e você atualizou seu projeto para uma versão mais recente do SDK, nós recomendamos que você limpe e recrie seu projeto (em Gerenciador de Soluções, clique com o botão direito do mouse no nó do seu projeto e escolha Limpar e, em seguida, clique com o botão direito do mouse novamente no nó do seu projeto e escolha Recriar).

Caso contrário, se você estiver usando o SDK pela primeira vez em seu projeto, você estará pronto para adicionar uma referência ao SDK do Microsoft Advertising.

Adicionar uma referência ao SDK do Microsoft Advertising

Depois de instalar o SDK do Microsoft Advertising, siga estas instruções para fazer referência o SDK em seu projeto para que você possa usar as APIs de publicidade.

Abra o projeto no Visual Studio.

Observação

Se o seu projeto tem direcionamento Any CPU, atualize-o para usar uma saída de compilação de arquitetura específica (por exemplo, x86). Se o seu projeto tem direcionamento Any CPU, você não conseguirá adicionar uma referência ao SDK do Microsoft Advertising nas etapas a seguir. Para obter mais informações, consulte Erros de referência causados pelo direcionamento Any CPU em seu projeto.
No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência...
No Gerenciador de referência, expanda Universal do Windows, clique em Extensões e marque a caixa de seleção ao lado do SDK do Microsoft Advertising para XAML (para aplicativos XAML) ou SDK do Microsoft Advertising para JavaScript (para aplicativos criados em JavaScript e HTML).
No Gerenciador de Referências, clique em OK.

Para orientações passo a passo que mostram como começar a usar as APIs de publicidade, consulte os artigos a seguir:

Noções básicas sobre pacotes de estrutura no SDK do Microsoft Advertising

A biblioteca Microsoft.Advertising.dll no SDK do Microsoft Advertising (para aplicativos UWP) é configurada como um pacote de estrutura. Essa biblioteca contém as APIs de publicidade nos namespaces Microsoft.Advertising e Microsoft.Advertising.WinRT.UI.

Como essa biblioteca é um pacote de estrutura, isso significa que, após um usuário instalar uma versão do seu aplicativo que usa essa biblioteca, ela é atualizada automaticamente em seus dispositivos por meio do Windows Update sempre que publicarmos uma nova versão da biblioteca com correções e melhorias de desempenho. Isso ajuda a garantir que seus clientes sempre terão a versão mais recente da biblioteca instalada nos dispositivos deles.

Se nós lançamos uma nova versão do SDK que apresenta novas APIs ou recursos dessa biblioteca, você precisará instalar a versão mais recente do SDK para usar esses recursos. Nesse cenário, você também precisa publicar seu aplicativo atualizado na Loja.