Schnellstart für Entwickler

Im Folgenden finden Sie einige Informationen zur Implementierung der universellen Windows-Plattformbibliothek.

WICHTIG

Zum Implementieren des SDK benötigen Sie Visual Studio 2013 oder höher.

SDK abrufen

Nachdem Sie die SDK-Download -Datei entpackt haben, verfügen Sie für jede unterstützte Architektur- und Plattformkombination über einen separaten Ordner. Sie haben auch eine ADBMobileConfig.json Datei. Weitere Informationen zu dieser Datei finden Sie in der Konfigurationsdatei ADBMobileConfig.json.

Select the correct version

Für jede unterstützte Architektur (x86, x64, ARM) werden verschiedene .dll/.winmd Dateien bereitgestellt.

WICHTIG

Die Version von ADBMobile.winmd spiegelt nicht die Version der Bibliothek wider. Die .winmd Datei enthält nur Metadaten und verfügt über eine Versionsnummer 255.255.255.255, die gemäß Microsoft akzeptiert wird. Weitere Informationen finden Sie unter Wie füge ich Assemblyinformationen für eine WinRT C++/CX-Komponente hinzu?. Um die Version der verwendeten Bibliothek zu überprüfen, überprüfen Sie die Version der zugrunde liegenden ADBMobile.dll Datei.

Syntaxunterschiede

Die universelle Windows-Plattform-Bibliothek kann in verschiedenen Programmiersprachen verwendet werden. Die Beispiele in diesem Handbuch sind in WinJS (JavaScript), wenn Sie eine andere Sprache verwenden, müssen möglicherweise geändert werden. Wenn Sie winmd-Methoden von winJS verwenden, wird bei allen Methoden automatisch der erste Buchstabe gekürzt.

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.

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 Referenzen und wählen Sie Hinzufügen Referenz.

  3. Wählen Sie die richtige Version der Bibliothek und navigieren Sie zur zugehörigen Datei ADBMobile.winmd.

    Weitere Informationen finden Sie unter Auswählen der richtigen Version auf dieser Seite.

  4. Klicken Sie auf Hinzufügen.

  5. Vergewissern Sie sich, dass die Datei ADBMobile.winmd im Fenster Reference Manager markiert ist, und klicken Sie auf OK.

  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Referenzen und wählen Sie Hinzufügen Referenz.

    Wenn auch ein C+±Projekt in Ihrer Lösung vorhanden ist, überspringen Sie diesen Schritt.

  7. Wählen Sie auf der linken Registerkarte " Windows "die Option " Erweiterungen", wählen Sie Visual C++ 2015 Runtime for Universal Windows Platform Apps aus und fügen Sie sie hinzu.

  8. hinzufügen Sie die folgende Zeile zu Ihrer Klasse:

    using ADBMobile;
    
  9. Klicken Sie mit der rechten Maustaste auf Ihr Projekt und klicken Sie auf Hinzufügen > Vorhandenes Element.

  10. Navigieren Sie zur 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 Datei ADBMobile.winmd einen Verweis hinzu.

    Weitere Informationen finden Sie unter Auswählen der richtigen Version auf dieser Seite.

  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 .

  6. hinzufügen Sie die folgende Zeile zu Ihrer Klasse:

    using namespace ADBMobile;
    
  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 " 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.

  3. Wählen Sie die richtige Version der Bibliothek und navigieren Sie zur zugehörigen Datei ADBMobile.winmd.

  4. Klicken Sie auf Hinzufügen.

  5. Vergewissern Sie sich, dass die Datei ADBMobile.winmd im Fenster Reference Manager markiert ist, und klicken Sie auf OK.

  6. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Referenzen und wählen Sie Hinzufügen Referenz.

    Wenn auch ein C+±Projekt in Ihrer Lösung vorhanden ist, überspringen Sie diesen Schritt.

  7. Wählen Sie auf der linken Registerkarte " Windows "die Option " Erweiterungen "und wählen Sie Visual C++ 2015 Runtime for Universal Windows Platform Apps und fügen Sie sie 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 Bibliothek und Konfigurationsdatei für Ihr Projekt ausgeführt haben. Wenn Ihre ADBMobileConfig.json Datei nicht von Adobe Mobile Services vorkonfiguriert wurde, müssen Sie zunächst einige Werte aktualisieren.

Im Folgenden finden Sie ein Beispiel für eine ADBMobileConfig.json-Datei:

{ 
    "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 verwendeten Lösungen:

  • Adobe Analytics: rsids und server

  • Adobe Target: clientCode

  • Adobe Audience Manager: server

For more information, see SDK methods.

Debugging von

Rufen Sie zum Aktivieren des Debuggens für das SDK auf ADBMobile.Config.setDebugLogging(true);.

Für C Sharp- und JavaScript-Apps müssen Sie das Debugging von nativem Code aktivieren, indem Sie die folgenden Schritte ausführen (für C+±Apps ist das native Code-Debugging die Standardeinstellung):

C Scharf

  1. Klicken Sie mit der rechten Maustaste auf das Projekt und klicken Sie auf Eigenschaften > Registerkarte Debuggen.

  2. Ändern Sie die Dropdown-Liste "Debugger-Typ"in " Nur nativ".

JavaScript

  1. Klicken Sie mit der rechten Maustaste auf das Projekt und dann auf die Registerkarte Eigenschaften > Konfigurationseigenschaften > Debug.

  2. Ändern Sie die Dropdown-Liste "Debugger-Typ"in " Nur nativ".

Das ist alles! Sie können jetzt Analytics, Zielgruppe und Audience-Management in Ihre Universal Windows Platform-App implementieren.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free