Integrera med dynamisk tagghantering för Adobe

Integrera dynamisk tagghantering i Adobe med AEM så att du kan använda dina dynamiska tagghanteringsegenskaper för att spåra AEM webbplatser. Med Dynamic Tag Management kan marknadsförarna hantera taggar för datainsamling och distribuera data över digitala marknadsföringssystem. Använd till exempel Dynamic Tag Management för att samla in användningsdata för din AEM webbplats och distribuera data för analys i Adobe Analytics eller Adobe Target.

Innan du kan integrera måste du skapa den dynamiska tagghanteringen webbegenskapen som spårar domänen för din AEM. Värdalternativen för webbegenskapen måste konfigureras så att du kan konfigurera AEM för åtkomst till bibliotek för dynamisk tagghantering.

När du har konfigurerat integreringen behöver du inte ändra den dynamiska tagghanteringskonfigurationen i AEM om du ändrar distributionsverktygen och reglerna för dynamisk tagghantering. Ändringarna är automatiskt tillgängliga för AEM.

OBSERVERA

Om du använder DTM med en anpassad proxykonfiguration måste du konfigurera både HTTP-klientproxykonfigurationer eftersom vissa funktioner i AEM använder 3.x-API:erna och andra 4.x-API:er:

Distributionsalternativ

Följande distributionsalternativ påverkar konfigurationen av integreringen med dynamisk tagghantering.

Dynamisk tagghantering som värd

AEM har stöd för dynamisk tagghantering som lagras i molnet eller AEM.

  • Molnbaserad: JavaScript-biblioteken för dynamisk tagghantering lagras i molnet, och dina AEM sidor refererar direkt till dem.
  • AEM: Dynamic Tag Management genererar javascript-bibliotek. AEM använder en arbetsflödesmodell för att hämta och installera biblioteken.

Vilken typ av värdtjänst implementeringen använder avgör vilka konfigurations- och implementeringsuppgifter du utför. Mer information om värdalternativ finns i Värd - Bädda in flik i hjälpen för dynamisk tagghantering.

Mellanlagrings- och produktionsbibliotek

Bestäm om AEM författarinstans använder staging- eller produktionskoden för Dynamic Tag Management.

Vanligtvis använder din författarinstans mellanlagringsbiblioteken för dynamisk tagghantering, och produktionsinstansen använder produktionsbiblioteken. Med det här scenariot kan du använda författarinstansen för att testa konfigurationer för dynamisk tagghantering som inte är godkända.

Om du vill kan du använda produktionsbiblioteken i din författarinstans. Webbläsarplugin-program är tillgängliga som gör att du kan växla mellan att använda mellanlagringsbibliotek i testsyfte när biblioteken är molnbaserade.

Använda distributionsguiden för dynamisk tagghantering

När AEM är värd för bibliotek för dynamisk tagghantering kan du använda den dynamiska tagghanteringsfunktionen för att automatiskt skicka biblioteksuppdateringar till AEM. Biblioteksuppdateringar överförs när ändringar görs i biblioteken, till exempel när webbegenskaperna för dynamisk tagghantering redigeras.

Om du vill använda distributionslösningen måste Dynamic Tag Management kunna ansluta till AEM som är värd för biblioteken. Du måste aktivera åtkomst till AEM för servrarna för dynamisk tagghantering.

I vissa fall kan AEM vara oåtkomliga, till exempel när AEM ligger bakom en brandvägg. I dessa fall kan du använda alternativet AEM avsökningsimporteraren för att regelbundet hämta biblioteken. Ett cron-jobbuttryck bestämmer schemat för bibliotekshämtning.

Aktivera åtkomst för distributionsnätverkstjänsten

Aktivera Dynamic Tag Management-distributionens kroktjänst för åtkomst AEM så att tjänsten kan uppdatera AEM bibliotek. Ange IP-adressen till de Dynamic Tag Management-servrar som uppdaterar mellanlagrings- och produktionsbiblioteken efter behov:

  • Mellanlagring: 107.21.99.31
  • Produktion: 23.23.225.112 och 204.236.240.48

