Commerce-gegevens verbinden met Adobe Experience Platform
Wanneer u de Data Connection extensie, worden twee nieuwe configuratiepagina's weergegeven in de Systeem menu onder Services in Commerce Beheerder.
- Commerce Services Connector
- Data Connection
Als u uw Adobe Commerce-instantie wilt aansluiten op de Adobe Experience Platform, moet u beide connectors configureren, te beginnen met de Commerce Services-connector en vervolgens voltooien met de Data Connection extensie.
De Commerce Services-connector configureren
Als u eerder een Adobe Commerce-service hebt geïnstalleerd, hebt u waarschijnlijk al de Commerce Services-connector geconfigureerd. Indien niet, dan moet u de volgende taken op Commerce Services-connector pagina:
- Meld u aan bij uw Commerce-account om productie- en sandbox-API-sleutels ophalen.
- Selecteer een SaaS-gegevensruimte.
- Meld u aan bij uw Adobe-account om uw organisatie-id ophalen.
Nadat u de schakelaar van de Diensten van Commerce vormt, vormt u dan Data Connection extensie.
Vorm Data Connection extension
In deze sectie leert u hoe u de Data Connection extensie.
Servicerekening en verificatiegegevens toevoegen
Als u van plan bent om te verzamelen en te verzenden historische-ordegegevens of klantprofielgegevens, moet u de dienstrekening en credentiedetails toevoegen. Ook als u het Audience Activation moet u deze stappen uitvoeren.
Als u slechts storefront of achterkantoorgegevens verzamelt en verzendt, kunt u aan overslaan algemeen sectie.
Stap 1: Een project maken in Adobe Developer Console
Maak een project in de Adobe Developer-console waarmee Commerce wordt geverifieerd, zodat deze API-aanroepen voor Experience Platforms kan uitvoeren.
Volg de stappen in het dialoogvenster API's van Experience Platforms verifiëren en openen zelfstudie.
Terwijl u de zelfstudie doorloopt, moet u ervoor zorgen dat uw project het volgende heeft:
- Toegang tot het volgende productprofielen: Standaardproductie, alle toegang en Alle toegang standaard AEP.
- De juiste rollen en toestemmingen worden gevormd.
- Als u hebt besloten JSON Web Tokens (JWT) als uw server-aan-server authentificatiemethode te gebruiken, moet u ook een privé sleutel uploaden.
Het resultaat van deze stap leidt tot een configuratiedossier dat u in de volgende stap gebruikt.
Stap 2: configuratiebestand downloaden
Download de workspace-configuratiebestand. De inhoud van dit bestand kopiëren en in het Servicerekening/Referentiedetails pagina van de Commerce Admin.
-
Navigeer in Commerce Admin naar Winkels > Instellingen > Configuratie > Services > Data Connection.
-
Selecteer de server-aan-server vergunningsmethode die u van uitvoerde Adobe Developer-autorisatietype -menu. Adobe beveelt het gebruik van OAuth aan. JWT is vervangen. Meer informatie.
-
(Alleen JWT) Kopieer en plak de inhoud
private.key
in het bestand Clientgeheim veld. Gebruik de volgende opdracht om de inhoud te kopiëren.code language-bash cat config/private.key | pbcopy
Zie Service Account (JWT)-verificatie voor meer informatie over de
private.key
bestand. -
Kopieer de inhoud van het dialoogvenster
<workspace-name>.json
in het bestand Servicerekening/Referentiedetails veld. -
Klikken Config opslaan.
Algemeen
-
Ga in Beheer naar Systeem > Services > Data Connection.
-
Op de Instellingen tab onder Algemeen, controleert u de id die aan uw Adobe Experience Platform-account is gekoppeld, zoals deze is geconfigureerd in het dialoogvenster Commerce Services Connector. De organisatie-id is algemeen. Per Adobe Commerce-exemplaar kan slechts één organisatie-id worden gekoppeld.
-
In de Toepassingsgebied vervolgkeuzelijst, de context instellen op Website.
-
(Optioneel) Als u al een AEP Web SDK (legering) opgesteld aan uw plaats, laat checkbox toe en voeg de naam van uw Web SDK van AEP toe. Anders, verlaat deze gebieden leeg en Data Connection De extensie implementeert er één voor u.
note note NOTE Als u uw eigen AEP Web SDK specificeert, Data Connection De extensie gebruikt de gegevensstroom-id die aan die SDK is gekoppeld en niet de gegevensstroom-id die op deze pagina is opgegeven (indien aanwezig).
Gegevensverzameling
In deze sectie geeft u het type gegevens op dat u wilt verzamelen en naar de rand van het Experience Platform wilt verzenden. Er zijn drie soorten gegevens:
-
Gedrag (client-side gegevens) zijn gegevens die zijn vastgelegd in de opslagomgeving. Dit omvat winkelinteracties, zoals
View Page
,View Product
,Add to Cart
, en aanvraaglijst informatie (voor B2B-handelaren). -
Achterkantoor (server-side gegevens) zijn gegevens die zijn vastgelegd op de Commerce-servers. Dit omvat informatie over de status van een bestelling, zoals of een bestelling is geplaatst, geannuleerd, terugbetaald, verzonden of voltooid. Het omvat ook historische-ordegegevens.
-
Profiel (bèta) Dit zijn gegevens die betrekking hebben op de profielgegevens van je winkel. Meer informatie meer.
Als u er zeker van wilt zijn dat uw Adobe Commerce-instantie kan beginnen met het verzamelen van gegevens, raadpleegt u de voorwaarden.
Zie het gebeurtenisonderwerp om meer over te leren storefront, achterkantoor, en profiel gebeurtenissen.
-
Selecteren Gebeurtenissen van Storefront als u gedragsgegevens van de storefront wilt verzenden.
-
Selecteren Back office evenementen als u de statusinformatie van een bestelling wilt verzenden, bijvoorbeeld of een bestelling is geplaatst, geannuleerd, terugbetaald of verzonden.
note note NOTE Als u Back office evenementen, worden alle gegevens van het achterkantoor naar de rand van het Experience Platform verzonden. Als een winkelier ervoor kiest zich af te melden voor gegevensverzameling, moet u de privacyvoorkeur van de winkels expliciet instellen in het Experience Platform. Dit is anders dan storefront-gebeurtenissen waarbij de verzamelaar al toestemming afhandelt op basis van de voorkeuren van de winkels. Meer informatie meer over het instellen van de privacyvoorkeur van een winkelier in het Experience Platform. -
(Sla deze stap over als u uw eigen AEP Web SDK gebruikt.) Maken een gegevensstroom in de Adobe Experience Platform of selecteer een bestaande gegevensstroom u voor inzameling wilt gebruiken. Voer die gegevensstroom-id in het dialoogvenster DataStream-id veld.
-
Voer de Dataset-id die je Commerce-gegevens wilt bevatten. De id van de gegevensset zoeken:
- Open de interface van het Experience Platform en selecteer Gegevenssets in de linkernavigatie om het dialoogvenster Gegevenssets dashboard. Het dashboard maakt een lijst van alle beschikbare datasets voor uw organisatie. De details worden getoond voor elke vermelde dataset, met inbegrip van zijn naam, het schema de dataset zich aan, en status van de meest recente versiereeks houdt.
- Open de dataset verbonden aan uw gegevensstroom.
- In de rechterruit, bekijk de details over de dataset. Kopieer de id van de gegevensset.
-
Om de updates van de backoffice gebeurtenisgegevens te verzekeren die op een programma volgens een kraan taak, moet u de
Sales Orders Feed
indexeren naarUpdate by Schedule
.-
Op de Beheerder zijbalk, ga naar System > Tools>Index Management.
-
Schakel het selectievakje in voor de
Sales Orders Feed
indexeerprogramma. -
Set Actions tot
Update by Schedule
. -
Als u de gegevens van het achterkantoor voor het eerst toelaat, stel de volgende bevelen in werking om opnieuw te indexeren en een resync teweeg te brengen. Volgende resyncs komen automatisch voor zolang als kraan taak correct is ingesteld.
code language-bash bin/magento index:reindex sales_order_data_exporter_v2
code language-bash bin/magento saas:resync --feed orders
-
Veldomschrijvingen
Na het instappen, beginnen de storefrontgegevens aan de rand van het Experience Platform te stromen. Het duurt ongeveer vijf minuten voordat de gegevens op het achterkantoor aan de rand worden weergegeven. Volgende updates zijn zichtbaar aan de rand op basis van het uitsnijdschema.
Klantprofielgegevens verzenden
Er zijn twee typen profielgegevens die u naar het Experience Platform kunt verzenden: profielrecords en tijdreeksprofielgebeurtenissen.
Een profielrecord bevat gegevens die worden opgeslagen wanneer een gebruiker een profiel in uw Commerce-instantie maakt, zoals de naam van de klant. Wanneer uw schema en dataset zijn correct geconfigureerd, wordt een profielrecord naar het Experience Platform verzonden en doorgestuurd naar de profielbeheer- en segmentatiedienst van de Adobe: Real-Time CDP.
Profielgebeurtenissen uit een tijdreeks bevatten gegevens over de profielgegevens van uw klant, zoals het maken, bewerken of verwijderen van een account op uw site. Wanneer de gegevens van de profielgebeurtenis naar het Experience Platform worden verzonden, verblijft het in een dataset waar het door andere producten DX kan worden gebruikt.
-
Zorg ervoor dat u verstrekt serviceaccount en referentiedetails.
-
Zorg ervoor u een schema en dataset hebt die voor wordt gespecificeerd opnemen van profielrecordgegevens en tijdreeksprofiel voor gebeurtenisgegevens invoeren.
-
Een vinkje plaatsen in het dialoogvenster Klantprofielen Schakel het selectievakje in als u profielgegevens naar het Experience Platform wilt verzenden.
-
Voer de Profielgegevensset-id.
De het verslaggegevens van het profiel moeten een verschillende dataset gebruiken dan wat u momenteel voor gedrags en achterkantoorgebeurtenisgegevens gebruikt.
-
Als u profielgebeurtenissen niet via de zelfde gegevensstroom identiteitskaart wilt stromen die u voor gedrag en achterkantoorgegevens gebruikt, verwijder het controleteken uit Klantprofielen streamen via dezelfde gegevensstroom-id en voer in plaats daarvan de gegevensstroom-id in die u wilt gebruiken.
Het kan ongeveer 10 minuten duren voordat een profielrecord beschikbaar is in Real-Time CDP. Profielgebeurtenissen beginnen direct met streamen.
Veldomschrijvingen
Gegevens in historische volgorde verzenden
Adobe Commerce verzamelt maximaal vijf jaar historische ordegegevens en status. U kunt de Data Connection uitbreiding om die historische gegevens naar het Experience Platform te verzenden om uw klantenprofielen te verrijken en de klantenervaringen te personaliseren die op die vroegere orden worden gebaseerd. De gegevens worden opgeslagen in een dataset binnen Experience Platform.
Hoewel Commerce de gegevens van de historische volgorde al verzamelt, moet u verschillende stappen uitvoeren om die gegevens naar het Experience Platform te verzenden.
Bekijk deze video om meer over historische orden te leren dan voltooi de volgende stappen om historische ordeverzameling uit te voeren.
De bestelsynchronisatieservice instellen
De bestelsynchronisatieservice gebruikt de Message Queue Framework en RabbitMQ. Nadat u deze stappen hebt uitgevoerd, kunnen de statusgegevens van de bestelling worden gesynchroniseerd met SaaS, wat vereist is voordat deze naar het Experience Platform worden verzonden.
-
Zorg ervoor dat u verstrekt serviceaccount en referentiedetails.
-
Inschakelen RabbitMQ.
note note NOTE RabbitMQ is al ingesteld voor Commerce versie 2.4.7 en hoger, maar u moet de consument inschakelen. -
Gebruikers in een wachtrij met berichten inschakelen op snijtaak in
.magento.env.yaml
gebruikenCRON_CONSUMERS_RUNNER
omgevingsvariabele.code language-yaml stage: deploy: CRON_CONSUMERS_RUNNER: cron_run: true
note note NOTE Zie de documentatie over implementatievariabelen voor meer informatie over alle beschikbare configuratieopties.
Als de bestelsynchronisatieservice ingeschakeld is, kunt u het historische bereik van de orderdatum opgeven in het dialoogvenster Data Connection pagina.
Datumbereik van orderhistorie opgeven
Geef het datumbereik op voor de historische orders die u naar het Experience Platform wilt verzenden.
-
Ga in Beheer naar Systeem > Services > Data Connection.
-
Selecteer de Orderhistorie tab.
-
Onder Synchronisatie van orderhistorie de Gegevensset-id kopiëren uit instellingen selectievakje is al ingeschakeld. Dit verzekert u het zelfde dataset gebruikt die in wordt gespecificeerd Instellingen tab.
-
In de Van en Naar geeft u het datumbereik op voor de historische volgordegegevens die u wilt verzenden. U kunt geen datumbereik selecteren dat langer is dan vijf jaar.
-
Selecteren Start Sync om de synchronisatie te activeren. Historische ordegegevens zijn batchgegevens in tegenstelling tot opslag en achterkantoorgegevens die gegevens stromen. Het duurt ongeveer 45 minuten voordat de gegevens in de batch in Experience Platform zijn ontvangen.
Veldomschrijvingen
Bevestig dat gebeurtenisgegevens worden verzameld
Als u wilt bevestigen dat gegevens worden verzameld in uw Commerce-winkel, gebruikt u de Adobe Experience Platform debugger om je Commerce-site te bekijken. Nadat u hebt bevestigd dat de gegevens worden verzameld, kunt u verifiëren dat uw opslag en de gegevens van de achterkantoorgebeurtenis bij de rand verschijnen door een vraag in werking te stellen die gegevens van terugkeert gegevensset die u hebt gemaakt.
-
Selecteren Zoekopdrachten in de linkernavigatie van het Experience Platform en klik Create Query.
-
Wanneer de Redacteur van de Vraag opent, ga een vraag in die gegevens van de dataset selecteert.
Uw query ziet er bijvoorbeeld als volgt uit:
code language-sql SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
-
Nadat de vraag loopt, worden de resultaten getoond in Resultaten tab, naast de Console tab. In deze weergave ziet u de tabeluitvoer van uw query.
In dit voorbeeld ziet u gebeurtenisgegevens uit de commerce.productListAdds
, commerce.productViews
, web.webpagedetails.pageViews
, enzovoort. In deze weergave kunt u controleren of uw Commerce-gegevens zich aan de rand bevinden.
Als de resultaten niet zijn wat u verwacht, open uw dataset en zoek om het even welke ontbroken partijinvoer. Meer informatie over problemen oplossen bij importeren van batch.
Volgende stappen
Wanneer Commerce-gegevens naar de rand van het Experience Platform worden verzonden, kunnen andere Adobe Experience Cloud-producten, zoals Adobe Journey Optimizer, die gegevens gebruiken. U kunt Journey Optimizer bijvoorbeeld configureren om te luisteren naar bepaalde gebeurtenissen en op basis van die gebeurtenisgegevens een e-mail activeren voor een nieuwe gebruiker of als er een verlaten winkelwagentje is. Meer weten over het uitbreiden van je Commerce platform met maken van reizen van klanten in Journey Optimizer.