Tillägget Adobe Client Data Layer

Den här dokumentationen innehåller exempel och metodtips om hur du använder tillägget Adobe Client Data Layer.

Installation

Om du vill installera tillägget går du till tilläggskatalogen i användargränssnittet för Experience Platform eller datainsamlingen och väljer Adobe Client Data Layer.

ACDL-tilläggsvy i katalog

Tilläggsvy

ACDL-skriptet skapar som standard ett nytt datalager med variabelnamnet adobeDataLayer. I tilläggsvyn kan du ändra det här namnet om du vill. Namnet som du har angett instansieras när taggar läses in.

NOTE
När du ändrar objektnamnet skapas fortfarande det ursprungliga adobeDataLayer-objektet och dupliceras sedan till det nya variabelnamnet som du har valt.

Händelser

Tillägget ger dig möjlighet att lyssna på händelser i datalagret. Följande händelser är tillgängliga:

Lyssna på alla dataändringar

Om du väljer det här alternativet avlyssnar händelseavlyssnaren alla ändringar som görs i datalagret.

IMPORTANT
När du trycker på händelser ändras inte själva datalagret.

Följande exempel på push-händelser spåras av avlyssnaren:

  • adobeDataLayer.push({"data":"something"})
  • adobeDataLayer.push({"event":"myevent","data":"something"})

Följande exempel på push-händelse spåras inte av avlyssnaren:

  • adobeDataLayer.push({"event":"myevent"})

Lyssna på alla händelser

Om du väljer det här alternativet avlyssnar händelseavlyssnaren alla händelser som skickas till datalagret.

Följande exempel på push-händelser spåras av avlyssnaren:

  • adobeDataLayer.push({"event":"myevent"})
  • adobeDataLayer.push({"event":"myevent","data":"something"})

Följande exempel på push-händelse spåras inte av avlyssnaren:

  • adobeDataLayer.push({"data":"something"})

Lyssna efter en specifik händelse

Om du anger en händelse spårar händelseavlyssnaren alla händelser som matchar en viss sträng.

Om du till exempel anger myEvent när du använder den här konfigurationen spåras endast följande push-händelse:

  • adobeDataLayer.push({"event":"myEvent"})

Du kan också ändra omfattningen för din händelseavlyssnare. De olika alternativen sammanfattas nedan:

  • all: Det här är standardalternativet och utlöser regeln varje gång som det villkor du har valt ovan har uppfyllts tidigare, eller kommer att skickas i framtiden. Det här är det säkraste alternativet om du använder en asynkron implementering.
  • future: Det här alternativet utlöser endast regeln när nya push-händelser som matchar ditt villkor skickas till datalagret.
  • past: Det här alternativet utlöser endast regeln för gamla push-händelser som matchar ditt villkor. Nya penslar som matchar ditt villkor ignoreras och utlöser inte regeln längre.

Instruktioner

I följande avsnitt beskrivs de åtgärder som stöds av tillägget.

Återställ datalager

Tillägget ger dig ett sätt att återställa datalagrets längd, vilket kan hjälpa dig att behålla en begränsad storlek för ett enkelsidigt program (SPA).

Det finns dock för närvarande ingen möjlighet att helt ta bort information som tidigare ställts in under push-metoderna.

Åtgärden Återställ och ange beräknat läge kopierar det senaste beräknade läget, tömmer datalagrets objekt och återställer det senaste läget.

Överför till datalager

Tillägget ger dig en åtgärd för att överföra JSON-innehåll till själva datalagret. Den här åtgärden gör det möjligt att använda dataelement direkt i JSON. I JSON-redigeraren ska dataelement refereras med procentnotation (till exempel %dataElementName%).

{
    "page": {
        "url": "%url%",
        "previous_url": "%previous_url%",
        "concatenated_values": "static string %dataElement%"
    }
}

Dataelement

Avsnitten nedan beskriver de unika dataelementtyperna som tillägget tillhandahåller.

Beräknat läge

Datalagrets dataelement för beräknat läge kan returnera en av två saker, beroende på hur du konfigurerar det:

  • Det fullständiga datalagrets tillstånd: Som standard returneras det fullständiga datalagrets beräknade läge.
  • En specifik sökväg: Du kan ange sökvägen som du vill returnera i datalagret. Banor anges med punktnotation (till exempel data.foo).

Datalagerstorlek

Detta dataelement returnerar datalagrets storlek. Datalagrets storlek representeras av antalet element som har skickats till det här objektet.

Med följande lista över push-händelser returnerar det här dataelementet heltalet 2:

adobeDataLayer.push({"event":"myEvent"})
adobeDataLayer.push({"data":{"foo":"bar"}})
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743