Utför konfigurationen med antingen webbkonsolen eller en sling:OsgiConfig-nod:

  • I webbkonsolen använder du Adobe DTM Deploy Hook Configuration-objektet på konfigurationssidan.
  • Tjänstens-PID är com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet för en OSGi-konfiguration.

I följande tabell beskrivs de egenskaper som ska konfigureras.

Egenskapen Web Console OSGi, egenskap Beskrivning
Mellanlagring DTM IP - vit lista dtm.staging.ip.whitelist IP-adressen till den Dynamic Tag Management-server som uppdaterar mellanlagringsbiblioteken.
Vit lista för produktionsDTM IP dtm.production.ip.whitelist IP-adressen till den Dynamic Tag Management-server som uppdaterar produktionsbiblioteken.

Skapar konfigurationen för dynamisk tagghantering

Skapa en molnkonfiguration så att den AEM instansen kan autentisera med dynamisk tagghantering och interagera med din webbegenskap.

OBSERVERA

Undvik att inkludera två Adobe Analytics-spårningskoder på sidorna när din DTM-webbegenskap innehåller Adobe Analytics-verktyget och du också använder Content Insight. I din Adobe Analytics molnkonfiguration väljer du alternativet Inkludera inte spårningskod.

Allmänna inställningar

Egenskap Beskrivning
API-token Värdet på API-tokenegenskapen för ditt användarkonto för dynamisk tagghantering. AEM använder den här egenskapen för att autentisera med dynamisk tagghantering.
Företag Det företag som ditt inloggnings-ID är kopplat till.
Egenskap Namnet på webbegenskapen som du skapade för att hantera taggarna för AEM.
Inkludera produktionskod på författare

Välj det här alternativet om du vill att AEM författare och publiceringsinstanser ska använda produktionsversionen av Dynamic Tag Management-biblioteken.

När det här alternativet inte är markerat används mellanlagringsinställningarna för författarinstansen och produktionsinställningarna gäller för publiceringsinstansen.

Egenskaper för självbetjäning - förproduktion och produktion

Följande egenskaper i konfigurationen för dynamisk tagghantering gör att AEM kan vara värd för biblioteken för dynamisk tagghantering. Med egenskaperna kan AEM hämta och installera biblioteken. Om du vill kan du automatiskt uppdatera biblioteken så att de återspeglar ändringar som gjorts i hanteringsprogrammet för dynamiska taggar.

Vissa egenskaper använder värden som du får från avsnittet Bibliotekshämtning på fliken Bädda in för din dynamiska tagghanteringsegenskap. Mer information finns i Bibliotekshämtning i hjälpen för dynamisk tagghantering.

OBSERVERA

När du är värd för paketet Dynamic Tag Management AEM måste bibliotekshämtning vara aktiverat i Dynamic Tag Management innan du skapar konfigurationen. Akamai måste också vara aktiverat eftersom Akamai innehåller bibliotek för hämtning.

När bibliotek för dynamisk tagghantering finns AEM konfigureras vissa egenskaper för webbegenskapen automatiskt enligt din konfiguration av AEM. Se beskrivningarna i följande tabell.

Egenskap Beskrivning
Använd värdtjänst Välj när du är värd för biblioteksfilen för dynamisk tagghantering AEM. Om du väljer det här alternativet visas de andra egenskaperna i tabellen.
DTM-paket-URL Den URL som ska användas för att hämta biblioteket för dynamisk tagghantering. Hämta det här värdet från avsnittet Hämta URL:er på sidan Bibliotekshämtning i Dynamic Tag Management. Av säkerhetsskäl måste det här värdet konfigureras manuellt.
Hämta arbetsflöde

Arbetsflödesmodellen som ska användas för att hämta och installera biblioteket för dynamisk tagghantering. Standardmodellen är DTM Bundle Download. Använd den här modellen om du inte har skapat en anpassad modell.

