Partilhar via

Instalar o SDK do Microsoft Advertising

  • Artigo

Aviso

A partir de 1.º de junho de 2020, a plataforma de monetização de anúncios da Microsoft para aplicativos UWP do Windows será encerrada. Saiba mais

Para exibir anúncios em seus aplicativos UWP para Windows 10 e Windows 11, instale o SDK do Microsoft Advertising. Este 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 do SDK do Windows 10 versão 10.0.14393 (Atualização de Aniversário), essa biblioteca deve ser instalada separadamente.

Instalar via MSI

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

  1. Feche todas as instâncias do Visual Studio.

  2. Se você instalou anteriormente qualquer versão anterior do SDK do Microsoft Advertising, SDK do Universal Ad Client, extensão do Ad Mediator ou SDK do Microsoft Store Engagement and Monetization, desinstale essas versões do SDK agora. Opcionalmente, abra uma janela do Prompt de Comando e execute estes comandos para limpar todas as versões mais antigas do SDK de publicidade que podem 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}

  3. Baixe e instale o SDK do Microsoft Advertising. Pode levar alguns minutos para instalar. Certifique-se e espere até que o processo seja concluído.

  4. Reinicie o Visual Studio.

  5. 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, SDK do Universal Ad Client ou SDK do Microsoft Store Engagement and Monetization, recomendamos que você abra seu projeto no Visual Studio e limpe e recompile seu projeto (no Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e escolha Limpar, e, em seguida, clique com o botão direito do mouse no nó do projeto novamente e escolha Reconstruir).

Caso contrário, se você estiver usando o SDK do Microsoft Advertising pela primeira vez em seu projeto, agora 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:

  1. Feche todas as instâncias do Visual Studio.

  2. Se você instalou anteriormente qualquer versão anterior do SDK do Microsoft Advertising, SDK do Universal Ad Client, extensão do Ad Mediator ou SDK do Microsoft Store Engagement and Monetization, desinstale essas versões do SDK agora. Opcionalmente, abra uma janela do Prompt de Comando e execute estes comandos para limpar todas as versões mais antigas do SDK de publicidade que podem 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}

  3. Inicie o Visual Studio e abra o projeto no qual você deseja usar o SDK do Microsoft Advertising.

    Observação

    Se o projeto já incluir referências de biblioteca de uma instalação MSI anterior do SDK, remova essas referências do projeto. Essas referências terão ícones de aviso ao lado delas porque as bibliotecas às quais elas fazem referência foram removidas nas etapas anteriores.

  4. No Visual Studio, clique em Projetar e Gerenciar Pacotes NuGet.

  5. 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 a instalação do pacote terminar, salve sua solução.

    Observação

    Se a janela Saída relatar um erro Install-Package que indica que o caminho especificado é muito longo, talvez seja necessário configurar o NuGet para extrair pacotes para um local alternativo com um caminho mais curto do que o local padrão. Para fazer isso, adicione o repositoryPath valor a um arquivo nuget.config em seu computador e atribua-o a um caminho de pasta curto em que os pacotes NuGet podem ser extraídos. Para obter mais informações, consulte este artigo na documentação do NuGet. Como alternativa, você pode tentar mover seu projeto do Visual Studio para uma pasta alternativa com um caminho mais curto.

  6. Feche sua solução e abra-a novamente.

  7. Se o 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, recomendamos que você limpe e recompile seu projeto (no Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e escolha Limpar e, em seguida, clique com o botão direito do mouse no nó do projeto novamente e escolha Recompilar).

Caso contrário, se você estiver usando o SDK pela primeira vez em seu projeto, agora 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 ao SDK em seu projeto para que você possa usar as APIs de publicidade.

  1. Abra o projeto no Visual Studio.

    Observação

    Se o projeto for direcionado a Qualquer CPU, atualize seu projeto para usar uma saída de build específica da arquitetura (por exemplo, x86). Se o seu projeto for direcionado a Qualquer CPU, você não poderá adicionar com êxito 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 de qualquer CPU em seu projeto.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência...

  3. No Gerenciador de Referências, expanda Universal do Windows, clique em Extensões e marque a caixa de seleção ao lado de SDK do Microsoft Advertising para XAML (para aplicativos XAML) ou SDK do Microsoft Advertising para JavaScript (para aplicativos criados usando JavaScript e HTML).

  4. No Gerenciador de referências, clique em OK.

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

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 anúncio nos namespaces Microsoft.Advertising e Microsoft.Advertising.WinRT.UI .

Como essa biblioteca é um pacote de estrutura, isso significa que, depois que um usuário instala uma versão do seu aplicativo que usa essa biblioteca, essa biblioteca é atualizada automaticamente em seu dispositivo por meio do Windows Update sempre que publicamos uma nova versão da biblioteca com correções e melhorias de desempenho. Isso ajuda a garantir que seus clientes sempre tenham a versão mais recente disponível da biblioteca instalada em seus dispositivos.

Se lançarmos uma nova versão do SDK que introduza novas APIs ou recursos nessa biblioteca, você precisará instalar a versão mais recente do SDK para usar esses recursos. Nesse cenário, você também precisaria publicar seu aplicativo atualizado na Loja.