Show Menu
TÓPICOS×

Developer quick start

Estas são algumas informações sobre como implementar a biblioteca da plataforma Universal Windows.
Para implementar o SDK, você precisa do Visual Studio 2013 ou posterior.

Obter o SDK

After you unzip the SDK download file, you will have a separate folder for each supported architecture and platform combination. Você também terá um ADBMobileConfig.json arquivo. Para obter mais informações sobre esse arquivo, consulte o arquivo de configuração ADBMobileConfig.json.

Select the correct version

Different .dll/.winmd files are provided for each supported architecture (x86, x64, ARM).
The version of ADBMobile.winmd does not reflect the version of the library. 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? . To check the version of the library you are using, check the version of the underlying ADBMobile.dll file.

Diferenças de sintaxe

A biblioteca da plataforma Universal Windows pode ser usada em diversas linguagens de programação. Os exemplos neste guia estão em WinJS (JavaScript), se você estiver usando uma linguagem diferente, talvez precise ser modificada. Ao consumir métodos winmd de winJS, todos os métodos têm automaticamente a primeira letra em minúsculas.
A diferença principal entre as implementações é a estrutura de dados usada para dados de contexto. Additionally, when using the SDK in a WinJS project, use an empty string ( "" or '' ) instead of null for empty string values.

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

  1. Inicie o Visual Studio e abra sua solução.
  2. In the Solution Explorer , right-click References and select Add Reference .
  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. Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
  6. In the Solution Explorer , right-click References and select Add Reference .
    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. Right-click your project and click Add > Existing Item .
  10. Browse to the ADBMobileConfig.json file and click Add .
  11. Clique com o botão direito do mouse no ADBMobileConfig.json arquivo da solução e selecione Propriedades .
  12. Altere Ação de montagem para Conteúdo .

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

  1. Inicie o Visual Studio e abra sua solução.
  2. In the Solution Explorer , right-click your project and select 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 Selecionar a seção da versão correta nesta página.
  4. Clique em Adicionar .
  5. Verifique se ADBMobile.winmd está selecionada na janela Reference Manager (Gerenciador de referência e clique em OK .
  6. Adicione a seguinte linha à sua classe:
    using namespace ADBMobile;
    
    
  7. Right-click your project and select Add > Existing Item .
  8. Browse to ADBMobileConfig.json file and click Add .
  9. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  10. On the General tab, change Content to Yes and click OK .

Add the library and config file to your project - WinJS

  1. Inicie o Visual Studio e abra sua solução.
  2. In the Solution Explorer , right-click References and select Add Reference .
  3. Selecione a versão correta da biblioteca e navegue até o arquivo ADBMobile.winmd associado.
  4. Clique em Adicionar .
  5. Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
  6. In the Solution Explorer , right-click References and select Add Reference .
    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. Right-click your project and select Add > Existing Item .
  9. Browse to the ADBMobileConfig.json file and click Add .
  10. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  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.

Update The ADBMobileConfig.json config file

The ADBMobileConfig.json file contains global SDK settings and is located at your project root after you complete the steps in the Add the library and config file to your project section. If your ADBMobileConfig.json file was not pre-configured by Adobe Mobile Services, you need to update a few values to get started.
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
Para obter mais informações, consulte Métodos do SDK.

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 Apenas nativo .

JavaScript

  1. Right-click the project, click Properties > Configuration Properties > Debug tab .
  2. Altere o menu suspenso do tipo de depurador para Apenas nativo .
Pronto! Você está pronto para implementar o Analytics, Target, e Gerenciamento de público-alvo no aplicativo da plataforma Universal Windows Platform app.