Observera att standardarbetsflödet för hämtning automatiskt aktiverar biblioteken när de hämtas.

Domäntips

(Valfritt) Domänen för den AEM servern som är värd för biblioteket för dynamisk tagghantering. Ange ett värde för att åsidosätta standarddomänen som är konfigurerad för tjänsten Day CQ Link Externalizer.

Vid anslutning till dynamisk tagghantering använder AEM det här värdet för att konfigurera mellanlagrings-HTTP-sökvägen eller Production HTTP-sökvägen för bibliotekets hämtningsegenskaper för den dynamiska tagghanteringsegenskapen.

Tips för säker domän

(Valfritt) Domänen för den AEM servern som är värd för biblioteket för dynamisk tagghantering via HTTPS. Ange ett värde för att åsidosätta standarddomänen som är konfigurerad för tjänsten Day CQ Link Externalizer.

Vid anslutning till dynamisk tagghantering använder AEM det här värdet för att konfigurera HTTPS-sökvägen för mellanlagring eller HTTPS-sökvägen för hämtningsegenskaperna för bibliotek för webbegenskapen Dynamic Tag Management.

Delad hemlighet

(Valfritt) Den delade hemlighet som ska användas för dekryptering av nedladdningen. Hämta det här värdet från fältet Delad hemlighet på sidan Bibliotekshämtning i Dynamic Tag Management.

Obs! Du måste ha OpenSSLlibraries installerat på den dator där AEM är installerat, så att AEM kan dekryptera de hämtade biblioteken.

Aktivera avsökningsimporteraren

(Valfritt) Välj att regelbundet hämta och installera biblioteket för dynamisk tagghantering för att vara säker på att du använder en uppdaterad version. När det här alternativet är markerat skickar inte Dynamic Tag Management begäranden om HTTP-POST till Distribuera URL-adress.

AEM konfigurerar automatiskt egenskapen Distribuera URL för hook i bibliotekets nedladdningsegenskaper för webbegenskapen Dynamic Tag Management. När du väljer det här alternativet konfigureras egenskapen utan värde. Om du inte väljer det här alternativet konfigureras egenskapen med URL:en för din konfiguration för dynamisk tagghantering.

Aktivera avsökningsimporteraren när den dynamiska tagghanteringsfunktionen inte kan ansluta till AEM, till exempel när AEM ligger bakom en brandvägg.

Schemauttryck (Visas och krävs när Aktivera avsökningsimporterare är markerat.) Ett cron-uttryck som styr när de dynamiska tagghanteringsbiblioteken hämtas.

chlimage_1-352

Egenskaper för molnvärdtjänster - förproduktion och produktion

Du konfigurerar följande egenskaper för din konfiguration för dynamisk tagghantering när dynamisk tagkonfiguration är molnbaserad.

Egenskap Beskrivning
Använd värdtjänst Avmarkera det här alternativet när biblioteksfilen för dynamisk tagghantering finns i molnet.
Huvudkod

Huvudkoden för mellanlagring som hämtas från Dynamic Tag Management för värden. Det här värdet fylls i automatiskt när du ansluter till dynamisk tagghantering.

Om du vill visa koden i Dynamic Tag Management klickar du på fliken Bädda in och sedan på värdnamnet. Expandera sektionen Huvudkod och klicka på Kopiera inbäddningskod för mellanlagringsinbäddningskod eller området Produktionsinbäddningskod efter behov.

Sidfotskod

Sidfotskoden för mellanlagring som hämtas från Dynamic Tag Management för värden. Det här värdet fylls i automatiskt när du ansluter till dynamisk tagghantering.

Om du vill visa koden i Dynamic Tag Management klickar du på fliken Bädda in och sedan på värdnamnet. Expandera sidfotskoden och klicka på Kopiera inbäddningskod för mellanlagringsinbäddningskod eller området Produktionsinbäddningskod efter behov.

chlimage_1-353

