Show Menu
ARGOMENTI×

Guida rapida per sviluppatori

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

Scaricare l'SDK

Dopo aver decompresso il download dell' SDK, avrai una cartella separata per ogni combinazione di architettura e piattaforma supportata. Avrete anche un ADBMobileConfig.json file che verrà illustrato più avanti in questa guida.

Selezionate la versione corretta

Vengono forniti .dll / .winmd file diversi per ciascuna piattaforma di destinazione (Windows 8.1, Windows Phone 8.1) e architetture supportate (x86, x64, ARM). I file sono separati in una struttura di cartelle come segue:
La versione di ADBMobile.winmd non riflette la versione della libreria. Il .winmd file contiene solo i metadati, e come tale avrà un numero di versione di 255.255.255.255 cui è accettato il comportamento secondo Microsoft (vedere Come si aggiungono le informazioni di assembly per una dll componente WinRT C++ / CX? ). Per verificare la versione della libreria in uso, controllate la versione del ADBMobile.dll file sottostante.

Differenze di sintassi

La libreria Windows 8.1 Universal App Store può essere utilizzata in diversi linguaggi di programmazione. Gli esempi contenuti in questa guida sono in WinJS (JavaScript) e potrebbero dover essere modificati se si utilizza un linguaggio diverso. Tenere presente che quando si utilizzano metodi winmd da winJS (JavaScript), tutti i metodi hanno automaticamente la prima lettera minuscola.
La differenza principale tra le implementazioni è la struttura dati utilizzata per i dati contestuali.
Inoltre, quando utilizzi l’SDK in un progetto WinJS, usa una stringa vuota ( "" o '' ) invece di null valori stringa vuoti.

Aggiungere la libreria e il file di configurazione al progetto - C Sharp

  1. Avviare Visual Studio e aprire la soluzione.
  2. In Esplora soluzioni , fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento .
  3. Selezionate la versione corretta della libreria e individuate il ADBMobile.winmd file associato.
    Per ulteriori informazioni, consulta la sezione Selezionare la versione corretta riportata di seguito.
  4. Fai clic su Aggiungi .
  5. Verificare che ADBMobile.winmd sia selezionato nella finestra Gestione ​riferimenti 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. In Esplora soluzioni , fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento .
    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. Aggiungete la riga seguente alla classe:
    using ADBMobile;
    
    
  9. Fai clic con il pulsante destro del mouse sul progetto e seleziona Aggiungi > Elemento ​esistente.
  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 Azione di compilazione in Contenuto .

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

  1. Avviare Visual Studio e aprire la soluzione.
  2. In Esplora soluzioni , fai clic con il pulsante destro del mouse sul progetto e seleziona Aggiungi > Riferimenti .
  3. Selezionate la versione corretta della libreria, quindi aggiungete un riferimento al ADBMobile.winmd file associato.
    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. Aggiungete la riga seguente alla classe:
    using namespace ADMS::Measurement;
    
    
  7. Fai clic con il pulsante destro del mouse sul progetto e seleziona Aggiungi > Elemento ​esistente.
  8. Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
  9. Fare clic con il pulsante destro del mouse sul ADBMobileConfig.json file nella soluzione e selezionare Proprietà .
  10. Nella scheda Generale , modificate Contenuto in e fate clic su OK .

Add the library and config file to your project - WinJS

  1. Avviare Visual Studio e aprire la soluzione.
  2. In Esplora soluzioni , fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento .
    Per ulteriori informazioni, consultate Selezionare la sezione Versione corretta di seguito.
  3. Selezionate la versione corretta della libreria, quindi individuate il ADBMobile.winmd file associato.
  4. Fai clic su Aggiungi .
  5. Verificare che ADBMobile.winmd sia selezionato nella finestra Gestione ​riferimenti 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. In Esplora soluzioni , fare clic con il pulsante destro del mouse su Riferimenti e selezionare Aggiungi riferimento .
    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. Fai clic con il pulsante destro del mouse sul progetto e seleziona Aggiungi > Elemento ​esistente.
  9. Individuate il ADBMobileConfig.json file e fate clic su Aggiungi .
  10. Fare clic con il pulsante destro del mouse sul ADBMobileConfig.json] file nella soluzione e selezionare Proprietà .
  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.

Aggiornare il file di configurazione ADBMobileConfig.json

Il ADBMobileConfig.json file contiene impostazioni SDK globali e si trova nella directory principale del progetto dopo aver completato i passaggi descritti nella sezione Aggiungi la libreria e il file di configurazione al progetto . Se il ADBMobileConfig.json file non è stato preconfigurato da Adobe Mobile Services, devi aggiornare alcuni valori per iniziare.
The following is an example of an ADBMobileConfig.json file:
{ 
    "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 per le soluzioni che utilizzi:
  • Analytics : rsids e server
  • Target : clientCode
  • Gestione dell'audience : server
Per ulteriori dettagli, vedi ADBMobileConfig.json config .

Eseguire il debug

Per abilitare il debug per l’SDK, devi chiamare ADBMobile.Config.setDebugLogging(true); .
Per le app C Sharp e JS, è 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

Fare clic con il pulsante destro del mouse sul progetto, selezionare Proprietà > scheda ​Debug. Nel menu a discesa Debugger, selezionate Solo ​nativo.

JS

Fate clic con il pulsante destro del mouse sul progetto, selezionate Proprietà > Proprietà ​configurazione > scheda Debug . Cambia il tipo di debugger a discesa in Solo ​nativo.
Tutto qui. Ora sei pronto per implementare Analytics, Target e Gestione dell'audience nell'app Windows 8.1 Universal App Store.