Início 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 compatível. Você também terá um arquivo ADBMobileConfig.json que será explicado mais tarde neste guia.

Selecione a versão correta

Arquivos .dll/ .winmd diferentes são fornecidos para cada plataforma de destino (Windows 8.1, Windows Phone 8.1) e arquitetura suportada (x86, x64, ARM). Os arquivos são separados em uma estrutura de pastas de acordo com o seguinte:

IMPORTANTE

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

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 do winJS (JavaScript), todos os métodos passam a ter a primeira letra em minúsculas automaticamente.

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 para 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 References e selecione Add Reference.

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

    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.

    OBSERVAÇÃO

    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 componente para Todos os arquivos.

  6. No Solution Explorer, clique com o botão direito do mouse em References e selecione Add Reference.

    Pule esta etapa se você também tiver um projeto C++ em sua solução.

  7. Na guia Windows à esquerda, selecione Extensões, 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 no seu projeto e selecione Adicionar > Item Existente.

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

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

  12. Altere Ação de compilação para Conteúdo.

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

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

  2. No Solution Explorer, clique com o botão direito do mouse no seu projeto e selecione Add > References.

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

    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.

    DICA

    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 componente para Todos os arquivos.

  6. Adicione a seguinte linha à sua classe:

    using namespace ADMS::Measurement;
    
  7. Clique com o botão direito do mouse no seu projeto e selecione Adicionar > Item Existente.

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

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

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

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

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

  2. No Solution Explorer, clique com o botão direito do mouse em References e selecione Add Reference.

    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 ADBMobile.winmd associado.

  4. Clique em Adicionar.

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

    DICA

    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 componente para Todos os arquivos.

  6. No Solution Explorer, clique com o botão direito do mouse em References e selecione Add Reference.

    Pule 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 Microsoft Visual C++ 2013 Runtime Package for Windows.

  8. Clique com o botão direito do mouse no projeto e selecione Adicionar > Item Existente.

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

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

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

    Para projetos JavaScript, o arquivo é definido como Content por padrão.

Atualize o arquivo de configuração ADBMobileConfig.json

O arquivo ADBMobileConfig.json contém configurações globais do SDK e está localizado na raiz do projeto após concluir as etapas na seção Adicionar a biblioteca e o arquivo de configuração ao projeto. Se o arquivo ADBMobileConfig.json não tiver sido pré-configurado pelo Adobe Mobile Services, será 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 estiver usando:

  • Analytics: rsids e server
  • Target: clientCode
  • Gerenciamento de público-alvo: server

Para obter mais detalhes, consulte ADBMobileConfig.json config.

Depuração

Quando quiser habilitar a depuração no SDK, é necessário chamar ADBMobile.Config.setDebugLogging(true);.

Para aplicativos em C Sharp e JS, é necessário habilitar 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 em C++):

C Nitidez

Clique com o botão direito do mouse no projeto e selecione Properties > Debug tab. 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 > Depurar guia. Altere o menu suspenso do tipo de depurador para Somente nativo.

Pronto! Agora você está pronto para implementar o Analytics, Target e Gerenciamento de público-alvo no aplicativo da loja de aplicativos universal do Windows 8.1.

Nesta página