Mit dem Integrationsmodul können Adobe-Partner ihre Datenerfassung mit Ihrem Unternehmen integrieren. Diese Integration bietet die Möglichkeit einer Datenverbindung in beide Richtungen. Normalerweise wird die Verwendung des Integrationsmoduls von einem Adobe-Partner gesteuert.
Das Anfordern von Partnerdaten in Ihrer Implementierung kann zu Verzögerungen zwischen dem Laden der Seite und den an die Adobe-Datenerfassungs-Server gesendeten Daten führen. Wenn ein Besucher eine neue Seite lädt, bevor Daten gesendet werden, wird diese Seite nicht aufgezeichnet.
get
-Anforderung von Partnerdaten auslöst.get
-Anforderung und packt die entsprechenden Variablen in ein JSON-Objekt. Das JSON-Objekt wird zurückgegeben.setVars
auf, um die im JSON-Objekt enthaltenen Informationen Adobe Analytics-Variablen zuzuweisen.Eine Organisation, die mit einem Adobe-Partner zusammenarbeitet, kann diese Schritte verwenden, um erfolgreich mit der Verwendung des Integrationsmoduls zu beginnen.
Für den Erhalt des Modulcodes ist ein Benutzer mit Produktadministratorzugriff erforderlich, der zu einem Produktprofil mit Zugriff auf den Code-Manager gehört. Die Methode zum Abrufen von Modul-Code ist für alle Implementierungsmethoden gleich, einschließlich Tags in Adobe Experience Platform.
AppMeasurement_Module_Integrate.js
.Für die Implementierung des Integrate-Moduls auf Ihrer Site ist der Zugriff auf die Adobe Experience Platform-Datenerfassung erforderlich. Wenn Sie eine ältere JavaScript-Implementierung verwenden, ist der Zugriff auf den Quellcode der Website Ihres Unternehmens erforderlich.
Nachdem das Integrationsmodul implementiert wurde, konfigurieren Sie es mit diesen Methoden, um Daten vom gewünschten Adobe-Partner zu senden und zu empfangen.
Die add
-Methode instanziiert ein Partnerobjekt, das als Zwischenspeicher variabler Daten dient, wenn Daten zwischen Partnersystemen und Ihrer Implementierung freigegeben werden. Diese Methode ist für alle Integrationen erforderlich. Für jeden eindeutigen Partner muss ein separates Partnerobjekt verwendet werden, wenn in einer Implementierung mehrere Partner verwendet werden.
s.Integrate.add("<partner_name>");
Ihr Unternehmen arbeitet normalerweise mit einem Adobe-Partner zusammen, um den Wert für den Partnernamen zu ermitteln.
Die beacon
-Methode erstellt eine Bildanforderung und verweist sie auf die angegebene URL. Diese Bildanforderungen unterscheiden sich von den Standard-Bildanforderungen. Die Beacon-Methode sendet normalerweise Daten an den Adobe-Partner und nicht an Adobe-Datenerfassungsserver.
p.beacon("<partner_url>/track?qs1=value1&qs2=value2");
Ihr Unternehmen arbeitet normalerweise mit dem Adobe-Partner zusammen, um den Wert für den Partnernamen zu ermitteln. Die Abfragezeichenfolgen in der URL sind optional und vom Partner abhängig. Das Integrationsmodul enthält automatisch eine Abfragezeichenfolge mit einer Zufallszahl, um die Zwischenspeicherung im Browser zu verhindern.
Adobe arbeitet intern mit Teams zusammen, um diese Methode zu dokumentieren.
Mit der get
-Methode kann ein Client Partnervariablen importieren und im Partnerobjekt speichern. Sobald sich die Daten im Partnerobjekt befinden, können sie Analytics-Variablen zugewiesen und in einer Bildanforderung gesendet werden. Diese Methode ruft eine URL auf, die auf ein JSON-Objekt verweist, das die gewünschten Daten enthält.
s.Integrate.<partner_name>.get("<url_to_json_object>?pid=value1&pid2=value2");
Das Integrationsmodul fügt der URL automatisch weitere Abfragezeichenfolgen hinzu. Eine Var-Abfragezeichenfolge gibt den Namen des JSON-Objekts an, das das Modul vom Partner zurückerwartet. Außerdem wird eine Zufallszahl hinzugefügt, um die Zwischenspeicherung im Browser zu verhindern.
Adobe arbeitet intern mit Teams zusammen, um diese Methode zu dokumentieren.
Die useVars
-Methode ermöglicht es dem Client, Variablenwerte mit einem Adobe-Partner zu teilen.
s.Integrate.<partner_name>.useVars = function (s,p) {
p.<partner_var1> = s.eVar1;
p.<partner_var2> = s.eVar2;
}
Ihr Unternehmen arbeitet normalerweise mit einem Adobe-Partner zusammen, um die Werte für den Partnernamen und die Variablen zu ermitteln, die der Partner verwendet.
Mit der setVars
-Methode kann der Client Analytics-Variablen mithilfe der abgerufenen Partnerdaten füllen. Partnerdaten können das Ergebnis einer get
-Methode, einer statischen Zuweisung oder eines anderen Mechanismus sein, der das Partnerobjekt mit Daten füllt.
s.Integrate.<partner_name>.setVars = function (s,p) {
s.eVar1 = p.<partner_var1>;
s.eVar2 = p.<partner_var2>;
}
Ihr Unternehmen arbeitet normalerweise mit einem Adobe-Partner zusammen, um die Werte für den Partnernamen und die Variablen zu ermitteln, die der Partner verwendet.
Mit der script
-Methode kann ein Adobe-Partner zusätzliche JavaScript-Daten von der Partner-Site aus aufrufen, wenn bestimmte Bedingungen erfüllt sind (z. B. wenn die Kampagnenvariable eingestellt ist).
p.script("<partner_url>/script?qs1=value1&qs2=value2");
Ihr Unternehmen arbeitet normalerweise mit dem Adobe-Partner zusammen, um den Wert für den Partnernamen zu ermitteln. Die Abfragezeichenfolgen in der URL sind optional und vom Partner abhängig. Das Integrationsmodul enthält automatisch eine Abfragezeichenfolge mit einer Zufallszahl, um die Zwischenspeicherung im Browser zu verhindern.