Diese Informationen helfen Ihnen bei der Verwendung der Konfigurationsdatei ADBMobile.json
.
Sie können die Konfigurationsdatei für Ihre App über mehrere Plattformen hinweg verwenden:
Unter iOS können Sie die Datei ADBMobileConfig.json
an jedem beliebigen Speicherort ablegen, auf den vom Bundle aus zugegriffen werden kann.
acquisition
Aktiviert die Mobile App-Akquise.
Wenn dieser Abschnitt fehlt, aktivieren Sie die App-Akquise und laden Sie die SDK-Konfigurationsdatei erneut herunter. Weitere Informationen finden Sie unten unter referrerTimeout.
server
: Akquiseserver, der beim ersten Start für einen Akquise-Referrer überprüft wird.appid
: Generierte ID, die diese App auf dem Akquiseserver eindeutig identifiziert.analyticsForwardingEnabled
Die Eigenschaft im Objekt audienceManager
. Wenn Audience Manager
konfiguriert ist und analyticsForwardingEnabled
auf true
festgelegt ist, wird der gesamte Analytics-Datenverkehr ebenfalls an Audience Manager weitergeleitet. Der Standardwert lautet false
.
backdateSessionInfo
Aktiviert/Deaktiviert die Möglichkeit, dass das Adobe-SDK Treffer mit Sitzungsinformationen zurückdatiert.
Sitzungsinformationstreffer bestehen derzeit aus Abstürzen und Sitzungslängen und können aktiviert oder deaktiviert werden.
Wenn Sie den Wert auf false
einstellen, werden die Treffer deaktiviert.
Das SDK kehrt zum Verhalten vor 4.1 zurück, bei dem die Sitzungsinformationen für die vorherige Sitzung mit dem ersten Treffer der nachfolgenden Sitzung zusammengefasst wurden. Das Adobe-SDK fügt die Sitzungsinformationen auch an den aktuellen Lebenszyklus an, wodurch keine zu hohen Besuchszahlen erstellt werden. Da keine zu hohen Besuchszahlen mehr erstellt werden, tritt eine unmittelbare Reduktion der Besuchszahlen auf.
Wenn Sie keinen Wert einstellen, lautet der Standardwert true
und Treffer werden aktiviert.
Wenn die Treffer aktiviert sind, datiert das Adobe SDK den Sitzungsinformationstreffer auf 1 Sekunde nach dem letzten Treffer in der vorherigen Sitzung zurück. Das bedeutet, dass Absturz- und Sitzungsdaten dem korrekten Datum, an dem sie aufgetreten sind, entsprechen. Als eine Auswirkung davon könnte das SDK einen Besuch für den rückdatierten Treffer erstellen. Bei jedem Neustart der App wird ein Treffer zurückdatiert.
Mindestens SDK-Version 4.6
Zurückdatierte Sitzungstrefferinformationen werden in einem Sitzungsinformations-Server-Aufruf gesendet und zusätzliche Server-Aufrufe werden ggf. angewendet.
batchLimit
Grenzwert für die Anzahl der Treffer, die in aufeinanderfolgenden Aufrufen gesendet werden sollen. Wenn beispielsweise batchLimit
auf 10 festgelegt ist, wird jeder Treffer vor dem 10. Treffer in der Warteschlange gespeichert. Beim 10. Treffer werden alle 10 Treffer nacheinander gesendet.
0
. Das bedeutet, dass die Stapelverarbeitung nicht aktiviert ist.offlineEnabled = true
.charset
Definiert den Zeichensatz, den Sie für die an Analytics gesendeten Daten verwenden. Der Zeichensatz wird verwendet, um eingehende Daten zum Speichern und Reporting in das UTF-8-Format umzuwandeln. Weitere Informationen finden Sie unter charSet in der Adobe Analytics-Dokumentation.
clientCode
Ihr zugewiesener Client-Code.
Diese Variable ist für Target erforderlich.
coopUnsafe
Bei Mitgliedern mit Gerätekooperation, für die dieser Wert true
sein muss, müssen Sie sich an das Kooperationsteam wenden, um eine Sperrlisten-Markierung auf Ihrem Gerätekooperationskonto zu verlangen. Es gibt keinen Self-Service-Pfad zum Aktivieren dieser Kennzeichnungen.
Beachten Sie die folgenden Informationen:
coopUnsafe
auf true
festgelegt ist, wird coop_unsafe=1
immer an Audience Manager und Besucher-ID-Treffer angehängt.coop_unsafe=1
in den Analytics-Treffern.Zusätzliche Informationen:
marketingCloud
, das, wenn auf true
festgelegt, dazu führt, dass das Gerät aus der Experience Cloud-Gerätekooperation ausgeschlossen wird.false
.environmentId
Die ID der Umgebung, die Sie verwenden möchten. Sie können eine gültige ID angeben (environmentId=8
). Wenn environmentId
nicht enthalten ist, wird die standardmäßige Produktionsumgebung verwendet.
lifecycleTimeout
Der Standardwert ist 300 Sekunden.
Gibt die Dauer in Sekunden an, die zwischen dem Start der App und dem Moment verstreichen muss, in dem die App als neue Sitzung erachtet wird. Dieses Time-out gilt auch, wenn Ihre Anwendung in den Hintergrund gestellt und reaktiviert wird. Die Zeit, die Ihre App im Hintergrund ist, ist nicht in der Sitzungslänge enthalten.
messages
Wird automatisch von Adobe Mobile Services generiert und definiert die Einstellungen für In-App-Nachrichten. Weitere Informationen finden Sie unten im Abschnitt Nachrichtenbeschreibung.
offlineEnabled
Ist diese Option aktiviert, werden Treffer in die Warteschlange aufgenommen, während das Gerät offline ist, und erst gesendet, wenn es wieder online ist. Für Ihre Report Suite müssen Zeitstempel aktiviert sein, um die Offline-Verfolgung zu nutzen. Der Standardwert lautet false
.
Im Folgenden einige wichtige Hinweise:
Wenn Zeitstempel für Ihre Report Suite aktiviert sind, offlineEnabled
muss Ihre Konfigurationseigenschaft wahr sein.
Wenn Zeitstempel nicht für Ihre Report Suite aktiviert sind, offlineEnabled
muss die Konfigurationseigenschaft „false“ lauten.
Wenn dies nicht ordnungsgemäß konfiguriert ist, gehen Daten verloren. Wenn Sie sich nicht sicher sind, ob Zeitstempel für Ihre Report Suite aktiviert sind, wenden Sie sich bitte an Wenden Sie sich an die Kundenunterstützung oder laden Sie die Konfigurationsdatei aus Adobe Mobile Services herunter. Wenn Sie aktuell AppMeasurement-Daten in einer Report Suite erfassen, in der auch Daten aus JavaScript gesammelt werden, müssen Sie möglicherweise eine separate Report Suite für mobile Daten einrichten oder einen benutzerdefinierten Zeitstempel für JavaScript-Treffer einfügen, die die Variable s.timestamp
nutzen.
Mindestens SDK-Version 4.0
org
Gibt die Experience Cloud-Organisations-ID für den Identity-Dienst für Adobe Experience Platform an.
poi
Jedes POI-Array beinhaltet den POI-Namen, den Längen- und Breitengrad sowie den Radius (in Metern) des POI-Bereichs. Für den POI-Namen kann eine beliebige Zeichenfolge gewählt werden. Wenn ein trackLocation
-Aufruf gesendet wird, wird eine Kontextdatenvariable aufgefüllt und mit dem trackLocation
-Aufruf gesendet, sofern sich die aktuellen Koordinaten an einem definierten POI befinden.
"poi" [
["sanfrancisco",37.757144,-122.44812,7000]
["santacruz",36.972935,-122.01725,600]
]
Ab Version 4.2 sind POIs auf der Adobe Mobile-Oberfläche definiert und werden dynamisch mit der App-Konfigurationsdatei synchronisiert. Diese Synchronisation erfordert die Einstellung analytics.poi
:
"analytics.poi": "`https://assets.adobedtm.com/…/yourfile.json`",
Wenn diese Einstellung nicht konfiguriert ist, muss die Datei ADBMobile.json
um folgende Zeile ergänzt werden. Informationen zum Herunterladen einer aktualisierten Konfigurationsdatei finden Sie unter Vorbereitung.
postback
Die Definition der „callback“-Nachrichtenvorlage wird im Folgenden gezeigt:
"payload":{
"templateurl":"",//required- will be token-expanded prior to being sent
"templatebody":"", //optional-if this length > 0 POST will be used as transport method. This is a base-64 encoded blob,which will be decoded and token-expanded prior to being sent.
"contenttype":"", //optional-if this is length > 0 and POST type is selected, this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
"timeout": 0 //optional-number of seconds to wait before timingout.Defaultis2.}
Das Objekt payload
im Code stellt eine Beispiel-Payload für eine Nachrichtendefinition dar, die in der Datei ADBMobileConfig.json
verwendet werden würde. Weitere Informationen dazu finden Sie unter Postbacks.
privacyDefault
Für optedin
werden die Treffer sofort gesendet.
Bei optedout
werden Treffer verworfen.
Wenn der Wert optunknown
lautet und für ihre Report Suite Zeitstempel aktiviert sind, werden Treffer gespeichert, bis sich der Datenschutzstatus zu „optedin“ (Treffer werden gesendet) oder „optedout“ (Treffer werden verworfen) ändert.
Wenn für Ihre Report Suite keine Zeitstempel aktiviert sind, werden die Treffer verworfen, bis der Datenschutzstatus zu „optedin“ geändert wird.
Dadurch wird nur der Ausgangswert festgelegt. Wenn dieser Wert im Code festgelegt oder geändert wird, wird der neue Wert verwendet, bis er wieder geändert oder die App entfernt und erneut installiert wird. Der Standardwert lautet optedin
.
Mindestens SDK-Version 4.0
referrerTimeout
Anzahl der Sekunden, die das SDK beim ersten Start auf Akquise-Werber-Daten wartet, bevor das Time-out erfolgt. Wenn Sie Akquise verwenden, empfehlen wir ein 5-Sekunden-Time-out.
Diese Variable ist für Akquise erforderlich. Wenn die Variable auf 0
festgelegt oder nicht enthalten ist, wartet das SDK nicht auf Akquise-Daten und Akquise-Metriken werden nicht verfolgt.
remotes
Wird automatisch konfiguriert und definiert die von Adobe gehosteten Endpunkte für dynamische Konfigurationsdateien. Bei jedem Start wird der Zeitpunkt der letzten Aktualisierung der einzelnen Konfigurationsdateien mit der aktuellen Version verglichen. Etwaige Updates werden dann heruntergeladen und gespeichert.
analytics.poi
: der Endpunkt für die gehostete POI-Konfiguration.
messages
: der Endpunkt für die gehostete Konfiguration von In-App-Nachrichten.
Mindestens SDK-Version 4.2
rsids
Eine oder mehrere Report Suites zum Empfangen von Analytics-Daten. Mehrere Report Suite-IDs sollten durch Kommata getrennt werden, wobei kein Leerzeichen dazwischen steht.
"rsids": "rsid"
"rsids" : "rsid1,rsid2"
Diese Variable ist für Analytics erforderlich.
server
Der Analytics- oder Zielgruppen-Management-Server, basierend auf dem übergeordneten Knoten.
Diese Variable sollte mit der Serverdomäne aufgefüllt werden, und zwar ohne das Protokollpräfix https://
oder https://
. Das Präfix basiert auf der Variablen ssl
und wird automatisch von der Bibliothek verarbeitet.
Wenn ssl
auf true
gesetzt ist, wird eine sichere Verbindung zu diesem Server hergestellt. Wenn ssl
auf false
gesetzt ist, wird eine nicht sichere Verbindung zu diesem Server hergestellt.
Diese Variable ist für Analytics und/oder Zielgruppen-Management erforderlich.
ssl
Ab Version 4.10.0 ist SSL standardmäßig auf true gesetzt, wenn das Flag nicht gesetzt ist.
Aktiviert (true
) oder deaktiviert (false
) die Möglichkeit, Messdaten mithilfe von SSL (HTTPS) zu senden.
Die Definition der „callback“-Nachrichtenvorlage wird im Folgenden gezeigt:
"payload":{
"templateurl":"",//required-will be token-expanded prior to being sent
"templatebody":"",//optional-if this length > 0, POST will be used as transport method. This is a base64 encoded blob,which will be decoded and token-expanded prior to being sent.
"contenttype":"",//optional-if this is length > 0 and POST type is selected this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
"timeout":0//optional-numberofsecondstowaitbeforetimingout.Defaultis2.}
Das Objekt payload
im Code stellt eine Beispiel-Payload für eine Nachrichtendefinition dar, die in die Datei ADBMobileConfig.json
aufgenommen wird. Weitere Informationen dazu finden Sie unter Postbacks.
timeout
Bestimmt, wie lange Target auf eine Antwort wartet.
ADBMobileConfig.json
Im Folgenden finden Sie eine beispielhafte Datei ADBMobileConfig.json
:
{
"version": "2014-08-05T19:18:28.169Z",
"marketingCloud" : {
"org": "016D5C175213CCA80A490D05@AdobeOrg",
"coopUnsafe": false
},
"target": {
"clientCode": "",
"timeout": 5,
"environmentId": 8
},
"audienceManager": {
"server": "",
"analyticsForwardingEnabled": false
},
"acquisition": {
"server": "c00.adobe.com",
"appid": "10a77a60192fbb628376e1b1daeeb65debf934e2c807e067ceb2963a41b165ee"
},
"analytics": {
"rsids": "coolApp",
"server": "my.CoolApp.com",
"ssl": true,
"offlineEnabled": true,
"charset": "UTF-8",
"lifecycleTimeout": 300,
"privacyDefault": "optedin",
"batchLimit": 0,
"referrerTimeout": 5,
"poi": [
["san francisco",37.757144,-122.44812,7000],
["santa cruz",36.972935,-122.01725,600]
]
},
"messages": [
{
"messageId": "cb426565-a563-497a-a889-9dbeb451f8ae",
"template": "fullscreen",
"payload": {
"html": "<!DOCTYPE html><html><head><meta charset=\"utf-8\" /><title></title><style></style></head><body><iframe src=\"https://www.adobe.com/\" frameborder=\"0\"></iframe></body></html>"
},
"showOffline": false,
"showRule": "always",
"endDate": 2524730400,
"startDate": 0,
"audiences": [],
"triggers": [
{
"key": "pev2",
"matches": "eq",
"values": [
"AMACTION:custom"
]
}
]
}
],
"remotes": {
"analytics.poi": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0faadc2f9ed92bc00003b.json",
"messages": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0f9e2c2f9ed92bc000032.json"
}
}
Der Nachrichtenknoten wird automatisch von Adobe Mobile Services generiert und muss in der Regel nicht manuell geändert werden. Die folgende Beschreibung dient der Fehlerbehebung:
„messageId“
„template“
„payload“
„html“
„image“
„altImage“
nur Vollbild, optional
Name des gebündelten Bildes, das verwendet werden soll, wenn die in
image
angegebene URL nicht erreichbar ist
„title“
„content“
„confirm“
„cancel“
„url“
„wait“
„showOffline“
„showRule“
„endDate“
„startDate“
„audiences“
Eine Gruppe von Objekten, die definieren, wie die Meldung angezeigt werden soll:
„key“
Variablenname, der im Treffer zu finden und erforderlich ist.
„matches“
Typ des Matchers, der für den Vergleich verwendet wird:
„values“
Eine Gruppe von Werten, die mit dem Wert der Variablen verglichen werden, die hier benannt sind:
„triggers“
Wie Zielgruppen, nur dass hier an die Stelle der Zielgruppen die Aktionen treten: