Koppla Commerce-data till Adobe Experience Platform

När du installerar Data Connection tillägg visas två nya konfigurationssidor i System meny under Tjänster i COMMERCE Administratör.

  • Commerce Services Connector
  • Data Connection

Om du vill ansluta din Adobe Commerce-instans till Adobe Experience Platform måste du konfigurera båda anslutningarna, med början med Commerce Services-anslutaren och sedan med Data Connection tillägg.

Konfigurera Commerce Services Connector

Om du tidigare har installerat en Adobe Commerce-tjänst har du förmodligen redan konfigurerat Commerce Services-anslutningen. Annars måste du utföra följande uppgifter på Commerce Services Connector sida:

  1. Logga in på ditt Commerce-konto för att hämta produktions- och sandbox-API-nycklar.
  2. Välj en SaaS-datautrymme.
  3. Logga in på ditt Adobe-konto för att hämta ditt organisations-ID.

När du har konfigurerat Commerce Services Connector konfigurerar du Data Connection tillägg.

Konfigurera Data Connection extension

I det här avsnittet får du lära dig hur du konfigurerar Data Connection tillägg.

Lägg till tjänstkonto och autentiseringsuppgifter

Om du tänker samla in och skicka historiska orderdata eller kundprofildatamåste du lägga till information om tjänstkonto och autentiseringsuppgifter. Om du konfigurerar Audience Activation måste du slutföra de här stegen.

Om du bara samlar in och skickar data från butiker eller bakgrunder kan du hoppa till allmän -avsnitt.

Steg 1: Skapa ett projekt i Adobe Developer Console

Skapa ett projekt i Adobe Developer Console som autentiserar Commerce så att Experience Platform API-anrop kan göras.

Skapa projektet genom att följa stegen som beskrivs i Autentisera och få åtkomst till Experience Platform API:er självstudie.

Se till att ditt projekt har följande när du går igenom självstudiekursen:

  • Åtkomst till följande produktprofiler: Standardproduktion, all åtkomst och AEP Standardvärde för all åtkomst.
  • Rätt roller och behörigheter har konfigurerats.
  • Om du valde att använda JSON Web Tokens (JWT) som autentiseringsmetod för server-till-server måste du också överföra en privat nyckel.

Resultatet av det här steget skapar en konfigurationsfil som du använder i nästa steg.

Steg 2: Hämta konfigurationsfilen

Ladda ned konfigurationsfil för arbetsytan. Kopiera och klistra in innehållet i filen i Information om tjänstkonto/autentiseringsuppgifter sidan för Commerce Admin.

  1. I Commerce Admin går du till Lager > Inställningar > Konfiguration > Tjänster > Data Connection.

  2. Välj auktoriseringsmetoden server-till-server som du implementerade från Adobe Developer Authorization Type -menyn. Adobe rekommenderar att du använder OAuth. JWT har tagits bort. Läs mer.

  3. (Endast JWT) Kopiera och klistra in innehållet i private.key till Klienthemlighet fält. Använd följande kommando för att kopiera innehållet.

    code language-bash
    cat config/private.key | pbcopy
    

    Se JWT-autentisering (Service Account) för mer information om private.key -fil.

  4. Kopiera innehållet i <workspace-name>.json till Information om tjänstkonto/autentiseringsuppgifter fält.

    Data Connection Administratörskonfiguration {width="700" modal="regular"}

  5. Klicka Spara konfiguration.

Allmänt

  1. Gå till Admin System > Tjänster > Data Connection.

  2. Inställningar flik under Allmänt verifierar du det ID som är kopplat till ditt Adobe Experience Platform-konto enligt konfigurationen i Commerce Services Connector. Organisations-ID:t är globalt. Endast ett organisations-ID kan associeras per Adobe Commerce-instans.

  3. I Omfång nedrullningsbar meny, ange kontexten som Webbplats.

  4. (Valfritt) Om du redan har en AEP Web SDK (legering) aktivera kryssrutan och lägg till namnet på din AEP Web SDK. Annars lämnar du dessa fält tomma och Data Connection tillägget distribuerar ett åt dig.

    note note
    NOTE
    Om du anger en egen AEP Web SDK, Data Connection I tillägget används det datastream-ID som är kopplat till SDK och inte det datastream-ID som är angivet på den här sidan (om det finns något).

Datainsamling

