Implementierung von AAM für Android

Implementierung von AAM für Android

Suchen
Benutzerhandbuch

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Einführung

AAM für Mobile kann verwendet werden, um die Mobile- und Desktop-Zielgruppendaten eines Werbetreibenden für Erst- und Drittanbieter zu erfassen, zu organisieren und aufzuteilen. Unterstützung eines Marketingexperten bei der Erstellung, Analyse und Durchführung von Marketingkampagnen. Der Audience Manager kann in mehrere Plattformen und mobile Betriebssysteme integriert werden.

Dieser Artikel konzentriert sich auf die Implementierung von Adobe Audience Manager in Android Mobile-Apps.  Dieser Artikel ist technischer Natur, da die Zielgruppe Android-Entwickler sind, die die Lösung implementieren und validieren.

Der Implementierungsratgeber ist für die Implementierung von Audience Manager spezifisch, wenn sowohl der Experience Cloud-Dienst als auch die Kerndienste für den Client implementiert sind. Wenn der Experience Cloud-Dienst für den Client implementiert ist und die Kerndienste nicht implementiert sind, prüfen Sie die Implementierungs-Technik, speziell mit Experience Cloud-Service. Wenn der Experience Cloud-Dienst (Besucher-ID-Dienst) nicht aktiviert ist, beziehen Sie sich auf den entsprechenden Implementierungsratgeber auf der Clientseite.

Voraussetzungen

Sie sollten die Adobe SDK-Dateien heruntergeladen haben, um mit der Implementierungs-Einrichtung von Audience Manager zu beginnen. Wenn Sie über den Analytics-Administratorzugriff verfügen, können Sie die App in Adobe Mobile Services einrichten und das SDK für Ihre App herunterladen. Wenn Sie keinen Zugriff auf Adobe Mobile Services haben, können Sie das SDK über folgenden Link herunterladen: https://github.com/Adobe-Marketing-Cloud/mobile-services/releases?

Suchen Sie nach dem neuesten Android-SDK und laden Sie die AdobeMobileLibrary-4 herunter.*-Android.zip-Datei. Sie sollten die folgenden Softwarekomponenten darin haben:

  • adobeMobileLibrary.jar: Bibliothek für die Verwendung mit Android-Geräten und Simulatoren entworfen.
  • ADBMobileConfig.json: Eine für Ihre App angepasste SDK-Konfigurationsdatei.

Fügen Sie die adobeMobileLibrary.jar als Dateiabhängigkeit unter „Abhängigkeiten“ innerhalb Ihrer Projektstruktur hinzu, wie im folgenden Screenshot gezeigt:

image1

Wenn Ihre App bereits für Adobe Analytics konfiguriert ist, wurden die oben genannten Schritte bereits zusammen mit der Kernimplementierung und Lebenszyklusmetrik-Implementierung durchgeführt und Sie können direkt mit dem Abschnitt „Audience Manager-Konfiguration“ fortfahren.

Kernimplementierung und Lebenszyklus

Das heruntergeladene SDK benötigt Android 2.2 oder höher, damit die Implementierung funktioniert.

1. Fügen Sie die ADBMobileConfig.json-Datei zum Assets-Ordner in Ihrem Projekt hinzu.

2. Fügen Sie App-Berechtigungen hinzu, damit die AppMeasurement-Bibliothek Offline-Tracking-Aufrufe senden und aufzeichnen kann. Um diese Berechtigungen hinzuzufügen, fügen Sie die folgenden Zeilen zu Ihrer AndroidManifest.xml-Datei hinzu (im Anwendungsprojektverzeichnis):

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. Implementieren Sie die Lebenszyklusmetriken (in jeder Aktivität in Ihrer Anwendung):

a. Importieren Sie die folgende Bibliothek:

 import com.adobe.mobile.*;

b. Beginnen Sie innerhalb der onResume-Funktion mit dem Sammeln von Lebenszyklusdaten:

@Override
public voidonResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}

 c. Pausieren Sie in der onPause-Funktion das Sammeln von Lebenszyklusdaten.

