Integrera modul
Med Integrate Module kan Adobe partners integrera sina datainsamlingsaktiviteter med din organisation. Den här integreringen ger möjlighet till en dubbelriktad dataanslutning. Användning av Integrate-modulen styrs vanligtvis av en Adobe-partner.
Integrera modularbetsflöde
- En besökare på webbplatsen läser in en sida som initierar en
get
-begäran för partnerdata. - Adobe-partnern tar emot
get
-begäran och paketerar lämpliga variabler i ett JSON-objekt. JSON-objektet returneras. - Din webbplats tar emot JSON-objektet och anropar
setVars
för att tilldela Adobe Analytics-variabler informationen som finns i JSON-objektet - En bildbegäran skickas till datainsamlingsservrar i Adobe.
Integrera modulimplementering
En organisation som arbetar med en Adobe-partner kan använda dessa steg för att börja använda Integrate-modulen.
Hämta integreringsmodulkod
För att få tillgång till modulkod krävs en användare med produktadministratörsåtkomst eller som tillhör en produktprofil med tillgång till Code Manager. Metoden för att hämta modulkod är densamma för alla implementeringsmetoder, inklusive taggar i Adobe Experience Platform.
- Logga in på experiencecloud.adobe.com med inloggningsuppgifterna för ditt Adobe ID.
- Klicka på ikonen med nio kvadrater i det övre högra hörnet och klicka sedan på den färgade Analytics-logotypen.
- Klicka på Admin > All admin > Code manager i den övre navigeringen.
- Ladda ned det senaste JavaScript AppMeasurement Library.
- När du har hämtat filen packar du upp den och letar upp
AppMeasurement_Module_Integrate.js
.
Placera integreringsmodulen i implementeringen
Du måste ha tillgång till Adobe Experience Platform Data Collection för att kunna implementera integreringsmodulen på din webbplats. Om du använder en äldre JavaScript-implementering måste du ha tillgång till din organisations källkod för webbplatsen.
- Logga in på Adobe Experience Platform Data Collection med dina inloggningsuppgifter för AdobeID.
- Klicka på taggegenskapen som du vill redigera.
- Klicka på fliken Tillägg och sedan på Konfigurera under Adobe Analytics.
- Öppna dragspelet Konfigurera spåraren med egen kod och klicka sedan på </> Öppna redigerare.
- Klistra in integrate-modulkoden i det modala kodfönstret. Klicka på Spara när du är klar.
Integrera modulmetoder
När integreringsmodulen har implementerats använder du dessa metoder för att konfigurera den så att den skickar och tar emot data från den önskade Adobe-partnern.
lägg till
Metoden add
instansierar ett partnerobjekt, som fungerar som ett mellanliggande lager med variabeldata när data delas mellan partnersystem och implementeringen. Den här metoden krävs för alla integreringar. Ett separat partnerobjekt måste användas för varje unik partner om flera partner används i en och samma implementering.
s.Integrate.add("<partner_name>");
Din organisation arbetar vanligtvis tillsammans med en Adobe-partner för att fastställa värdet för partnernamnet.
beacon
Metoden beacon
skapar en bildbegäran och pekar den mot den angivna URL:en. Dessa bildbegäranden skiljer sig från vanliga bildbegäranden. Beacon-metoden skickar vanligtvis data till partnern Adobe i stället för till datainsamlingsservrarna i Adobe.
p.beacon("<partner_url>/track?qs1=value1&qs2=value2");
Din organisation arbetar vanligtvis tillsammans med Adobe-partnern för att fastställa värdet för partnernamnet. Frågesträngar som ingår i URL:en är valfria och beroende av partner. Modulen Integrera innehåller automatiskt en frågesträng som innehåller ett slumpmässigt tal för att förhindra webbläsarcachelagring.
fördröjning
Adobe samarbetar internt med team för att få denna metod dokumenterad.
get
Med metoden get
kan en klient importera partnervariabler och lagra dem i partnerobjektet. När data finns i partnerobjektet kan de tilldelas Analytics-variabler och skickas i en bildbegäran. Den här metoden anropar en URL som pekar på ett JSON-objekt som innehåller önskade data.
s.Integrate.<partner_name>.get("<url_to_json_object>?pid=value1&pid2=value2");
- Partnernamn: Din organisation arbetar vanligtvis med Adobe-partnern för att fastställa värdet för partnernamnet.
- URL till JSON-objekt: URL:en till ett JSON-objekt som innehåller de partnervariabler som ska inkluderas i en bildbegäran.
- Fråga efter strängparametrar: Partnerkontoinformation som identifierar din organisation i partnersystemet. Adobe-partnern använder den här informationen för att identifiera din datauppsättning.
Modulen Integrera lägger automatiskt till fler frågesträngar till URL:en. En var-frågesträng anger namnet på det JSON-objekt som modulen förväntar sig från partnern. Ett slumpmässigt tal läggs också till för att förhindra webbläsarcachelagring.
klar
Adobe samarbetar internt med team för att få denna metod dokumenterad.
useVars
Med metoden useVars
kan klienten dela variabelvärden med en Adobe-partner.
s.Integrate.<partner_name>.useVars = function (s,p) {
p.<partner_var1> = s.eVar1;
p.<partner_var2> = s.eVar2;
}
Din organisation arbetar vanligtvis tillsammans med en Adobe-partner för att fastställa värdena för partnernamnet och de variabler som partnern använder.
setVars
Med metoden setVars
kan klienten fylla i Analytics-variabler med partnerdata som hämtats. Partnerdata kan vara resultatet av en get
-metod, en statisk tilldelning eller någon annan mekanism som fyller i partnerobjektet med data.
s.Integrate.<partner_name>.setVars = function (s,p) {
s.eVar1 = p.<partner_var1>;
s.eVar2 = p.<partner_var2>;
}
Din organisation arbetar vanligtvis tillsammans med en Adobe-partner för att fastställa värdena för partnernamnet och de variabler som partnern använder.
script
Med metoden script
kan en Adobe-partner anropa ytterligare JavaScript från partnerwebbplatsen om vissa villkor uppfylls (till exempel om kampanjvariabeln är inställd).
p.script("<partner_url>/script?qs1=value1&qs2=value2");
Din organisation arbetar vanligtvis tillsammans med Adobe-partnern för att fastställa värdet för partnernamnet. Frågesträngar som ingår i URL:en är valfria och beroende av partner. Modulen Integrera innehåller automatiskt en frågesträng som innehåller ett slumpmässigt tal för att förhindra webbläsarcachelagring.