Integrationsmodul
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.
Arbeitsablauf für Integrationsmodule
- Ein Besucher Ihrer Site lädt eine Seite, die eine
get-Anforderung von Partnerdaten auslöst. - Der Adobe-Partner erhält die
get-Anforderung und packt die entsprechenden Variablen in ein JSON-Objekt. Das JSON-Objekt wird zurückgegeben. - Ihre Site empfängt das JSON-Objekt und ruft dazu
setVarsauf, um die im JSON-Objekt enthaltenen Informationen Adobe Analytics-Variablen zuzuweisen. - An die Adobe-Datenerfassungsserver wird eine Bildanforderung gesendet.
Implementierung von Integrationsmodulen
Eine Organisation, die mit einem Adobe-Partner zusammenarbeitet, kann diese Schritte verwenden, um erfolgreich mit der Verwendung des Integrationsmoduls zu beginnen.
Integrationsmodulcode abrufen
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.
- Melden Sie sich mit Ihren Adobe ID-Anmeldeinformationen bei experiencecloud.adobe.com an.
- Klicken Sie oben rechts auf das 9-Quadrat-Symbol und dann auf das farbige Analytics-Logo.
- Klicken Sie in der oberen Navigation auf Admin > Alle Administratoren > Code-Manager.
- Laden Sie die neueste JavaScript AppMeasurement-Bibliothek herunter.
- Entpacken Sie die Datei nach dem Herunterladen und suchen Sie
AppMeasurement_Module_Integrate.js.
Platzieren Sie das Integrationsmodul in Ihrer Implementierung
Für die Implementierung des Integrate-Moduls auf Ihrer Site ist der Zugriff auf die Datenerfassung von Adobe Experience Platform erforderlich. Wenn Sie eine ältere JavaScript-Implementierung verwenden, ist der Zugriff auf den Quellcode der Website Ihres Unternehmens erforderlich.
- Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
- Klicken Sie auf die Tag-Eigenschaft, die Sie bearbeiten möchten.
- Klicken Sie auf die Registerkarte „Erweiterungen“ und dann unter „Adobe Analytics“ auf „Konfigurieren“.
- Öffnen Sie „Tracker mit benutzerdefiniertem Code konfigurieren“ und klicken Sie dann auf „Editor öffnen“.
- Fügen Sie den Integrationsmodulcode in das modale Codefenster ein. Klicken Sie auf „Nach Abschluss speichern“.
Integrationsmodulmethoden
Nachdem das Integrationsmodul implementiert wurde, konfigurieren Sie es mit diesen Methoden, um Daten vom gewünschten Adobe-Partner zu senden und zu empfangen.
add
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.
Beacon
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.
Verzögerung
Adobe arbeitet intern mit Teams zusammen, um diese Methode zu dokumentieren.
get
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");
- Name des Partners: Ihr Unternehmen arbeitet normalerweise mit dem Adobe-Partner zusammen, um den Wert für den Partnernamen zu ermitteln.
- URL zum JSON-Objekt: Die URL zu einem JSON-Objekt, das die Partnervariablen enthält, die in eine Bildanforderung eingebunden werden sollen.
- Abfragezeichenfolgenparameter: Angaben zum Partnerkonto, die Ihre Organisation im System des Partners identifizieren. Der Adobe-Partner verwendet diese Informationen zur Identifizierung Ihres Datensatzes.
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.
Bereit
Adobe arbeitet intern mit Teams zusammen, um diese Methode zu dokumentieren.
useVars
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.
setVars
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.
script
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.