Show Menu
THEMEN×

Developer Quick Beginn

Sie benötigen Visual Studio 2013 oder höher, um das SDK zu implementieren.

SDK abrufen

Nachdem Sie den SDK-Download entpackt haben, verfügen Sie für jede unterstützte Architektur- und Plattformkombination über einen separaten Ordner. Sie haben auch eine ADBMobileConfig.json Datei, die weiter unten in diesem Handbuch beschrieben wird.

Wählen Sie die richtige Version

Für jede Zielgruppe (Windows 8.1, Windows Phone 8.1) und für jede unterstützte (x86, x64, ARM) stehen verschiedene .dll / .winmd -dateien zur Verfügung. Die Dateien werden wie folgt in eine Ordnerstruktur aufgeteilt:
Die Version von ADBMobile.winmd spiegelt nicht die Version der Bibliothek wider. Die .winmd Datei enthält nur Metadaten und hat als solche eine Versionsnummer, 255.255.255.255 die nach Microsoft akzeptiert wird (siehe Wie füge ich Assemblyinformationen für eine WinRT C++/CX-Komponente dll hinzu? ). Um die Version der verwendeten Bibliothek zu überprüfen, überprüfen Sie die Version der zugrunde liegenden ADBMobile.dll Datei.

Syntaxunterschiede

Die Windows 8.1 Universal App Store-Bibliothek kann in verschiedenen Programmiersprachen verwendet werden. Die Beispiele in diesem Handbuch sind in WinJS (JavaScript) enthalten und müssen ggf. geändert werden, wenn Sie eine andere Sprache verwenden. Beachten Sie, dass bei Verwendung der winmd-Methoden von winJS (JavaScript) alle Methoden automatisch ihren ersten Buchstaben verkleinert haben.
Der Hauptunterschied zwischen den Implementierungen ist die für Kontextdaten verwendete Datenstruktur.
Verwenden Sie außerdem bei Verwendung des SDK in einem WinJS-Projekt eine leere Zeichenfolge ( "" oder '' ) anstelle null von Werten für leere Zeichenfolgen.

Bibliothek und Konfigurationsdatei in Ihr Projekt Hinzufügen - C Sharp

  1. Starten Sie Visual Studio und öffnen Sie Ihre Projektmappe.
  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Referenzen und wählen Sie Hinzufügen Referenz .
  3. Wählen Sie die richtige Version der Bibliothek aus und navigieren Sie zur entsprechenden ADBMobile.winmd Datei.
    Weitere Informationen finden Sie im Abschnitt zur Auswahl der richtigen Version .
  4. Klicken Sie auf Hinzufügen .
  5. Vergewissern Sie sich, dass im Fenster ADBMobile.winmd Referenz-Manager die Option ausgewählt ist, und klicken Sie auf OK .
    Wenn Sie einer Windows Phone-App eine Referenz hinzufügen, ändern Sie zur Auswahl ADBMobile.winmd den Standarddateifilter von Komponentendateien in Alle Dateien .
  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Referenzen und wählen Sie Hinzufügen Referenz .
    Überspringen Sie diesen Schritt, wenn Sie auch ein C++-Projekt in Ihrer Lösung haben.
  7. Wählen Sie auf der linken Registerkarte " Windows "die Option " Erweiterungen "und wählen Sie dann Microsoft Visual C++ 2013 Runtime Package for Windows aus und fügen Sie es hinzu.
  8. hinzufügen Sie die folgende Zeile zu Ihrer Klasse:
    using ADBMobile;
    
    
  9. Klicken Sie mit der rechten Maustaste auf Ihr Projekt und wählen Sie Hinzufügen > Vorhandenes Element .
  10. Navigieren Sie zu Ihrer ADBMobileConfig.json Datei und klicken Sie auf Hinzufügen .
  11. Klicken Sie mit der rechten Maustaste auf die ADBMobileConfig.json Datei in Ihrer Lösung und wählen Sie Eigenschaften .
  12. Ändern Sie die Aktion Erstellen in Inhalt .

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

  1. Starten Sie Visual Studio und öffnen Sie Ihre Projektmappe.
  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt und wählen Sie Hinzufügen > Referenzen .
  3. Wählen Sie die richtige Version der Bibliothek aus und fügen Sie der zugehörigen ADBMobile.winmd Datei einen Verweis hinzu.
    Weitere Informationen finden Sie im Abschnitt zur Auswahl der richtigen Version .
  4. Klicken Sie auf Hinzufügen .
  5. Überprüfen Sie im Fenster Referenz-Manager , ob die Option ausgewählt ADBMobile.winmd ist, und klicken Sie auf OK .
    Wenn Sie einer Windows Phone-App eine Referenz hinzufügen, ändern Sie zur Auswahl ADBMobile.winmd den Standarddateifilter von Komponentendateien in Alle Dateien .
  6. hinzufügen Sie die folgende Zeile zu Ihrer Klasse:
    using namespace ADMS::Measurement;
    
    
  7. Klicken Sie mit der rechten Maustaste auf Ihr Projekt und wählen Sie Hinzufügen > Vorhandenes Element .
  8. Navigieren Sie zur ADBMobileConfig.json Datei und klicken Sie auf Hinzufügen .
  9. Klicken Sie mit der rechten Maustaste auf die ADBMobileConfig.json Datei in Ihrer Lösung und wählen Sie Eigenschaften .
  10. Ändern Sie auf der Registerkarte " Allgemein "den Eintrag " Inhalt "in " Ja "und klicken Sie auf "OK" .

