Show Menu
ARGOMENTI×

Developer quick start

Per implementare l’SDK è necessario Visual Studio 2013 o versione successiva.

Ottenere l’SDK

Una volta estratto il download dell’SDK , disporrai di una cartella separata per ogni architettura e combinazione di piattaforme supportata. Disporrai anche del file ADBMobileConfig.json che viene spiegato più avanti in questa guida.

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). I file sono separati in una struttura di cartelle come la seguente:
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 libreria Windows 8.1 Universal App Store può essere utilizzata in vari linguaggi di programmazione. Gli esempi riportati in questa guida sono in WinJS (JavaScript) e potrebbero richiedere delle modifiche se utilizzi un linguaggio diverso. Ricorda che quando utilizzi metodi winmd da WinJS (JavaScript), in tutti i metodi la prima lettera viene automaticamente impostata come minuscola.
La differenza principale tra le implementazioni è la struttura dei dati utilizzata per i dati contestuali.
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. Avvia Visual Studio e apri la soluzione.
  2. In Esplora soluzioni , fai clic con il pulsante destro del mouse su Riferimenti e seleziona #.
  3. Select the correct version of the library and browse to the associated ADBMobile.winmd file.
    Per ulteriori informazioni, consulta la sezione Selezionare la versione corretta riportata di seguito.
  4. Fai clic su Aggiungi .
  5. Verify that ADBMobile.winmd is selected in the Reference Manager window and click OK .
    Quando aggiungete un riferimento a un'app Windows Phone, per selezionare ADBMobile.winmd , modificate il filtro file predefinito da File componente a Tutti i file .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Ignora questo passaggio se hai anche un progetto C++ nella soluzione.
  7. Nella scheda Windows a sinistra, selezionate Estensioni , quindi selezionate e aggiungete Microsoft Visual C++ 2013 Runtime Package for Windows .
  8. Aggiungi la riga seguente alla classe:
    using ADBMobile;
    
    
  9. Right-click you your project and select Add > Existing Item .
  10. Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
  11. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  12. Cambia Operazione di generazione in Contenuto .

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

  1. Avvia Visual Studio e apri la soluzione.
  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.
    Per ulteriori informazioni, consultate la sezione Selezionare la versione corretta riportata di seguito.
  4. Fai clic su Aggiungi .
  5. Nella finestra Gestione riferimenti verificare che ADBMobile.winmd sia selezionato e fare clic su OK .
    Quando aggiungete un riferimento a un'app Windows Phone, per selezionare ADBMobile.winmd , modificate il filtro file predefinito da File componente a Tutti i file .
  6. Aggiungi la riga seguente alla classe:
    using namespace ADMS::Measurement;
    
    
  7. Right-click you your project and select Add > Existing Item .
  8. Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
  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. Avvia Visual Studio e apri la soluzione.
  2. In the Solution Explorer , right-click References and select [Add Reference .
    For more information, see Select the Correct Version section below.**
  3. Select the correct version of the library and then browse to the associated ADBMobile.winmd file.
  4. Fai clic su Aggiungi .
  5. Verifica che ADBMobile.winmd sia selezionato nella finestraGestione riferimenti e fai clic su OK .
    Quando aggiungete un riferimento a un'app Windows Phone, per selezionare ADBMobile.winmd , modificate il filtro file predefinito da File componente a Tutti i file .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Ignora questo passaggio se hai anche un progetto C++ nella soluzione.
  7. Nella scheda Windows a sinistra, selezionate Estensioni , quindi selezionate e aggiungete Microsoft Visual C++ 2013 Runtime Package for Windows .
  8. Right-click your project and select Add > Existing Item .
  9. Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
  10. Right-click the ADBMobileConfig.json] file in your solution and select Properties .
  11. Con Proprietà file selezionato, accertati che Azione pacchetto sia impostata su Contenuto .
    Per i progetti JavaScript, il file è impostato su Content per impostazione predefinita.

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.
Di seguito viene indicato un esempio del file 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" 
 } 
}

Come minimo, aggiorna i seguenti valori delle soluzioni che utilizzi:
  • Analytics : rsids e server
  • Target : clientCode
  • Gestione dell'audience : server
For more details, see ADBMobileConfig.json config .

Eseguire il debug

Per attivare il debug per SDK, è necessario invocare ADBMobile.Config.setDebugLogging(true); .
Per le app C Sharp e JS, devi abilitare il debug del codice nativo eseguendo i passaggi seguenti (il debug del codice nativo è l'impostazione predefinita per le app C++):

C Sharp

Right-click the project, select Properties > Debug tab . Nel menu a discesa Debugger, selezionate Solo nativo.

JS

Right-click the project, select Properties > Configuration Properties > Debug tab . Cambia l’elenco a discesa del tipo di debug in Native Only (Solo nativo) .
Fatto! Ora è tutto pronto per l’implementazione di Analytics, Target, e Audience Manager nella tua app Windows 8.1 Universal App Store.