I det här avsnittet anger du vilken typ av data du vill samla in och skicka till Experience Platform. Det finns tre typer av data:

  • Beteende (data på klientsidan) är data som hämtas på butiken. Detta inkluderar interaktioner med kunderna, som View Page, View ProductAdd to Cartoch rekvisitionslista information (för B2B-handlare).

  • Back office (data på serversidan) är data som samlas in på Commerce-servrarna. Här finns information om status för en order, t.ex. om en order har placerats, annullerats, återbetalats, skickats eller slutförts. Den innehåller även historiska orderdata.

  • Profil (beta) är data relaterade till kundens profilinformation. Läs mer.

För att vara säker på att din Adobe Commerce-instans kan börja datainsamlingen går du igenom krav.

Läs mer om eventämnen storefront, back officeoch profil händelser.

NOTE
Alla fält i Datainsamling gäller för Webbplats omfång eller högre.
  1. Välj Storefront-händelser om du vill skicka beteendedata för butiken.

  2. Välj Back office-händelser om du vill skicka information om orderstatus, t.ex. om en order har placerats, annullerats, återbetalats eller skickats.

    note note
    NOTE
    Om du väljer Back office-händelser, skickas all backoffice-information till Experience Platform. Om en kund väljer att avanmäla sig från datainsamlingen måste ni uttryckligen ange kundens personuppgiftsinställning i Experience Platform. Detta skiljer sig från butikshändelser där insamlaren redan hanterar samtycke baserat på kundernas önskemål. Läs mer om att ställa en köpares integritetspolicy i Experience Platform.
  3. (Hoppa över det här steget om du använder din egen AEP Web SDK.) Skapa ett datastream i Adobe Experience Platform eller välj ett befintligt datastream som du vill använda för samlingen. Ange detta datastream-ID i Dataström-ID fält.

  4. Ange Datauppsättnings-ID som du vill lagra dina Commerce-data i. Så här hittar du datauppsättnings-ID:

    1. Öppna användargränssnittet för Experience Platform och markera Datauppsättningar i den vänstra navigeringen för att öppna Datauppsättningar kontrollpanel. Kontrollpanelen visar alla tillgängliga datauppsättningar för din organisation. Information visas för varje datamängd som anges, inklusive namn, schema som datauppsättningen följer och status för den senaste importen.
    2. Öppna den datauppsättning som är associerad med din datastream.
    3. Visa information om datauppsättningen i den högra rutan. Kopiera datauppsättnings-ID:t.
  5. För att säkerställa att data för back office-händelser uppdateras baserat på ett schema enligt en cron måste du ändra Sales Orders Feed indexera till Update by Schedule.

    1. Administratör sidebar, gå till System > Tools>Index Management.

    2. Markera kryssrutan för Sales Orders Feed indexerare.

    3. Ange Actions till Update by Schedule.

    4. Om du aktiverar backoffice-data för första gången kör du följande kommandon för att indexera om och utlösa en omsynkronisering. Efterföljande omsynkronisering sker automatiskt så länge cron jobbet är korrekt konfigurerat.

      code language-bash
      bin/magento index:reindex sales_order_data_exporter_v2
      
      code language-bash
      bin/magento saas:resync --feed orders
      

Fältbeskrivningar

Fält
Beskrivning
Omfång
Den specifika webbplats där du vill att konfigurationsinställningarna ska gälla.
Organisations-ID (globalt)
ID som tillhör organisationen som köpte Adobe DX-produkten. Detta ID länkar din Adobe Commerce-instans till Adobe Experience Platform.
Är AEP Web SDK redan distribuerad till din webbplats?
Markera den här kryssrutan om du har distribuerat din egen AEP Web SDK till din webbplats
AEP Web SDK-namn (globalt)
Om du redan har en Experience Platform Web SDK distribuerad till din plats anger du namnet på SDK i det här fältet. Detta gör att händelsesamlingen Storefront och Storefront Event SDK kan använda din Experience Platform Web SDK i stället för den version som distribueras av Data Connection tillägg. Om du inte har ett Experience Platform Web SDK distribuerat till din webbplats lämnar du det här fältet tomt och Data Connection tillägget distribuerar ett åt dig.
Storefront-händelser
Är markerat som standard så länge organisations-ID och datastream-ID är giltiga. I butikshändelser samlas anonyma beteendedata in från era kunder när de surfar på er webbplats.
Back office-händelser
Om det här alternativet är markerat innehåller händelsenyttolasten anonymiserad orderstatusinformation, t.ex. om en order har placerats, annullerats, återbetalats eller levererats.
Dataström-ID (webbplats)
ID som gör att data kan flöda från Adobe Experience Platform till andra Adobe DX-produkter. Detta ID måste kopplas till en specifik webbplats i din specifika Adobe Commerce-instans. Om du anger ett eget Experience Platform Web SDK ska du inte ange något datastream-ID i det här fältet. The Data Connection I tillägget används det datastream-ID som är associerat med SDK och eventuella datastream-ID som anges i det här fältet ignoreras.
Datauppsättnings-ID (webbplats)
ID för den datauppsättning som innehåller dina Commerce-data. Det här fältet är obligatoriskt såvida du inte har avmarkerat Storefront-händelser eller Back office-händelser kryssrutor. Om du använder ditt eget Experience Platform Web SDK och därför inte angav något datastream-ID, måste du ändå lägga till det datauppsättnings-ID som är kopplat till ditt datastream. Annars kan du inte spara det här formuläret.