Add the library and config file to your project - WinJS

  1. Starten Sie Visual Studio und öffnen Sie Ihre Projektmappe.
  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Referenzen und wählen Sie Hinzufügen Referenz .
    Weitere Informationen finden Sie im Abschnitt zur Auswahl der richtigen Version .
  3. Wählen Sie die richtige Version der Bibliothek aus und navigieren Sie dann zur entsprechenden ADBMobile.winmd Datei.
  4. Klicken Sie auf Hinzufügen .
  5. Überprüfen Sie, ob diese Option im Fenster ADBMobile.winmd Referenz-Manager aktiviert ist, und klicken Sie auf OK .
    Wenn Sie einer Windows Phone-App eine Referenz hinzufügen, ändern Sie zur Auswahl ADBMobile.winmd den Standarddateifilter von Komponentendateien in Alle Dateien .
  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Referenzen und wählen Sie Hinzufügen Referenz .
    Überspringen Sie diesen Schritt, wenn Sie auch ein C++-Projekt in Ihrer Lösung haben.
  7. Wählen Sie auf der linken Registerkarte " Windows "die Option " Erweiterungen "und wählen Sie Microsoft Visual C++ 2013 Runtime Package for Windows aus und fügen Sie es hinzu.
  8. Klicken Sie mit der rechten Maustaste auf Ihr Projekt und wählen Sie Hinzufügen > Vorhandenes Element .
  9. Navigieren Sie zur ADBMobileConfig.json Datei und klicken Sie auf Hinzufügen .
  10. Klicken Sie mit der rechten Maustaste auf die ADBMobileConfig.json] Datei in Ihrer Lösung und wählen Sie Eigenschaften .
  11. Stellen Sie bei aktivierten Dateieigenschaften sicher, dass für die Paketaktion der Inhalt festgelegt ist.
    Bei JavaScript-Projekten ist die Datei standardmäßig auf Inhalt eingestellt.

ADBMobileConfig.json-Konfigurationsdatei aktualisieren

Die ADBMobileConfig.json Datei enthält globale SDK-Einstellungen und befindet sich im Projektstamm, nachdem Sie die Schritte im Abschnitt Hinzufügen Bibliotheks- und Konfigurationsdatei zu Ihrem Projekt ausgeführt haben. Wenn Ihre ADBMobileConfig.json Datei nicht von Adobe Mobile Services vorkonfiguriert wurde, müssen Sie zunächst einige Werte aktualisieren.
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" 
 } 
}

Aktualisieren Sie mindestens die folgenden Werte für die von Ihnen verwendeten Lösungen:
  • Analytics : rsids und server
  • Target : clientCode
  • Zielgruppen-Management : server
Weitere Informationen finden Sie unter ADBMobileConfig.json config .

Debugging

Wenn Sie das Debugging für das SDK aktivieren möchten, müssen Sie aufrufen ADBMobile.Config.setDebugLogging(true); .
Für C Sharp- und JS-Apps müssen Sie das Debugging von nativem Code aktivieren, indem Sie die folgenden Schritte ausführen (das native Code-Debugging ist die Standardeinstellung für C++-Apps):

C Scharf

Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie Eigenschaften > Registerkarte Debuggen . Wählen Sie in der Dropdownliste Debugger die Option Nur nativ.

JS

Klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie Eigenschaften > Konfigurationseigenschaften > Registerkarte Debuggen . Ändern Sie die Dropdown-Liste "Debugger-Typ"in " Nur nativ".
Das ist alles! Sie können jetzt Analytics, Zielgruppe und Audience-Management in Ihrer Windows 8.1 Universal App Store-App implementieren.