DokumentationAEM 6.5Användarhandbok

Ingå i Adobe Analytics och Adobe Target opting-into-adobe-analytics-and-adobe-target

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Administratör

AEM har en anmälningsprocedur som hjälper dig att integrera med Adobe Analytics och Adobe Target. Detta är tillgängligt när du vill, som en förinläst uppgift som tilldelats administratörsanvändargruppen.

När du loggar in som administratör är den här aktiviteten (Konfigurera analys och målanpassning) tillgänglig i Inkorgen. Baserat på de autentiseringsuppgifter du anger hjälper det dig att konfigurera och integrera dessa tjänster.

Du har följande alternativ för att konfigurera integreringen:

  • Konfigurera integreringen via uppgiften.

    Detta kan göras antingen direkt eller senare, och aktiviteten finns kvar i Inkorgen tills någon åtgärd har utförts. I båda fallen kan konfigurationen göras direkt i användargränssnittet eller med en fördefinierad .properties-fil.

  • Välj bort från integreringen.

    Överväg det här alternativet om du föredrar att konfigurera integreringen manuellt. Se även Integrera AEM med Adobe Target och Adobe Analytics med DTM.

  • Konfigurera konfiguration och etablering med hjälp av ett skript.

Konfigurera integreringen configuring-the-integration

Anmäl dig till integrationen med:

  • Analyser som gör det möjligt att använda deras funktioner för sidspårning och sidanalys.
  • Rikta in er för att utnyttja deras personaliseringsfunktioner.

För båda alternativen måste du ange användarkontoinformationen och ange sidorna som spåras.

NOTE
Du kan också ange Analytics- och Target-kontoinformation med hjälp av en egenskapsfil som läses när servern startas. Se Ange kontoinformation med en egenskapsfil.

När du väljer att delta i integreringen utför AEM följande uppgifter:

  • Skapar molnkonfigurationer som aktiverar anslutningen till Analytics och Target.
  • Skapar ramverk som bestämmer vilka data som spåras.
  • Konfigurerar webbsidorna så att de använder dessa tjänster.
NOTE
AT.js är standardklientbiblioteket. Detta konfigureras under målkonfigurationen för molntjänster.
Adobe rekommenderar att du använder AT.js som klientbibliotek.

Så här avanmäler du dig från den förinlästa uppgiften:

  1. I din inkorg väljer du och öppnar aktiviteten Konfigurera analys och anpassning.

    optin-01

  2. För analys:

    1. Ange användarkontoinformationen för Analytics och klicka sedan på motsvarande Lägg till-knapp.
    2. Autentiseringsuppgifterna är autentiserade.
    3. När Analytics-kontot autentiseras väljer du den Analytics-rapportsserie som ska användas. AEM hämtar de här Analytics-rapportsviterna. Statusen uppdateras till Tillagd.

  3. För mål:

    1. Ange användarkontoinformationen för Target och klicka sedan på motsvarande Lägg till-knapp.
    2. Autentiseringsuppgifterna är autentiserade. Statusen uppdateras till Tillagd.

  4. Välj Nästa.

  5. Välj de webbplatser som Analytics och/eller Target ska användas för.

  6. Välj Klar för att slutföra.

    note caution
    CAUTION
    När du har valt att konfigurera måste du publicera den eller de berörda platserna för att replikera dessa ändringar till publiceringsinstansen.

Avanmäl dig från integrationen opting-out-of-the-integration

Välj bort integreringen med Analytics och Target när du antingen:

Om du vill avanmäla dig måste du slutföra den förinlästa uppgiften:

Ange kontoinformation med hjälp av en egenskapsfil providing-account-information-using-a-properties-file

Installera en egenskapsfil som AEM läser när servern startas för att konfigurera kontoegenskaperna för integreringen med Analytics och Target. När du använder egenskapsfilen använder anmälningsguiden automatiskt egenskaperna från filen och molnkonfigurationen skapas därefter.

Egenskapsfilen är en textfil med namnet marketingcloud.properties som du sparar i arbetskatalogen som används i AEM (vanligtvis samma katalog som JAR-filen). Filen innehåller följande egenskaper:

  • analytics.server: URL:en för det Analytics-datacenter som du använder.
  • analytics.company: Det företag som är associerat med ditt Analytics-användarkonto.
  • analytics.username: Ditt användarnamn för Analytics.
  • analytics.secrets: Den hemlighet som är kopplad till ditt användarnamn i Analytics.
  • analytics.reportSuite: Namnet på den Analytics-rapportsvit som ska användas.
  • target.clientcode: Den klientkod som är associerad med ditt Target-konto.
  • target.email: Den e-postadress som du använder för att autentisera ditt Target-konto.
  • target.password: Lösenordet som är kopplat till din e-postadress.

Egenskaper och värden avgränsas med likhetstecken (=). Analysegenskaperna har prefixet analytics och Target-egenskaperna har prefixet target. Om du vill konfigurera en tjänst anger du värden för alla egenskaper för den tjänsten. Om du inte vill konfigurera en tjänst anger du inga värden för den tjänsten.

