Início rápido do desenvolvedor

Estas são algumas informações sobre como implementar a biblioteca da plataforma Universal Windows.

IMPORTANTE

Para implementar o SDK, você precisa do Visual Studio 2013 ou posterior.

Obter o SDK

Depois de descompactar o arquivo de download do SDK, você terá uma pasta separada para cada combinação de arquitetura e plataforma suportada. Você também terá um ADBMobileConfig.json arquivo. Para obter mais informações sobre esse arquivo, consulte o arquivo de configuraçãoADBMobileConfig.json.

Select the correct version

Diferentes .dll/.winmd arquivos são fornecidos para cada arquitetura suportada (x86, x64, ARM).

IMPORTANTE

A versão do não ADBMobile.winmd reflete a versão da biblioteca. O .winmd arquivo contém apenas metadados e tem um número de versão de 255.255.255.255, que é um comportamento aceito de acordo com a Microsoft. Para obter mais informações, consulte Como adicionar informações de montagem para uma dll do componente WinRT C++ / CX?. Para verificar a versão da biblioteca que você está usando, verifique a versão do arquivo subjacente ADBMobile.dll .

Diferenças de sintaxe

A biblioteca da plataforma Universal Windows pode ser usada em várias linguagens de programação. Os exemplos neste guia estão em WinJS (JavaScript), se você estiver usando uma linguagem diferente, talvez precise ser modificada. Quando você consome métodos winmd de winJS, todos os métodos têm automaticamente a primeira letra em minúsculas.

A principal diferença entre as implementações é a estrutura de dados usada para dados de contexto. Além disso, ao usar o SDK em um projeto WinJS, use uma string vazia ( "" ou '') em vez de null valores de string vazios.

Add the library and config File to your project - C#

  1. Inicie o Visual Studio e abra sua solução.

  2. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Adicionar referência.

  3. Selecione a versão correta da biblioteca e navegue até o arquivo ADBMobile.winmd associado.

    Para obter mais informações, consulte Selecionar a seção da versão correta nesta página.

  4. Clique em Adicionar.

  5. Verifique se o arquivo ADBMobile.winmd está marcado na janela Gerenciador de referência e clique em OK.

  6. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Adicionar referência.

    Se você também tiver um projeto C++ em sua solução, pule esta etapa.

  7. Na guia Windows à esquerda, selecione Extensões, selecione e adicione Visual C++ 2015 Runtime for Universal Windows Platform Apps.

  8. Adicione a seguinte linha à sua classe:

    using ADBMobile;
    
  9. Clique com o botão direito do mouse em seu projeto e clique em Adicionar > Item existente.

  10. Navegue até o ADBMobileConfig.json arquivo e clique em Adicionar.

  11. Clique com o botão direito do mouse no ADBMobileConfig.json arquivo da solução e selecione Propriedades.

  12. Altere Criar ação para Conteúdo.

Add the library and config file to your project - C++

  1. Inicie o Visual Studio e abra sua solução.

  2. No Solution Explorer, clique com o botão direito do mouse em seu projeto e selecione Adicionar > Referências.

  3. Selecione a versão correta da biblioteca e adicione uma referência ao arquivo ADBMobile.winmd associado.

    Para obter mais informações, consulte Selecionar a seção da versão correta nesta página.

  4. Clique em Adicionar.

  5. Verifique se ADBMobile.winmd está marcada na janela Gerenciador de referência e clique em OK.

  6. Adicione a seguinte linha à sua classe:

    using namespace ADBMobile;
    
  7. Clique com o botão direito do mouse em seu projeto e selecione Adicionar > Item existente.

  8. Navegue até o ADBMobileConfig.json arquivo e clique em Adicionar.

  9. Clique com o botão direito do mouse no ADBMobileConfig.json arquivo na solução e selecione Propriedades.

  10. Na guia Geral , altere Conteúdo para Sim e clique em OK.

Add the library and config file to your project - WinJS

  1. Inicie o Visual Studio e abra sua solução.

  2. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Adicionar referência.

  3. Selecione a versão correta da biblioteca e navegue até o arquivo ADBMobile.winmd associado.

  4. Clique em Adicionar.

  5. Verifique se o arquivo ADBMobile.winmd está marcado na janela Gerenciador de referência e clique em OK.

  6. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Adicionar referência.

    Se você também tiver um projeto C++ em sua solução, pule esta etapa.

  7. Na guia Windows à esquerda, selecione Extensões e selecione e adicione Visual C++ 2015 Runtime for Universal Windows Platform Apps.

  8. Clique com o botão direito do mouse em seu projeto e selecione Adicionar > Item existente.

  9. Navegue até o ADBMobileConfig.json arquivo e clique em Adicionar.

  10. Clique com o botão direito do mouse no ADBMobileConfig.json arquivo na solução e selecione Propriedades.

  11. Com Propriedades ​de arquivo selecionado, verifique se Ação ​do pacote está definida como Conteúdo.

    Para projetos JavaScript, o arquivo é definido como Conteúdo por padrão.

Atualizar o arquivo de configuração ADBMobileConfig.json

O ADBMobileConfig.json arquivo contém configurações globais do SDK e está localizado na raiz do projeto depois que você concluir as etapas em Adicionar a biblioteca e o arquivo de configuração à seção do projeto . Se seu ADBMobileConfig.json arquivo não foi pré-configurado pelo Adobe Mobile Services, é necessário atualizar alguns valores para começar.

Este é um exemplo de um arquivo ADBMobileConfig.json:

{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 300, 
        "privacyDefault" : "optedin", 
        "poi" : [ 
                    ["san francisco",37.757144,-122.44812,7000], 
                    ["santa cruz",36.972935,-122.01725,600] 
                ] 
    }, 
 "target" : { 
  "clientCode" : "myTargetClientCode", 
  "timeout" : 1 
 }, 
 "audienceManager" : { 
  "server" : "myServer.demdex.com" 
 } 
}

No mínimo, atualize os seguintes valores para as soluções que você está usando:

  • Adobe Analytics: rsids e server

  • Adobe Target: clientCode

  • Adobe Audience Manager: server

For more information, see SDK methods.

Depuração

Para ativar a depuração para o SDK, chame ADBMobile.Config.setDebugLogging(true);.

Para aplicativos C Sharp e JavaScript, é necessário ativar a depuração de código nativa ao concluir as seguintes etapas (a depuração de código nativa é a configuração padrão para aplicativos C++):

C Sharp

  1. Clique com o botão direito do mouse no projeto e clique em Propriedades > guia Depurar.

  2. Altere o menu suspenso do tipo de depurador para Somente nativo.

JavaScript

  1. Clique com o botão direito do mouse no projeto e clique em Propriedades > Propriedades ​de configuração > guia Depurar.

  2. Altere o menu suspenso do tipo de depurador para Somente nativo.

Pronto! Agora você está pronto para implementar o Analytics, o Público alvo e o Gerenciamento de Audiências no aplicativo da plataforma Universal Windows.

Nesta página