Show Menu
ARGOMENTI×

Developer quick start

Seguono alcune informazioni su come implementare la libreria della piattaforma UWP (Universal Windows Platform).
Per implementare l’SDK, è necessario Visual Studio 2013 o versione successiva.

Scaricare l'SDK

After you unzip the SDK download file, you will have a separate folder for each supported architecture and platform combination. Avrete anche un ADBMobileConfig.json file. Per ulteriori informazioni su questo file, consulta il file di configurazione 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. Il .winmd file contiene solo i metadati e ha un numero di versione 255.255.255.255 , il che è un comportamento accettato secondo Microsoft. Per ulteriori informazioni, vedere Come si aggiungono le informazioni sull'assembly per una dll componente WinRT C++ / CX? . To check the version of the library you are using, check the version of the underlying ADBMobile.dll file.

Differenze di sintassi

La libreria della piattaforma UWP (Universal Windows Platform) può essere utilizzata in vari linguaggi di programmazione. Gli esempi contenuti in questa guida sono in WinJS (JavaScript), se utilizzi un linguaggio diverso, potrebbero dover essere modificati. Quando utilizzi metodi winmd da winJS, tutti i metodi hanno automaticamente la prima lettera 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#

  1. Avvia Visual Studio e apri la soluzione.
  2. In the Solution Explorer , right-click References and select Add Reference .
  3. Seleziona la versione corretta della libreria e individua il file ADBMobile.winmd associato.
    Per ulteriori informazioni, consultate Selezionare la sezione sulla versione corretta in questa pagina.
  4. Fai clic su Aggiungi .
  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 hai anche un progetto C++ nella soluzione, salta questo passaggio.
  7. Nella scheda Windows a sinistra, selezionare Estensioni , selezionare e aggiungere Runtime Visual C++ 2015 per le app della piattaforma UWP (Universal Windows Platform).
  8. Aggiungi la riga seguente alla classe:
    using ADBMobile;
    
    
  9. Right-click your project and click Add > Existing Item .
  10. Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
  11. Fare clic con il pulsante destro del mouse sul ADBMobileConfig.json file nella soluzione e selezionare Proprietà .
  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. Seleziona la versione corretta della libreria e aggiungi un riferimento al file ADBMobile.winmd associato.
    Per ulteriori informazioni, consultate Selezionare la sezione sulla versione corretta in questa pagina.
  4. Fai clic su Aggiungi .
  5. Verifica che ADBMobile.winmd sia selezionato nella finestraGestione riferimenti e fai clic su OK .
  6. Aggiungi la riga seguente alla 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. Avvia Visual Studio e apri la soluzione.
  2. In the Solution Explorer , right-click References and select Add Reference .
  3. Seleziona la versione corretta della libreria e individua il file ADBMobile.winmd associato.
  4. Fai clic su Aggiungi .
  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 hai anche un progetto C++ nella soluzione, salta questo passaggio.
  7. Nella scheda Windows a sinistra, selezionare Estensioni , quindi selezionare e aggiungere Runtime Visual C++ 2015 per le app della piattaforma UWP (Universal Windows Platform).
  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 Contenuto 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.
Ecco un esempio di 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, aggiornate i seguenti valori per le soluzioni in uso:
  • Adobe Analytics : rsids and server
  • Adobe Target : clientCode
  • Adobe Audience Manager : server
Per ulteriori informazioni, consulta Metodi SDK methods SDK.

Eseguire il debug

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

C Nitido

  1. Fare clic con il pulsante destro del mouse sul progetto, quindi scegliere Proprietà > scheda Debug.
  2. Cambia l’elenco a discesa del tipo di debug in Native Only (Solo nativo) .

JavaScript

  1. Right-click the project, click Properties > Configuration Properties > Debug tab .
  2. Nell’elenco a discesa, cambia il tipo di debugger in Solo nativo .
Tutto qui. A questo punto sei pronto per implementare Analytics, Target e Gestione dell'audience nell’app della piattaforma UWP (Universal Windows Platform).