Adobe-Plug-in: p_fo (Page First Only (nur einmal pro Seite))

Das p_fo-Plug-in ist ein Dienstprogramm, das prüft, ob ein bestimmtes JavaScript-Objekt vorhanden ist. Wenn das Objekt nicht vorhanden ist, erstellt das Plug-in das Objekt und gibt true zurück. Wenn das JavaScript-Objekt bereits auf der Seite vorhanden ist, gibt es false zurück. Dieses Plug-in ist nützlich, um Code exakt einmal auf einer Seite auszuführen. Mehrere andere Plug-ins sind auf diesen Code angewiesen, um zu funktionieren. Dieses Plug-in ist nicht erforderlich, wenn Sie nicht daran interessiert sind, wie oft Code auf einer Seite ausgeführt wird, oder wenn Sie keine abhängigen Plug-ins verwenden.

Installieren des Plug-ins mit der Web SDK-Erweiterung

Adobe bietet eine Erweiterung, mit der Sie die am häufigsten verwendeten Plug-ins mit dem Web SDK verwenden können.

1. Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
2. Klicken Tags auf der linken Seite und klicken Sie dann auf die gewünschte Tag-Eigenschaft.
3. Klicken Erweiterungen auf der linken Seite und klicken Sie dann auf das Katalog tab
4. Suchen und installieren Sie die Allgemeine Web SDK-Plug-ins -Erweiterung.
5. Klicken Datenelemente Klicken Sie links auf das gewünschte Datenelement.
6. Legen Sie den gewünschten Datenelementnamen mit der folgenden Konfiguration fest:
   • Erweiterung: Allgemeine Web SDK-Plug-ins
   • Datenelement: p_fo
7. Speichern und veröffentlichen Sie die Änderungen am Datenelement.

Installieren Sie das Plug-in manuell, um das Web SDK zu implementieren

Dieses Plug-in wird noch nicht für die Verwendung in einer manuellen Implementierung des Web SDK unterstützt.

Installieren des Plug-ins mit der Adobe Analytics-Erweiterung

Adobe bietet eine Erweiterung, mit der Sie die am häufigsten verwendeten Plug-ins mit Adobe Analytics verwenden können.

1. Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
2. Klicken Sie auf die gewünschte Tag-Eigenschaft.
3. Gehen Sie zur Registerkarte Erweiterungen und klicken Sie dann auf die Schaltfläche Katalog.
4. Installieren und Veröffentlichen der Erweiterung Common Analytics Plugins.
5. 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)
6. Fügen Sie der obenstehenden Regel eine Aktion mit der folgenden Konfiguration hinzu:
   • Erweiterung: Common Analytics Plugins
   • Aktionstyp: p_fo initialisieren
7. 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.

1. Melden Sie sich bei der Adobe Experience Platform-Datenerfassung mit Ihren Adobe ID-Anmeldeinformationen an.
2. Klicken Sie auf die gewünschte Eigenschaft.
3. Gehen Sie zur Registerkarte Erweiterungen und klicken Sie dann unter der Erweiterung „Adobe Analytics“ auf die Schaltfläche Konfigurieren.
4. Erweitern Sie das Akkordeon Tracking mit benutzerdefiniertem Code konfigurieren, wodurch die Schaltfläche Editor öffnen angezeigt wird.
5. Öffnen Sie den Editor für benutzerdefinierten Code und fügen Sie den unten angegebenen Plug-in-Code in das Bearbeitungsfenster ein.
6. 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: p_fo (pageFirstOnly) v3.0 (Requires AppMeasurement) */
function p_fo(c){if("-v"===c)return{plugin:"p_fo",version:"3.0"};a:{if("undefined"!==typeof window.s_c_il){var a=0;for(var b;a<window.s_c_il.length;a++)if(b=window.s_c_il[a],b._c&&"s_c"===b._c){a=b;break a}}a=void 0}"undefined"!==typeof a&&(a.contextData.p_fo="3.0");window.__fo||(window.__fo={});if(window.__fo[c])return!1;window.__fo[c]={};return!0};
/******************************************** END CODE TO DEPLOY ********************************************/

Verwenden des Plug-ins

Die p_fo-Funktion verwendet die folgenden Argumente:

• on (erforderlich, Zeichenfolge): Der Name des JavaScript-Objekts, das vom Plug-in erzeugt wird, wenn das Objekt noch nicht auf der Seite vorhanden ist.

Wenn das Objekt noch nicht vorhanden ist, gibt diese Funktion true zurück und erstellt das Objekt. Wenn das Objekt bereits vorhanden ist, gibt diese Funktion false zurück.

Beispielaufrufe

Beispiel 1

Der folgende Code prüft, ob das Objekt „myobject“ auf der Seite vorhanden ist. Wenn das Objekt „myobject“ nicht vorhanden ist, erzeugt der Code das Objekt „myobject“ und gibt den Wert „true“ zurück. Daher wird der Code innerhalb der bedingten Anweisung (z. B. „Console.log('hello');“) ausgeführt.

Wenn hingegen das Objekt „myobject“ bereits vorhanden ist, wenn p_fo aufgerufen wird, gibt die p_fo-Funktion den Wert „false“ zurück und die bedingte Anweisung wird daher als „false“ betrachtet. In diesem Fall wird der Code innerhalb der bedingten Anweisung nicht ausgeführt.

if(p_fo("myobject"))
{
  console.log("hello");
}

HINWEIS: Jedes Mal, wenn ein neues Seitenobjekt/DOM geladen wird (oder die aktuelle Seite erneut geladen wird), ist das im on-Argument angegebene Objekt nicht mehr vorhanden. Daher gibt das p_fo-Plug-in bei der ersten Ausführung nach Abschluss des Ladevorgangs der Seite erneut den Wert „true“ zurück.

Versionsverlauf

3.0 (19. März 2021)

• Versionsnummer als Kontextdaten hinzugefügt.

2.0

• Zwischenversion (neu kompiliert, kleinere Code-Größe).
• Rückgabewerttyp von Integer (Ganzzahl) auf Boolean (Boolesch) geändert.

1.0

• Erste Version.