Adobe-Plug-in: pt
Das pt
-Plug-in führt eine Funktion oder Methode für eine Liste von Analytics-Variablen aus. Beispielsweise können Sie die clearVars
-Methode selektiv für mehrere Variablen ausführen, ohne die Methode jedes Mal manuell aufzurufen. Mehrere andere Plug-ins sind auf diesen Code angewiesen, um korrekt zu funktionieren. Dieses Plug-in ist nicht erforderlich, wenn Sie nicht gleichzeitig eine bestimmte Funktion für mehrere Analytics-Variablen ausführen müssen oder wenn Sie keine abhängigen Plug-ins verwenden.
Installieren des Plug-ins mit der Web SDK- oder Web SDK-Erweiterung
Dieses Plug-in wird noch nicht für die Verwendung im Web SDK unterstützt.
Installieren des Plug-ins mit der Adobe Analytics-Erweiterung
Adobe bietet eine Erweiterung, mit der Sie am häufigsten verwendete Plug-ins mit Adobe Analytics verwenden können.
-
Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
-
Klicken Sie auf die gewünschte Tag-Eigenschaft.
-
Gehen Sie zur Registerkarte Erweiterungen und klicken Sie dann auf die Schaltfläche Katalog.
-
Installieren und Veröffentlichen der Erweiterung Common Analytics Plugins.
-
Wenn Sie dies noch nicht getan haben, erstellen Sie eine Regel mit der Bezeichnung „Plug-ins initialisieren“ mit der folgenden Konfiguration:
- Bedingung: Keine
- Ereignis: Core – Bibliothek geladen (Seitenanfang)
-
Fügen Sie der obenstehenden Regel eine Aktion mit der folgenden Konfiguration hinzu:
- Erweiterung: Common Analytics Plugins
- Aktionstyp: pt initialisieren
-
Speichern und veröffentlichen Sie die Änderungen an der Regel.
Installieren des Plug-ins mit dem benutzerdefinierten Code-Editor
Wenn Sie die Plug-in-Erweiterung "Common Analytics Plugins"nicht verwenden möchten, können Sie den Editor für benutzerdefinierten Code verwenden.
- Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
- Klicken Sie auf die gewünschte Eigenschaft.
- Gehen Sie zur Registerkarte Erweiterungen und klicken Sie dann unter der Erweiterung „Adobe Analytics“ auf die Schaltfläche Konfigurieren.
- Erweitern Sie das Akkordeon Tracking mit benutzerdefiniertem Code konfigurieren, wodurch die Schaltfläche Editor öffnen angezeigt wird.
- Öffnen Sie den Editor für benutzerdefinierten Code und fügen Sie den unten angegebenen Plug-in-Code in das Bearbeitungsfenster ein.
- Speichern und veröffentlichen Sie die Änderungen an der Analytics-Erweiterung.
Installieren des Plug-ins mit AppMeasurement
Kopieren Sie den folgenden Code und fügen Sie ihn an beliebiger Stelle in der AppMeasurement Datei ein, nachdem das Analytics-Tracking-Objekt instanziiert wurde (unter Verwendung von s_gi
). Die Beibehaltung von Kommentaren und Versionsnummern des Codes in Ihrer Implementierung hilft Adobe bei der Fehlerbehebung potenzieller Probleme.
/******************************************* BEGIN CODE TO DEPLOY *******************************************/
/* Adobe Consulting Plugin: pt v3.0 */
function pt(l,de,cf,fa){var b=l,d=de,f=cf,g=fa;if("-v"===b)return{plugin:"pt",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var c;a<window.s_c_il.length;a++)if(c=window.s_c_il[a],c._c&&"s_c"===c._c){a=c;break a}}a=void 0}if("undefined"!==typeof a&&(a.contextData.pt="3.0",b&&a[f])){b=b.split(d||",");d=b.length;for(var e=0;e<d;e++)if(c=a[f](b[e],g))return c}};
/******************************************** END CODE TO DEPLOY ********************************************/
Verwenden des Plug-ins
Die pt
-Methode verwendet die folgenden Argumente:
l
(erforderlich, Zeichenfolge): Eine Liste von Variablen, für die die imcf
-Argument enthaltene Funktion ausgeführt werden kann.de
(optional, Zeichenfolge): Das Trennzeichen, das die Liste der Variablen iml
-Argument trennt. Der Standardwert ist ein Komma (,
).cf
(erforderlich, Zeichenfolge): Der Name der Callback-Funktion im AppMeasurement-Objekt, die für jede der iml
-Argument enthaltenen Variablen aufgerufen werden soll.fa
(optional, Zeichenfolge): Wenn die Funktion imcf
-Argument bei Ausführung zusätzliche Argumente benötigt, schließen Sie sie hier ein. Die Standardeinstellung istundefined
.
Der Aufruf dieser Methode gibt einen Wert zurück, wenn die Callback-Funktion (im cf
-Argument) einen Wert zurückgibt.
Beispielaufrufe
Beispiel 1
Der folgende Code ist Teil des Plug-ins getQueryParam. Es wird die Hilfefunktion getParameterValue für alle Schlüssel-Wert-Paare ausgeführt, die in der Abfragezeichenfolge (fullQueryString) der URL enthalten sind. Um jedes Schlüssel-Wert-Paar zu extrahieren, muss die Zeichenfolge (fullQueryString) durch ein kaufmännisches Und (&) getrennt und geteilt werden. parameterKey bezieht sich auf den Abfragezeichenfolgenparameter, den das Plug-in speziell aus der Abfragezeichenfolge extrahieren möchte.
returnValue = pt(fullQueryString, "&", "getParameterValue", parameterKey)
Die obige Zeile ist eine Verknüpfung zum Ausführen von Code, der wie folgt aussieht:
var returnValue = "",
parameters = fullQueryString.split("&"),
parametersLength = parameters.length;
for(var i = 0; i < parametersLength; i++)
{
returnValue = getParameterValue(parameters[i], parameterKey);
if(returnValue !== "") break;
}
Versionsverlauf
3.0 (19. März 2021)
- Versionsnummer als Kontextdaten hinzugefügt.
2.01 (24. September 2019)
- Geringfügige Codeänderungen zur Reduzierung der Gesamtgröße.
2.0 (17. April 2018)
- Zwischenversion (neu kompiliert, kleinere Code-Größe).
- Unterstützung für H-Code und AppMeasurement hinzugefügt.
1.0 (23. September 2013)
- Erste Version.