Analyser för implementering av Target

Flera steg krävs när Adobe Analytics implementeras som rapportkälla för Adobe Target (A4T). Processen varierar beroende på om du implementerar A4T med Adobe Experience Platform Web SDK eller med at.js.

Implementeringssteg för en Adobe Experience Platform Web SDK-implementering platform

I följande avsnitt beskrivs de steg som krävs för att distribuera integreringen till din webbplats om du tänker använda Platform Web SDK:

Steg 1: Begär etablering för Analytics och Target

Innan du implementerar A4T måste du etableras för Analytics och Target. Använd det här formuläret för att begära att bli etablerad.

Steg 2: Ange användarbehörigheter

Kraven för användarkontot måste uppfyllas innan du kan skapa en aktivitet baserad på Analytics i Target. Se Krav för användarbehörighet.

Steg 3: Skapa en Edge-konfiguration

Skapa en Edge-konfiguration med Adobe Experience Platform med hjälp av edge-konfigurationsverktyget. Konfigurera Skapa och konfigurera datastreams.

Steg 4: Installera och konfigurera Platform Web SDK

Om du vill börja leverera Target-upplevelser och använda Analytics i spårnings- och analyssyfte, installerar och konfigurerar Platform Web SDK på webbplatsens sidor.

Steg 5: Aktivera alternativen för A4T

Klicka på Administration > Visual Experience Composer i användargränssnittet för Target och välj sedan antingen Select per activity eller Adobe Analytics.

Implementeringssteg för en at.js-implementering section_73961BAD5BB4430A95E073DE5C026277

I följande avsnitt beskrivs de steg som krävs för att distribuera den här integreringen till din webbplats om du tänker använda at.js:

Steg 1: Begär etablering för analys och mål

När du har implementerat Analytics som rapportkälla för Target måste du etableras för Analytics och Target. Använd det här formuläret för att begära att bli etablerad.

Steg 2: Ange användarbehörigheter

Kraven för användarkontot måste uppfyllas innan du kan skapa en Analytics-baserad aktivitet i Target. Se Krav för användarbehörighet.

Steg 3: Implementera tjänsten Experience Cloud Visitor ID

Med besökar-ID-tjänsten kan du identifiera användare för alla Adobe Experience Cloud-lösningar. Implementera eller migrera till den version av Experience Cloud Visitor-ID som krävs. Mer information finns i Implementeringskrav i Innan du implementerar.

Se Implementera Experience Cloud ID-tjänsten för mål i dokumentationen för Experience Cloud Visitor ID-tjänsten.

Steg 4: Uppdatera AppMeasurementet för JavaScript eller s_code

Implementera eller migrera till den version av appMeasurement.js som krävs. Mer information finns i Implementeringskrav i Innan du implementerar.

Information om nya implementeringar finns i Översikt över JavaScript-implementering i Implementeringshandboken för analyser.

Information om migrering finns i Migrera till AppMeasurement för JavaScript i Implementeringshandboken för analyser.

Steg 5: Hämta och uppdatera på .js

Implementera eller migrera till den version av at.js som krävs med ditt produktionskonto. Koden behöver inte ändras.

Mer information finns i Implementeringskrav i Innan du implementerar.

Steg 6: Värddator på.js

Om du tidigare distribuerade at at.js kan du ersätta den befintliga filen med den uppdaterade versionen. Mer information finns i Implementeringskrav i Innan du implementerar.

I annat fall kan den här filen lagras tillsammans med Visitor ID-tjänsten och AppMeasurementet för JavaScript-filer. Dessa filer måste finnas på en webbserver som är tillgänglig för alla sidor på platsen. Du behöver sökvägen till de här filerna i nästa steg.

Steg 7: Referera at.js på alla webbplatssidor step7

Inkludera at.js under VisitorAPI.js genom att lägga till följande kodrad i taggen på varje sida:

For at.js:

<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

VisitorAPI.js måste läsas in före at.js. Om du uppdaterar en befintlig at.js-fil måste du kontrollera inläsningsordningen.

Standardinställningen för Target- och Analytics-integrering, från ett implementeringsperspektiv, är att använda SDID som skickas från sidan för att sammanfoga Target - och Analytics -begäran automatiskt.

Du kan styra hur och när analysdata som är relaterade till Target ska skickas till Analytics för rapportering. Om du inte vill använda standardinställningarna för att låta Target och Analytics sammanfoga analysdata automatiskt via SDID, anger du analyticsLogging = client_side via window.targetGlobalSettings. Obs! Versioner under 2.1 stöder inte detta tillvägagångssätt.

Exempel:

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

Den här konfigurationen har en global effekt, vilket innebär att alla anrop från at.js har analyticsLogging: "client_side" som skickas i Target -begäranden och en analysvolym returneras för varje begäran. När det här alternativet är konfigurerat ser nyttolastens format ut så här:

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

Nyttolasten kan sedan vidarebefordras till Analytics via API:t för datainfogning. Om du vill använda Automatisk allokering och Automatiskt mål-aktiviteter måste du även vidarebefordra sessions-ID. Mer information finns i Analytics for Target-rapportering (A4T) i guiden Adobe Target SDK.

Om en global inställning inte önskas och en mer on demand-metod är att föredra, använder du funktionen at.js getOffers() genom att ange analyticsLogging: "client_side". Analysens nyttolast returneras endast för det här anropet och Target-serverdelen vidarebefordrar inte nyttolasten till Analytics. Genom att följa den här metoden returnerar varje at.js Target-begäran nyttolasten som standard, men i stället bara när det önskas och anges.

Exempel:

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Det här anropet anropar ett svar från vilket du kan extrahera analysens nyttolast.

Svaret ser ut så här:

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

Nyttolasten kan sedan vidarebefordras till Analytics via API:t för datainfogning.

Steg 8: Validera implementeringen step8

Läs in sidorna när du har uppdaterat JavaScript-biblioteken för att bekräfta att parametervärdena mboxMCSDID i Target -anropen matchar parametervärdet sdid i sidvisningsanropet Analytics.

Det är särskilt viktigt att du bekräftar att dessa värden matchar i Single Page-program (SPA), där det inte alltid går att förutse hur anropet kommer att ordnas.

Steg 9: (Valfritt) Ta bort föregående integreringskod

Adobe rekommenderar att du tar bort den tidigare integreringen för att förenkla implementeringen och eliminerar behovet av att korrigera skillnader mellan systemen. Du kan ta bort kod som du har distribuerat för en tidigare SC till T&T-integrering, inklusive mboxLoadSCPlugin.

Steg 10: Aktivera alternativen för att använda Analytics som rapportkälla för Target

I Target klickar du på Administration > Reporting och väljer antingen Select per activity eller Adobe Analytics för att aktivera alternativen.