Show Menu
TÓPICOS×

Start rápido do desenvolvedor

Você precisará do Visual Studio 2013 ou posterior para implementar o SDK.

Obter o SDK

Depois de descompactar o 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 que será explicado posteriormente neste guia.

Selecione a versão correta

Diferentes arquivos .dll / .winmd são fornecidos para cada plataforma de público alvo (Windows 8.1, Windows Phone 8.1) e arquitetura compatível (x86, x64, ARM). Os arquivos são separados em uma estrutura de pastas de acordo com o seguinte:
A versão do não ADBMobile.winmd reflete a versão da biblioteca. O .winmd arquivo contém apenas metadados e, como tal, terá um número de versão do 255.255.255.255 qual é um comportamento aceito de acordo com a Microsoft (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 loja de aplicativos universal do Windows 8.1 pode ser usada em várias linguagens de programação. Os exemplos neste guia estão em WinJS (JavaScript) e podem precisar ser modificados se você estiver usando uma linguagem diferente. Observe que ao consumir métodos winmd de winJS (JavaScript), 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.

Adicionar a biblioteca e o arquivo de configuração ao seu projeto - C Sharp

  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 associado. ADBMobile.winmd
    Para obter mais informações, consulte a seção Selecionar a versão correta abaixo.
  4. Clique em Adicionar .
  5. Verifique se ADBMobile.winmd está selecionado na janela Gerenciador de referência e clique em OK .
    Ao adicionar uma referência a um aplicativo do Windows Phone, para selecionar ADBMobile.winmd , altere o filtro de arquivo padrão de Arquivos de componentes para Todos os arquivos .
  6. No Solution Explorer , clique com o botão direito do mouse em Referências e selecione Adicionar referência .
    Ignore esta etapa se você também tiver um projeto C++ em sua solução.
  7. Na guia Windows à esquerda, selecione Extensões e, em seguida, selecione e adicione Microsoft Visual C++ 2013 Runtime Package for Windows .
  8. Adicione a seguinte linha à sua classe:
    using ADBMobile;
    
    
  9. Clique com o botão direito do mouse em seu projeto e selecione Adicionar > Item existente .
  10. Navegue até o seu ADBMobileConfig.json arquivo e clique em Adicionar .
  11. Clique com o botão direito do mouse no ADBMobileConfig.json arquivo na 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 associado. ADBMobile.winmd
    Para obter mais informações, consulte a seção Selecionar a versão correta abaixo.
  4. Clique em Adicionar .
  5. Na janela Gerenciador de referência, verifique se ADBMobile.winmd está selecionado e clique em OK .
    Ao adicionar uma referência a um aplicativo do Windows Phone, para selecionar ADBMobile.winmd , altere o filtro de arquivo padrão de Arquivos de componentes para Todos os arquivos .
  6. Adicione a seguinte linha à sua classe:
    using namespace ADMS::Measurement;
    
    
  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 .
    Para obter mais informações, consulte a seção Selecionar a versão correta abaixo.
  3. Selecione a versão correta da biblioteca e navegue até o arquivo associado. ADBMobile.winmd
  4. Clique em Adicionar .
  5. Verifique se ADBMobile.winmd está marcada na janela Gerenciador de referência e clique em OK .
    Ao adicionar uma referência a um aplicativo do Windows Phone, para selecionar ADBMobile.winmd , altere o filtro de arquivo padrão de Arquivos de componentes para Todos os arquivos .
  6. No Solution Explorer , clique com o botão direito do mouse em Referências e selecione Adicionar referência .
    Ignore esta etapa se você também tiver um projeto C++ em sua solução.
  7. Na guia Windows à esquerda, selecione Extensões e selecione e adicione o Pacote de tempo de execução Microsoft Visual C++ 2013 para Windows .
  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.

Atualize 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 Projeto . Se seu ADBMobileConfig.json arquivo não foi pré-configurado pelo Adobe Mobile Services, é necessário atualizar alguns valores para começar.
The following is an example of an ADBMobileConfig.json file:
{ 
    "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:
  • Analytics : rsids e server
  • Target : clientCode
  • Gerenciamento de público-alvo : server
Para obter mais detalhes, consulte ADBMobileConfig.json config .

Depuração

Quando você quiser ativar a depuração para o SDK, é necessário chamar ADBMobile.Config.setDebugLogging(true); .
Para aplicativos C Sharp e JS, é necessário ativar a depuração de código nativa completando as seguintes etapas (a depuração de código nativa é a configuração padrão para aplicativos C++):

C Sharp

Clique com o botão direito do mouse no projeto e selecione Propriedades > guia Depurar . Na lista suspensa do depurador, selecione Somente nativo .

JS

Clique com o botão direito do mouse no projeto e selecione Propriedades > Propriedades ​de configuração > guia Depurar . 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 loja de aplicativos universal do Windows 8.1.