I följande procedur används det pekoptimerade användargränssnittet för att konfigurera integreringen med dynamisk tagghantering.

  1. Klicka på Verktyg > Åtgärder > Moln > Cloud Services på listen.

  2. I området för dynamisk tagghantering visas en av följande länkar för att lägga till en konfiguration:

    • Klicka på Konfigurera nu om det här är den första konfigurationen som du lägger till.
    • Klicka på Visa konfigurationer och klicka sedan på länken + bredvid Tillgängliga konfigurationer om en eller flera konfigurationer har skapats.

    chlimage_1-354

  3. Ange en rubrik för konfigurationen och klicka sedan på Skapa.

  4. I fältet API-token anger du värdet för API-tokenegenskapen för ditt Dynamic Tag Management-användarkonto.

    Kontakta DTM Client Care för att få API-tokenvärdet.

    OBSERVERA

    API-token upphör inte att gälla förrän Dynamic Tag Management-användaren uttryckligen begär det.

    chlimage_1-355

  5. Klicka på Anslut till DTM. AEM autentiserar med Dynamic Tag Management och hämtar listan över företag som ditt konto är kopplat till.

  6. Markera företaget och välj sedan den egenskap som du använder för att spåra din AEM webbplats.

  7. Om du använder mellanlagringskod på författarinstansen avmarkerar du Inkludera produktionskod på författare.

  8. Ange värden för egenskaperna på fliken Mellanlagringsinställningar och på fliken Produktionsinställningar om det behövs. Klicka sedan på OK.

Hämta det dynamiska tagghanteringsbiblioteket manuellt

Hämta bibliotek för dynamisk tagghantering manuellt för att uppdatera dem direkt AEM. Du kan till exempel hämta manuellt när du vill testa ett uppdaterat bibliotek innan avsökningsimporteraren är schemalagd att hämta biblioteket automatiskt.

  1. Klicka på Verktyg > Åtgärder > Moln > Cloud Services på listen.

  2. Klicka på Visa konfigurationer i området Dynamisk tagghantering och klicka sedan på konfigurationen.

  3. Klicka på knappen Trigger Download Workflow (Utlös hämtning av arbetsflöde) i området för mellanlagringsinställningar eller i området för produktionsinställningar för att hämta och distribuera bibliotekspaketet.

    chlimage_1-356

OBSERVERA

De hämtade filerna lagras under /etc/clientlibs/dtm/my config/companyID/propertyID/servertype.

Följande hämtas direkt från din DTM-konfiguration.

  • myconfig
  • companyID
  • propertyID
  • servertype

Associera en dynamisk tagghanteringskonfiguration med din plats

Koppla din konfiguration för dynamisk tagghantering till sidorna på din webbplats så att AEM lägger till det nödvändiga skriptet på sidorna. Associera platsens rotsida med konfigurationen. Alla underordnade till den sidan ärver kopplingen. Om det behövs kan du åsidosätta associationen på en underordnad sida.

Använd följande procedur för att associera en sida och de underordnade med en dynamisk tagghanteringskonfiguration.

  1. Öppna webbplatsens rotsida i det klassiska användargränssnittet.

  2. Använd Sidekick för att öppna sidegenskaperna.

  3. Klicka på Lägg till tjänst på fliken Cloud Services, markera Dynamisk tagghantering och klicka sedan på OK.

    chlimage_1-357

  4. Använd listrutan Dynamisk tagghantering för att välja konfigurationen och klicka sedan på OK.

Använd följande procedur för att åsidosätta den ärvda konfigurationsassociationen för en sida. Åsidosättningen påverkar sidan och alla underordnade sidor.

  1. Öppna sidan i det klassiska användargränssnittet.

  2. Använd Sidekick för att öppna sidegenskaperna.

  3. På fliken Cloud Services klickar du på hänglåsikonen bredvid egenskapen Ärvd från och sedan på Ja i bekräftelsedialogrutan.

    chlimage_1-358

  4. Ta bort eller välj en annan dynamisk tagghanteringskonfiguration och klicka sedan på OK.

På denna sida