Följande exempelfil .properties innehåller egenskapsvärden för att skapa en molnkonfiguration för Analytics:

analytics.server=https://test.omniture.com/login/
analytics.company=MyCompany
analytics.username=sbroders
analytics.secret=12345678
analytics.reportsuite=myreportsuite
target.clientcode=
target.email=
target.password=

I proceduren nedan beskrivs hur du väljer att gå med i integreringen med hjälp av egenskapsfilen.

  1. Skapa filen marketingcloud.properties i arbetskatalogen som AEM använder (författarinstans).

    note note
    NOTE
    Arbetskatalogen är vanligtvis den katalog som innehåller filen jar eller license.properties.
    Men den kan också definieras som en absolut sökväg av egenskapen system:
    mac.provisioning.file.container

  2. Lägg till egenskapsvärden enligt dina Analytics- och/eller Target-konton.

  3. Starta eller starta om servern och logga sedan in med ett administratörskonto.

  4. Öppna aktiviteten Konfigurera analys och målanpassning så som beskrivs i Konfigurera integreringen. I stället för att begära din kontoinformation använder guiden värdena från filen .properties.

    Välj Lägg till för rätt tjänst och fortsätt sedan med guiden.

    optin-02

Om molnkonfigurationer about-the-cloud-configurations

När du konfigurerar integreringen med Analytics och Target skapar AEM automatiskt de molnkonfigurationer och ramverk som krävs. Till exempel kallas molnkonfigurationen för Analytics för provisionerad analys.

Du behöver inte ändra molnkonfigurationerna. Du kan dock konfigurera ramverken efter behov. (Se Mappa komponentdata med Adobe Analytics-egenskaper och Lägg till ett målramverk.)

NOTE
Som standard aktiveras korrekt målgruppsanpassning när du väljer att använda konfigurationsguiden för Adobe Target.
Korrekt målinriktning innebär att molntjänstkonfigurationen väntar på att kontexten ska läsas in innan innehållet läses in. Därför kan en korrekt målinriktning, vad gäller prestanda, skapa en fördröjning på några millisekunder innan innehållet läses in.
Korrekt målinriktning är alltid aktiverat på författarinstansen. På publiceringsinstansen kan du dock avaktivera korrekt målinriktning globalt genom att avmarkera kryssrutan intill Accurate Targeting i molntjänstkonfigurationen (http://localhost:4502/etc/cloudservices.html). Du kan även aktivera och inaktivera exakt målinriktning för enskilda komponenter, oavsett vilken inställning du har i molntjänstkonfigurationen.
Om du redan har skapat målkomponenter och du ändrar den här inställningen påverkar ändringarna inte dessa komponenter. Gör ändringar direkt i dessa komponenter.
CAUTION
När du väljer att använda Analytics-konfigurationen och en specifik reportsuite har valts begränsas ramverket till publiceringskörningsläget. Det innebär att spårning bara fungerar på publiceringsinstansen.
Om spårning krävs för en redigeringsinstans bör även värdet ändras till all.

Konfigurera inställningar och etablering via skript configuring-the-setup-and-provisioning-via-script

Som administratör kanske du vill aktivera konfiguration och etablering med ett skript i stället för att stega igenom guiden manuellt. Du kan göra det genom att:

  • Skickar en begäran om POST till /libs/cq/cloudservicesprovisioning/content/autoprovisioning.json med de parametrar som krävs.

Vilka parametrar du skickar beror på följande:

  • Om du vill använda filen marketingcloud.properties som fyllts i med alla nödvändiga autentiseringsuppgifter måste du skicka följande parametrar:

    • automaticProvisioning= true
    • servicename= analytics|target
    • path=sökväg till en AEM sida för att koppla de molntjänster som skapats

    En curl-begäran som skapar både Analytics- och Target-konfigurationer och bifogar dem till sidan we.retail skulle till exempel vara:

    code language-shell 
    curl -v -u admin:admin -X POST -d"automaticProvisioning=true&servicename=target&servicename=analytics&path=/content/we-retail" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json

  • Om du inte vill använda filen marketingcloud.properties måste du skicka autentiseringsuppgifter och parametrar. Till exempel:

    • automaticProvisioning= true
    • servicename= analytics|target
    • path=path to an AEM page to attach the created cloud services configs; multiple paths can can defined
    • analytics.server= https://servername
    • analytics.company= Name of company
    • analytics.username= me
    • analytics.secrets= secret
    • analytics.reportSuite= we-retail
    • target.clientcode= mycompany
    • target.email= me@adobe.com
    • target.password= password

    I det här fallet skulle den begäran som skapar både Analytics- och Target-konfigurationer och bifogar dem till webbsidan vara:

    code language-shell 
    curl -v -u admin:admin -X POST -d"automaticProvisioning=false&servicename=target&servicename=analytics&path=/content/we-retail&analytics.server=https://servername/&analytics.company=Name of company&analytics.username=me&analytics.secret=secret&analytics.reportsuite=weretail&target.clientcode=mycompany&target.email=me@adobe.com&target.password=password" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2