Analyser för Target implementering

Flera steg krävs vid implementering Adobe Analytics 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 vara etablerad för Analytics och Target. Använd det här formuläret för att begära etablering.

Steg 2: Ange användarbehörigheter

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

Steg 3: Skapa en Edge-konfiguration

Skapa en Edge-konfiguration med Adobe Experience Platform med verktyget för kantkonfiguration. Konfigurera Skapa och konfigurera datastreams.

Steg 4: Installera och konfigurera Platform Web SDK

Att börja leverera Target upplevelser och använda Analytics för spårnings- och analysändamål, Installera och konfigurera Platform Web SDK på era webbplatssidor.

Steg 5: Aktivera alternativen för A4T

I Target Gränssnitt, klicka Administration > Visual Experience Composer väljer du 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

Efter implementeringen Analytics som rapportkälla för Targetmåste du vara etablerad för Analytics och Target. Använd det här formuläret för att begära etablering.

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 på användarbehörighet.

Steg 3: Implementera tjänsten Experience Cloud Visitor ID

Med besökar-ID-tjänsten kan du identifiera användare i 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 Target i Experience Cloud Visitor ID-tjänst dokumentation.

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 Implementeringshandbok för analyser.

Om du vill se en migrering går du till Migrera till AppMeasurement för JavaScript i Implementeringshandbok 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 från ett implementeringsperspektiv är att använda SDID som skickas från sidan för att sätta ihop Target och Analytics begär automatiskt tillsammans på baksidan.

Du kan styra hur och när analysdata som rör Target till Analytics för rapportering. Om du inte vill använda standardinställningarna för att Target och Analytics sammanfogar automatiskt analysdata via SDID, set 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" skickas inom Target förfrågningar och en analysnyttolast 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 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 Analyser för målrapportering (A4T) i Adobe Target SDKs guide.

Om en global inställning inte är önskad och en mer on-demand-metod är att föredra, använder du funktionen at.js getOffers() genom att skicka in analyticsLogging: "client_side". Analysens nyttolast returneras endast för det här anropet och Target backend vidarebefordrar inte nyttolasten till Analytics. Genom att följa detta tillvägagångssätt Target begäran returnerar 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 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 mboxMCSDID parametervärden i Target anropen matchar sdid parametervärde i Analytics sidvisningssamtal.

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, klicka Administration > Reporting och välj antingen Select per activity eller Adobe Analytics för att aktivera alternativen.