Adobe-insteekmodule: p_fo (alleen Pagina eerst)
De insteekmodule p_fo
is een hulpprogramma dat controleert of een specifiek JavaScript-object bestaat. Als het object niet bestaat, maakt de plug-in het object en wordt true
geretourneerd. Als het JavaScript-object al op de pagina aanwezig is, wordt false
geretourneerd. Deze insteekmodule is handig als u code precies één keer op een pagina wilt uitvoeren. Verscheidene andere stop-ins baseren zich op deze code om te werken. Deze plug-in is niet nodig als u zich geen zorgen maakt over het aantal keren dat code op een pagina wordt uitgevoerd of als u geen afhankelijke plug-ins gebruikt.
De insteekmodule installeren met de extensie Web SDK
Adobe biedt een extensie waarmee u veelgebruikte plug-ins kunt gebruiken voor de webversie van SDK.
-
Login aan de Inzameling van Gegevens van Adobe Experience Platformgebruikend uw geloofsbrieven van AdobeID.
-
Klik op Tags aan de linkerkant en klik op de gewenste eigenschap Tag.
-
Klik op Extensions aan de linkerkant en klik vervolgens op de tab Catalog
-
Zoek en installeer de extensie Common Web SDK Plugins .
-
Klik op Data Elements aan de linkerkant en klik op het gewenste gegevenselement.
-
Stel de gewenste naam van het gegevenselement in met de volgende configuratie:
- Extensie: algemene SDK-plug-ins voor het web
- Gegevenselement:
p_fo
-
Sla de wijzigingen in het gegevenselement op en publiceer deze.
De insteekmodule handmatig installeren voor de Web SDK
Deze insteekmodule wordt nog niet ondersteund voor gebruik in een handmatige implementatie van de Web SDK.
De insteekmodule installeren met de Adobe Analytics-extensie
Adobe biedt een extensie waarmee u veelgebruikte plug-ins kunt gebruiken in Adobe Analytics.
-
Login aan de Inzameling van Gegevens van Adobe Experience Platformgebruikend uw geloofsbrieven van AdobeID.
-
Klik op de gewenste tageigenschap.
-
Ga naar de tab Extensions en klik vervolgens op de knop Catalog
-
De extensie Common Analytics Plugins installeren en publiceren
-
Als u niet reeds hebt, creeer een regel geëtiketteerd "Initialize stop-ins"met de volgende configuratie:
- Voorwaarde: geen
- Event: Core - bibliotheek geladen (pagina boven)
-
Voeg een actie aan de bovengenoemde regel met de volgende configuratie toe:
- Extensie: veelgebruikte plug-ins voor Analytics
- Type handeling: p_fo initialiseren
-
Sla de wijzigingen in de regel op en publiceer deze.
Plug-in installeren met aangepaste code-editor
Als u niet de Gemeenschappelijke Insteekmodule van Analytics wilt gebruiken, kunt u de redacteur van de douanecode gebruiken.
- Login aan de Inzameling van Gegevens van Adobe Experience Platformgebruikend uw geloofsbrieven van AdobeID.
- Klik op de gewenste eigenschap.
- Ga naar de tab Extensions en klik vervolgens op de knop Configure onder de extensie Adobe Analytics.
- Vouw de accordeon Configure tracking using custom code uit, zodat de knop Open Editor zichtbaar wordt.
- Open de aangepaste code-editor en plak de onderstaande plug-incode in het bewerkingsvenster.
- Sla de wijzigingen in de extensie Analytics op en publiceer deze.
Plug-in installeren met AppMeasurement
Kopieer en plak de volgende code ergens in het AppMeasurement-bestand nadat het object Analytics tracking is geïnstantieerd (met s_gi
). Door opmerkingen en versienummers van de code in uw implementatie te behouden, helpt Adobe bij het oplossen van mogelijke problemen.
/******************************************* 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 ********************************************/
De plug-in gebruiken
De functie p_fo
gebruikt de volgende argumenten:
- op (vereist, koord): De naam van het voorwerp van JavaScript dat stop-binnen leidt tot als het voorwerp nog niet op de pagina bestaat.
Als het object nog niet bestaat, retourneert deze functie true
en wordt het object gemaakt. Als het object al bestaat, retourneert deze functie false
.
Voorbeelden van aanroepen
Voorbeeld 1
De volgende code controleert of het object "myobject" op de pagina aanwezig is. Als het object "myobject" niet bestaat, maakt de code het object "myobject" en retourneert deze de waarde true. Het resultaat is dat de code binnen de voorwaardelijke instructie (Console.log('hello');) wordt uitgevoerd.
Als het object "myobject" echter al bestaat wanneer de p_fo-aanroep plaatsvindt, retourneert de p_fo-functie de waarde false en wordt de voorwaardelijke instructie dus als false beschouwd. In dit geval wordt de code binnen de voorwaardelijke instructie niet uitgevoerd.
if(p_fo("myobject"))
{
console.log("hello");
}
NOTA: telkens als een nieuw paginavoorwerp/DOM laadt (of de huidige pagina herlaadt), zal het voorwerp dat in het op argument wordt gespecificeerd niet meer bestaan en zo zal p_fo stop-binnen opnieuw waar de eerste keer terugkeren het loopt nadat de pagina het laden beëindigt.
Versiehistorie
3.0 (19 maart 2021)
- Versienummer toegevoegd als contextgegevens.
2,0
- Puntrelease (opnieuw gecompileerd, kleiner codeformaat).
- Veranderd type geretourneerde waarde van geheel getal in Boolean
1,0
- Eerste release.