Anhand dieser Informationen können Sie die Variablen in der Konfigurationsdatei ADBMobile.json verstehen.
ADBMobileConfig.json
Referenz zur KonfigurationsdateiSie können die Konfigurationsdatei für Ihre App über mehrere Plattformen hinweg verwenden:
Unter Android muss sich ADBMobileConfig.json
im Ordner assets
befinden.
Hier finden Sie eine Liste der Variablen in der JSON-Datei und die minimale SDK-Version, die Sie für jede Variable benötigen:
acquisition
server
: der Akquise-Server, der beim ersten Start auf einen Akquise-Referrer überprüft wird.appid
: die generierte ID, die diese App auf dem Akquise-Server eindeutig identifiziert.Wenn dieser Abschnitt fehlt, aktivieren Sie die App-Akquise und laden Sie die SDK-Konfigurationsdatei erneut herunter. Weitere Informationen finden Sie unter referrerTimeout in dieser Variablenliste.
analyticsForwardingEnabled
Mindestens SDK-Version 4.8.0.
Der Standardwert lautet false
.
Die Eigenschaft im Objekt audienceManager
. Wenn Audience Manager konfiguriert ist und analyticsForwardingEnabled
auf true
festgelegt ist, wird sämtlicher Analytics-Datenverkehr auch an Audience Manager weitergeleitet.
backdateSessionInfo
Mindestens SDK-Version 4.6.
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.
Aktivieren oder Deaktivieren von Treffern
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.
Zurückdatierte Sitzungstrefferinformationen werden in einem Sitzungsinformations-Server-Aufruf gesendet und zusätzliche Server-Aufrufe werden ggf. angewendet.
batchLimit
Mindestens SDK-Version 4.1
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.
Beachten Sie die folgenden Informationen:
0
. Das bedeutet, dass die Stapelverarbeitung nicht aktiviert ist.offlineEnabled = true
.charset
Mindestens SDK-Version 4.0
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.
clientCode
Mindestens SDK-Version 4.0
Ihr zugewiesener Client-Code.
Diese Variable ist für Target erforderlich.
coopUnsafe
marketingCloud
, das, wenn auf true
festgelegt, dazu führt, dass das Gerät aus der Experience Cloud-Gerätekooperation ausgeschlossen wird.false
.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
Analytics-Treffer.environmentId
Mindestens SDK-Version 4.14
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
Mindestens SDK-Version 4.0
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
offlineEnabled
Mindestens SDK-Version 4.0
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
.
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 an den Kundenservice 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.
org
poi
Mindestens SDK-Version 4.0
Jedes POI-Array beinhaltet den POI-Namen, den Längen- und den Breitengrad sowie den Radius in Metern des POI-Bereichs.
Für den POI-Namen kann eine beliebige Zeichenfolge gewählt werden. Wenn beim Senden eines trackLocation
-Aufrufs die aktuellen Koordinaten zu einem definierten POI passen, wird eine Kontextdatenvariable gefüllt und zusammen mit dem trackLocation
-Aufruf gesendet.
"poi": [
["san francisco",37.757144,-122.44812,7000]
["santa cruz",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
Mindestens SDK-Version 4.6
Im Folgenden finden Sie eine Definition der Nachrichtenvorlage „Rückruf“:
"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-Type header. 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 timing out. Default is 2.}
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.
privacyDefault
Mindestens SDK-Version 4.0
Der Standardwert lautet optedin
.
optedin
werden die Treffer sofort gesendet.optedout
werden Treffer verworfen.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.
referrerTimeout
Mindestens SDK-Version 4.1
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
Mindestens SDK-Version 4.2
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.rsids
Mindestens SDK-Version 4.0
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
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.ssl
Mindestens SDK-Version 4.0
Der Standardwert lautet false
.
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 POST type is selected this will be set as the Content-Type header. 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 timing& out. Default is 2.}
timeout
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“
Generierte ID, erforderlich
„template“
„showOffline“
„showRule“
„endDate“
„startDate“
„payload“
„audiences“
„matches“
„values“
„triggers“