DokumentationAEM 6.4Användarhandbok om administration

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Admin
CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds hä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 den här uppgiften (Konfigurera Analytics och Target) finns på Inkorg. 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.

  • Avanmäl dig från integreringen.

    Välj 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 vilka sidor som ska 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 hjälp av en egenskapsfil.

När du väljer att integrera 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 din konfiguration 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. Från Inkorg, markera och Öppna Konfigurera analys och anpassning uppgift.

    optin-01

  2. För analys:

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

  3. För mål:

    1. Ange användarkontoinformationen för Target och klicka sedan på motsvarande Lägg till -knappen.
    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 integreringen opting-out-of-the-integration

Avanmäl dig från 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 till 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å analysrapportsviten som ska användas.
  • target.clientcode: Klientkoden som är associerad med ditt Target-konto.
  • target.email: E-postadressen 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 analyticsoch 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 exempel .properties -filen 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 marketingcloud.properties i arbetskatalogen som används av AEM (författarinstans).

    note note
    NOTE
    Arbetskatalogen är vanligtvis den katalog som innehåller behållaren eller license.properties -fil.
    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 anpassning enligt beskrivningen i Konfigurera integreringen. I stället för att begära din kontoinformation använder guiden värdena från .properties -fil.

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

    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. Molnkonfigurationen för Analytics kallas till exempel för Provisioned Analytics-konto.

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 i fråga om 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 välja att inaktivera korrekt målanpassning globalt genom att avmarkera kryssrutan bredvid Korrekt målanpassning 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 har redan har skapat riktade komponenter och du ändrar den här inställningen påverkar inte ändringarna dessa komponenter. Du måste göra ändringar i den komponenten direkt.
CAUTION
När du väljer att delta i Analytics-konfigurationen och ett specifikt reportsuite väljs, begränsas ramverket till publiceringskörningsläget. Det innebär att spårning bara fungerar på publiceringsinstansen.
Om det behövs även spårning för en redigeringsförekomst ska 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:

  • Skicka 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 marketingcloud.properties filen ifylld med alla nödvändiga inloggningsuppgifter, 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 marketingcloud.properties måste du skicka inloggningsuppgifterna och parametrarna; till exempel:

    • automaticProvisioning= true
    • servicename= analytics|target
    • path=path to an AEM page to attach the created cloud services configs; flera banor kan definieras
    • 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
5ce3024a-cbea-458b-8b2f-f9b8dda516e8