Efter introduktionen börjar butiksdata flöda till Experience Platform. Det tar cirka fem minuter att få information från det bakre kontoret. Efterföljande uppdateringar visas i kanten baserat på kronschemat.

Skicka kundprofildata

IMPORTANT
Den här funktionen är i betaversion.

Det finns två typer av profildata som du kan skicka till Experience Platform: profilposter och händelser för tidsserieprofiler.

En profilpost innehåller data som sparas när en kund skapar en profil i din Commerce-instans, till exempel kundens namn. När ditt schema och din datauppsättning korrekt konfigurerad, skickas en profilpost till Experience Platform och vidarebefordras till Adobe profilhanterings- och segmenteringstjänst: Real-Time CDP.

Tidsserieprofilshändelser innehåller data om kundens profilinformation, t.ex. om de skapar, redigerar eller tar bort ett konto på din webbplats. När data för profithändelser skickas till Experience Platform finns de i en datauppsättning där de kan användas av andra DX-produkter.

  1. Se till att du har tillhandahålls tjänstkonto och autentiseringsuppgifter.

  2. Se till att du har ett schema och en datauppsättning angiven för inmatning av profilpostdata och tidsserieprofilhändelsedatainmatning.

  3. Placera en bock i Kundprofiler om du vill skicka profildata till Experience Platform.

  4. Ange Profilens datauppsättnings-ID.

    Profilpostdata måste använda en annan datauppsättning än den du använder för beteendedata och data för Office-händelser.

  5. Om du inte vill direktuppspela profilhändelser via samma dataström-ID som du använder för beteendes- och back office-data, tar du bort bockmarkeringen från Strömma kundprofiler via samma dataström-ID och ange det datastream-ID som du vill använda i stället.

Det kan ta ca 10 minuter innan en profilpost är tillgänglig i Real-Time CDP. Profilhändelser börjar direktuppspelningen omedelbart.

Fältbeskrivningar

Fält
Beskrivning
Kundprofiler
Markera den här kryssrutan om du vill samla in och skicka kundprofilsposter.
Profilens datauppsättnings-ID
En profilpost måste använda en annan datauppsättning än den som används för beteendehändelser och back office-händelser.
Strömma kundprofiler via samma dataström-ID
Bestäm om du vill använda samma datastream som för närvarande används för dina beteende- och back office-händelser eller inte.
Datastream för kundprofiler
Ange den postspecifika dataströmmen för kundprofilen.

Skicka historikorderdata

Adobe Commerce samlar in upp till fem års historiska orderdata och orderstatus. Du kan använda Data Connection för att skicka historiska data till Experience Platform för att berika era kundprofiler och personalisera kundupplevelserna baserat på tidigare order. Data lagras i en datauppsättning i Experience Platform.

Commerce samlar redan in historiska orderdata, men det finns flera steg som du måste slutföra för att skicka dessa data till Experience Platform.

I den här videon får du lära dig mer om historiska order. Följ sedan stegen nedan för att implementera den historiska ordersamlingen.

Konfigurera tjänsten Ordersynkronisering

