Show Menu
SUJETS×

Developer quick start

Vous aurez besoin de la version 2013 ou ultérieure de Visual Studio pour mettre en œuvre le SDK.

Obtention du SDK

Après avoir décompressé le fichier de téléchargement du SDK , vous disposez d’un dossier distinct pour chaque combinaison d’architecture et de plate-forme prise en charge. Vous disposez également d’un fichier ADBMobileConfig.json expliqué plus loin dans ce guide.

Select the correct version

Different .dll / .winmd files are provided for each target platform (Windows 8.1, Windows Phone 8.1), and supported architecture (x86, x64, ARM). Les fichiers sont séparés en une structure de dossiers comme suit :
The version of ADBMobile.winmd does not reflect the version of the library. The .winmd file contains metadata only, and as such will have a version number of 255.255.255.255 which is accepted behavior according to Microsoft (see How do I add assembly information for a WinRT C++ / CX component dll? ). To check the version of the library you are using, check the version of the underlying ADBMobile.dll file.

Syntax differences

La bibliothèque Boutique d’applications Windows 8.1 universelle peut être utilisée dans plusieurs langages de programmation. Les exemples fournis dans ce guide sont en WinJS (JavaScript) et devront peut-être être modifiés si vous utilisez un autre langage. Notez que lorsque vous utilisez des méthodes winmd à partir de winJS (JavaScript), la première lettre de toutes les méthodes est automatiquement en minuscule.
La principale différence entre les mises en œuvre réside dans la structure des données utilisée pour les données contextuelles.
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 Sharp

  1. Lancez Visual Studio, puis ouvrez la solution.
  2. Dans l’ Explorateur de solutions , cliquez avec le bouton droit sur Références , puis sélectionnez #.
  3. Select the correct version of the library and browse to the associated ADBMobile.winmd file.
    Pour plus d’informations, voir la section Sélectionner la version appropriée ci-dessous.
  4. Cliquez sur Ajouter .
  5. Verify that ADBMobile.winmd is selected in the Reference Manager window and click OK .
    Lors de l’ajout d’une référence à une application Windows Phone, pour sélectionner ADBMobile.winmd , remplacez le filtre de fichier par défaut par Fichiers de composant par Fichiers pour Tous les fichiers .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Ignorez cette étape si votre solution contient également un projet C++.
  7. Dans l’onglet Windows de gauche, sélectionnez Extensions , puis sélectionnez et ajoutez le package d’exécution Microsoft Visual C++ 2013 pour Windows .
  8. Ajoutez la ligne suivante à votre classe :
    using ADBMobile;
    
    
  9. Right-click you your project and select Add > Existing Item .
  10. Recherchez votre ADBMobileConfig.json fichier et cliquez sur Ajouter .
  11. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  12. Définissez Action de génération sur Contenu .

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

  1. Lancez Visual Studio, puis ouvrez la solution.
  2. In the Solution Explorer , right-click your project and select Add > References .
  3. Select the correct version of the library and then add a reference to the associated ADBMobile.winmd file.
    Pour plus d’informations, voir la section Sélection de la version appropriée ci-dessous.
  4. Cliquez sur Ajouter .
  5. Dans la fenêtre Gestionnaire de références, vérifiez que ADBMobile.winmd est sélectionné, puis cliquez sur OK .
    Lors de l’ajout d’une référence à une application Windows Phone, pour sélectionner ADBMobile.winmd , remplacez le filtre de fichier par défaut par Fichiers de composant par Fichiers pour Tous les fichiers .
  6. Ajoutez la ligne suivante à votre classe :
    using namespace ADMS::Measurement;
    
    
  7. Right-click you your project and select Add > Existing Item .
  8. Browse to the 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. Lancez Visual Studio, puis ouvrez la solution.
  2. In the Solution Explorer , right-click References and select [Add Reference .
    Pour plus d’informations, voir Sélection de la version appropriée ci-dessous.
  3. Select the correct version of the library and then browse to the associated ADBMobile.winmd file.
  4. Cliquez sur Ajouter .
  5. Vérifiez que ADBMobile.winmd est coché dans la fenêtre Gestionnaire de références , puis cliquez sur OK .
    Lors de l’ajout d’une référence à une application Windows Phone, pour sélectionner ADBMobile.winmd , remplacez le filtre de fichier par défaut par Fichiers de composant par Fichiers pour Tous les fichiers .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Ignorez cette étape si votre solution contient également un projet C++.
  7. Dans l’onglet Windows de gauche, sélectionnez Extensions , puis sélectionnez et ajoutez le package d’exécution Microsoft Visual C++ 2013 pour Windows .
  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. Les propriétés du fichier étant sélectionnées, assurez-vous que l’action du package est définie sur Contenu .
    Pour les projets JavaScript, le fichier est défini sur Contenu par défaut.

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.
Voici un exemple de fichier 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" 
 } 
}

Mettez au moins à jour les valeurs suivantes pour les solutions que vous utilisez :
  • Analytics : rsids et server
  • Target : clientCode
  • Gestion de l’audience : server
For more details, see ADBMobileConfig.json config .

Débogage

Lorsque vous souhaitez activer le débogage pour le SDK, vous devez appeler ADBMobile.Config.setDebugLogging(true); .
For C Sharp and JS apps, you have to enable native code debugging by completing the following steps (native code debugging is the default setting for C++ apps):

C Sharp

Right-click the project, select Properties > Debug tab . Dans la liste déroulante Débogueur, sélectionnez natif uniquement .

JS

Right-click the project, select Properties > Configuration Properties > Debug tab . Définissez le menu déroulant du type de débogueur sur Natif uniquement .
Vous avez terminé. Vous êtes maintenant prêt à mettre en œuvre Analytics, Target et la gestion de l’audience dans l’application Boutique d’applications Windows 8.1 universelle.