@Override
public voidonPause() {
Config.pauseCollectingLifecycleData();
}

4. Um zusätzliche Daten mit Lifecycle-Metric-Aufrufen einzubeziehen, übergeben Sie einen zusätzlichen Parameter an collectLifecycleData, der Kontextdaten enthält:

@Override
public voidonResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}

In dieser Dokumentation finden Sie einige Schritte, die ausgeführt werden müssen, wenn Sie IntelliJ IDEA oder Eclipse anstelle von Android Studio zum Konfigurieren der Apps verwenden: https://marke1ting.adobe.com/resources/help/en_US/mobile/android/dev_qs.html

Audience Manager-Konfiguration

1. Wenn wir die App in der Benutzeroberfläche für Mobile Services konfigurieren: https://mobilemarketing.adobe.com erhalten wir Optionen zum Aktivieren der serverseitigen Weiterleitung (SSF) im SDK-Konfigurationsabschnitt des Audience Managers.

Von dort aus können wir die Analytics-Weiterleitung prüfen und die untergeordnete Domäne für den Audience Manager eingeben. Nach dem Herunterladen der ADBMobileConfig.json-Datei werden alle erforderlichen Felder angezeigt.

 

image2
image2_1 
"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

Nachfolgend finden Sie Schritte zur manuellen Eingabe dieser Werte in die ADBMobileConfig.json-Datei. Geben Sie die folgenden Konfigurationsdetails in der ADBMobileConfig.json-Datei im Abschnitt für audienceManager und marketingCloud ein.

 

"marketingCloud" : {
  "org": "YOUR-MCORG-ID"
}
"audienceManager": {
    "server": "",
    "analyticsForwardingEnabled": "true",
  },

Hinweis:

  • Eine Voraussetzung für die serverseitige Weiterleitung von Analysedaten ist, dass der Client für den Experience Cloud ID-Dienst bereitgestellt werden sollte (https://marketing.adobe.com/resources/help/en_US/mcvid/).
  • Die Experience Cloud-Organisations-IDs identifizieren jedes Kundenunternehmen in der Adobe Experience Cloud eindeutig und ähneln dem folgenden Wert: 016D5C175213CCA80A490D05@AdobeOrg.       

Wenn die oben genannte Konfiguration eingerichtet ist, werden alle Lebenszyklusmetriken innerhalb des Analyseaufrufs erfasst und direkt über die Serverseite weitergeleitet:

image3

2. Erlauben Sie dem SDK-Zugriff auf Ihren Anwendungskontext mithilfe von Config.setContext innerhalb der onCreate-Methode in der Hauptaktivität:

@Override
public voidonCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// Allow the SDK access to the application context
Config.setContext(this.getApplicationContext());
}

Wenn Sie diesen Methodenaufruf bereits bei der Implementierung von Analytics oder Target hinzugefügt haben, müssen Sie ihn nicht erneut hinzufügen.

Überprüfen Sie die Implementierung

Im Folgenden finden Sie einige Checkpoints der Aufrufprotokolle, um die serverseitige Implementierung zu überprüfen:

Wenn eine Kunden-ID-Synchronisierung stattfindet, wird sie in „d_cid_ic“ im dpm.demdex.net-Netzwerkaufruf angezeigt. Wenn die serverseitige Implementierung abgeschlossen ist, wird kein zusätzlicher Audience Manager-Netzwerkaufruf durchgeführt. Die Daten aus Analytics werden serverseitig an den Audience Manager weitergeleitet.

image4

Beachten Sie, dass d_uuid im Anforderungsaufruf nicht verfügbar ist, wenn die serverseitige Weiterleitung zusammen mit der Besucher-ID-Implementierung erfolgt (im Gegensatz zur clientseitigen Implementierung). Sie sollten stattdessen den d_mid-Wert und die d_orgid-Werte sehen können, die dem Besucher-ID-Dienst im dpm.demdex.net-Aufruf zugeordnet sind. Der UUID-Wert wird jedoch in der Antwort angezeigt, die ungefähr so aussehen würde (dies wird im Analytics-Netzwerkaufruf angezeigt):

image5