Ordersynkroniseringstjänsten använder Message Queue Framework och RabbitMQ. När du har utfört dessa steg kan orderstatusdata synkroniseras till SaaS, vilket krävs innan det skickas till Experience Platform.

  1. Se till att du har tillhandahålls tjänstkonto och autentiseringsuppgifter.

  2. Aktivera RabbitMQ.

    note note
    NOTE
    RabbitMQ har redan konfigurerats för Commerce version 2.4.7 och senare, men du måste göra det möjligt för konsumenterna.
  3. Aktivera användare av meddelandekö via cron-jobb i .magento.env.yaml använda CRON_CONSUMERS_RUNNER miljövariabel.

    code language-yaml
       stage:
         deploy:
           CRON_CONSUMERS_RUNNER:
             cron_run: true
    
    note note
    NOTE
    Se dokumentation för driftsättningsvariabler om du vill veta mer om alla tillgängliga konfigurationsalternativ.

När ordersynkroniseringstjänsten är aktiverad kan du sedan ange det historiska datumintervallet för beställningen i Data Connection sida.

Ange datumintervall för orderhistorik

Ange datumintervallet för de historiska order som du vill skicka till Experience Platform.

  1. Gå till Admin System > Tjänster > Data Connection.

  2. Välj Orderhistorik -fliken.

  3. Under Synkronisering av orderhistorik, Kopiera datauppsättnings-ID från inställningar kryssrutan är redan aktiverad. Detta garanterar att du använder samma datauppsättning som anges i Inställningar -fliken.

  4. I Från och Till anger du datumintervallet för historikorderdata som du vill skicka. Du kan inte välja ett datumintervall som överskrider fem år.

  5. Välj Start Sync för att starta synkroniseringen. Historiska orderdata batchas till data i motsats till butiks- och back office-data som är strömmande data. Det tar ca 45 minuter att få fram gruppdata i Experience Platform.

Fältbeskrivningar
Fält
Beskrivning
Kopiera datauppsättnings-ID från inställningar
Kopierar det datauppsättnings-ID som du angav på Inställningar -fliken.
Datauppsättnings-ID (webbplats)
ID för den datauppsättning som innehåller dina Commerce-data. Det här fältet är obligatoriskt såvida du inte har avmarkerat Storefront-händelser eller Back office-händelser kryssrutor. Om du använder ditt eget Experience Platform Web SDK och därför inte angav något datastream-ID, måste du ändå lägga till det datauppsättnings-ID som är kopplat till ditt datastream. Annars kan du inte spara det här formuläret.
Från
Det datum från vilket du vill börja samla in orderhistorikdata.
Till
Det datum från vilket du vill avsluta insamlingen av orderhistorikdata.
Starta synkronisering
Påbörjar synkroniseringen av orderhistorikdata till Experience Platform. Den här knappen är inaktiverad om Dataset ID fältet är tomt eller datauppsättnings-ID:t är ogiltigt.

Bekräfta att händelsedata samlas in

Om du vill bekräfta att data samlas in från din Commerce Store använder du Adobe Experience Platform debugger för att undersöka din Commerce webbplats. När du har bekräftat att data samlas in kan du verifiera att data för butiks- och back office-händelser visas i kanten genom att köra en fråga som returnerar data från datauppsättning som du skapade.

  1. Välj Frågor till vänster i Experience Platform och klicka Create Query.

    Frågeredigeraren

  2. När Frågeredigeraren öppnas anger du en fråga som markerar data från datauppsättningen.

    Skapa fråga

    Din fråga kan till exempel se ut så här:

    code language-sql
    SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
    
  3. När frågan har körts visas resultaten i Resultat -flik, bredvid Konsol -fliken. I den här vyn visas frågans tabellutdata.

    Frågeredigeraren

I det här exemplet ser du händelsedata från commerce.productListAdds, commerce.productViews, web.webpagedetails.pageViewsoch så vidare. I den här vyn kan du verifiera att dina Commerce-data finns i framkanten.

Om resultaten inte är vad du förväntar dig kan du öppna datauppsättningen och leta efter misslyckade batchimporter. Läs mer om felsöka batchimport.

Nästa steg

När data från Commerce skickas till Experience Platform kan andra Adobe Experience Cloud-produkter, som Adobe Journey Optimizer, använda dessa data. Du kan till exempel konfigurera Journey Optimizer att lyssna på vissa händelser och utifrån dessa händelsedata utlösa ett e-postmeddelande för en förstagångsanvändare eller om det finns en övergiven kundvagn. Lär dig hur du kan utöka din Commerce-plattform med skapa kundresor i Journey Optimizer.

recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840