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.
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:
Innan du implementerar A4T måste du ha etablerat dig för Analytics och Target. Använd det här formuläret för att begära etablering.
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.
Skapa en Edge-konfiguration med Adobe Experience Platform med verktyget för kantkonfiguration. Konfigurera Analytics and Target inställningar för kantkonfiguration.
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.
I Target Gränssnitt, klicka Administration > Visual Experience Composer väljer du antingen Select per activity eller Adobe Analytics.
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:
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.
Kraven för användarkontot måste uppfyllas innan du kan skapa en Analytics-baserad aktivitet i Target. Se Krav på användarbehörighet.
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.
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.
Information om migrering finns på Migrera till AppMeasurement för JavaScript i Implementeringshandbok för analyser.
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.
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.
Annars kan den här filen lagras tillsammans med Visitor ID-tjänsten och AppMeasurement 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.
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.
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.
Matchningen av dessa värden krävs för att A4T ska fungera korrekt.
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
.
I Target, klicka Administration > Reporting och välj antingen Select per activity eller Adobe Analytics för att aktivera alternativen.