Commerce-gegevens verbinden met Adobe Experience Platform
- Onderwerpen:
- Personalisatie
- Configuratie
Gemaakt voor:
- Beheerder
Wanneer u de Data Connection uitbreiding installeert, verschijnen twee nieuwe configuratiepagina's in het Systeem menu onder Diensten in Commerce Admin.
- Commerce Services Connector
- Data Connection
Als u uw Adobe Commerce-instantie wilt verbinden met 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. Als niet, dan moet u de volgende taken op de schakelaar van de Diensten van Commercepagina voltooien:
- Login aan uw rekening van Commerce wint uw productie en zandbak API sleutelsterug.
- Selecteer a SaaS gegevensruimte.
- Login aan uw rekening van Adobe wint uw identiteitskaart van de Organisatieterug.
Nadat u de Commerce Services-connector hebt geconfigureerd, configureert u de extensie Data Connection .
De extensie Data Connection configureren
In deze sectie leert u hoe u de extensie Data Connection configureert.
Servicerekening en verificatiegegevens toevoegen
Als u van plan bent om historische ordegegevensof gegevens van het klantenprofielte verzamelen en te verzenden, moet u de dienstrekening en credentiedetails toevoegen. Ook, als u de uitbreiding van Audience Activationvormt, moet u deze stappen voltooien.
Als u slechts storefront of achterbureaugegevens verzamelt en verzendt, kunt u aan de algemenesectie overslaan.
Stap 1: Een project maken in Adobe Developer Console
Maak in de Adobe Developer Console een project voor het verifiëren van Commerce zodat Experience Platform API-aanroepen kunnen worden uitgevoerd.
Om het project tot stand te brengen, volg de stappen die in worden geschetst voor authentiek verklaren en toegang Experience Platform APIsleerprogramma.
Terwijl u de zelfstudie doorloopt, moet u ervoor zorgen dat uw project het volgende heeft:
- Toegang tot de volgende productprofielen: Standaardproductie alle toegang en Standaard AEP alle toegang.
- De correcte rollen en de 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 het dossier van de werkruimteconfiguratie. Kopieer en kleef de inhoud van dit dossier in de Rekening van de Dienst/Credentiële details pagina van Commerce Admin.
-
In Commerce Admin, navigeer aan Opslag > Montages > Configuratie > de Diensten > Data Connection.
-
Selecteer de server-aan-server vergunningsmethode die u van het Van het Type van Vergunning van Adobe Developer menu uitvoerde. Adobe raadt u aan OAuth te gebruiken. JWT is vervangen. leer meer.
-
(JWT slechts) Exemplaar en kleef de inhoud van uw
private.keydossier in het Geheime gebied van de Cliënt. Gebruik de volgende opdracht om de inhoud te kopiëren.cat config/private.key | pbcopyZie Authentificatie van de Rekening van de Dienst (JWT)voor meer informatie over het
private.keydossier. -
Kopieer de inhoud van het
<workspace-name>.jsondossier in het de Rekening van de Dienst/Credentiële details gebied.
-
Klik sparen Config.
-
Klik op de knop Test connection om te controleren of de ingevoerde serviceaccount en referentie-informatie juist zijn.
Algemeen
-
In Admin, ga naar Systeem > de Diensten > Data Connection.
-
Op het lusje van Montages onder Algemeen, verifieer identiteitskaart verbonden aan uw rekening van Adobe Experience Platform, zoals die in de Schakelaar van de Diensten van Commercewordt gevormd. De organisatie-id is algemeen. Per Adobe Commerce-exemplaar kan slechts één organisatie-id worden gekoppeld.
-
In het drop-down van het Werkgebied, plaats de context aan Website.
-
(Optioneel) Als u al een AEP Web SDK (legering)aan uw site hebt geïmplementeerd, schakelt u het selectievakje in en voegt u de naam van uw AEP Web SDK toe. Anders laat u deze velden leeg en implementeert de extensie Data Connection er een voor u.
NOTEAls u uw eigen AEP Web SDK opgeeft, gebruikt de extensie Data Connection 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 Experience Platform-rand wilt verzenden. Er zijn drie soorten gegevens:
-
Gedrag (cliënt-zijgegevens) is gegevens die op storefront worden gevangen. Dit omvat winkelinteracties, zoals
View Page,View Product,Add to Cart, en de lijstinformatie van de 3} aanvraag(voor B2B handelaren). -
het bureau van de rug (server-zijgegevens) is gegevens die in de servers van Commerce worden gevangen. 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 is gegevens met betrekking tot de het profielinformatie van uw klant. Leer meer.
Om ervoor te zorgen dat uw instantie van Adobe Commerce met gegevensinzameling kan beginnen, herzie de eerste vereisten.
Zie het gebeurtenisonderwerp om meer over storefront, achterkantoor, en profielgebeurtenissen te leren.
NOTE-
Selecteer gebeurtenissen Storefront als u storefront gedragsgegevens wilt verzenden.
-
Selecteer de gebeurtenissen van het achterkantoor als u de informatie van de ordestatus, zoals wilt verzenden als een orde werd geplaatst, geannuleerd, terugbetaald, of verscheept.
NOTEAls u de gebeurtenissen van het achterkantoor selecteert, worden alle achterkantoorgegevens verzonden naar de rand van Experience Platform. Als een winkelier ervoor kiest zich af te melden voor gegevensverzameling, moet u de privacyvoorkeur van de winkels expliciet instellen in de Experience Platform. Dit is anders dan storefront-gebeurtenissen waarbij de verzamelaar al toestemming afhandelt op basis van de voorkeuren van de winkels. Leer meerover het plaatsen van de privacyvoorkeur van een verkoopster in Experience Platform. -
(Sla deze stap over als u uw eigen SDK van het Web van AEP. gebruikt) creeereen gegevensstroom in Adobe Experience Platform of selecteer een bestaande gegevensstroom u voor inzameling wilt gebruiken. Ga die gegevensstroomidentiteitskaart op het gebied van identiteitskaart 0} DataStream in.
-
Ga identiteitskaart van de Dataset in die u uw gegevens van Commerce wilt bevatten. De id van de gegevensset zoeken:
- Open Experience Platform UI en selecteer Datasets in de linkernavigatie om het dashboard van Datasets {te openen. 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 achterkantoorgebeurtenisgegevens te verzekeren die op een programma volgens a worden gebaseerd bouwtbaan, moet u de
Sales Orders Feedindex inUpdate by Scheduleveranderen.-
Voor Admin sidebar, ga System > Tools>Index Management.
-
Schakel het selectievakje voor de
Sales Orders Feedindexer in. -
Stel Actions in op
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. De verdere resyncs komen automatisch voor zolang de bouwtbaan correct opstelling is.
bin/magento index:reindex sales_order_data_exporter_v2bin/magento saas:resync --feed orders
-
Veldomschrijvingen
Na het instappen, beginnen de archiefgegevens aan de rand van 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 de 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 behoorlijk worden gevormd, wordt een profielverslag verzonden naar Experience Platform en door:sturen aan het profielbeheer en de segmenteringsdienst van 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 Experience Platform worden verzonden, verblijft het in een dataset waar het door andere producten DX kan worden gebruikt.
-
Zorg ervoor u verstrektede dienstrekening en credentiedetails hebt.
-
Zorg ervoor u een schema en dataset hebt die voor wordt gespecificeerd de gegevensopname van het profielverslagen de gebeurtenisopname van het tijdreeksenprofiel.
-
Plaats een controleteken in de profielen van de Klant checkbox als u profielgegevens naar Experience Platform wilt verzenden.
-
Ga identiteitskaart van de Dataset van het Profiel in.
De het verslaggegevens van het profiel moeten een verschillende dataset gebruiken dan wat u momenteel voor gedrags en achterkantoorgebeurtenisgegevens gebruikt.
-
Als u niet profielgebeurtenissen door zelfde gegevensstroom identiteitskaart wilt stromen die u voor gedrag en achterbureaugegevens gebruikt, verwijder het controleteken uit de de klantenprofielen van de Stroom door zelfde datastream identiteitskaart en ga gegevensstroom identiteitskaart in u in plaats daarvan wilt gebruiken.
Het kan ongeveer 10 minuten duren voordat een profielrecord beschikbaar is in Real-Time CDP. Profielgebeurtenissen beginnen direct met streamen.
TIPVeldomschrijvingen
Gegevens in historische volgorde verzenden
Adobe Commerce verzamelt tot vijf jaar van historische ordegegevens en status. U kunt de extensie Data Connection gebruiken om die historische gegevens naar de Experience Platform te verzenden om uw klantprofielen te verrijken en de ervaringen van de klant op basis van die eerdere bestellingen aan te passen. De gegevens worden opgeslagen in een dataset binnen Experience Platform.
Hoewel Commerce de historische ordergegevens al verzamelt, moet u verschillende stappen uitvoeren om die gegevens naar 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 dienst van de ordesynchronisatie gebruikt het Kader van de Rij van het Berichten RabbitMQ. Nadat u deze stappen hebt uitgevoerd, kunnen de statusgegevens van de bestelling worden gesynchroniseerd met SaaS, wat vereist is voordat deze naar Experience Platform worden verzonden.
-
Zorg ervoor u verstrektede dienstrekening en credentiedetails hebt.
-
laatRabbitMQ toe.
NOTERabbitMQ is al ingesteld voor Commerce versie 2.4.7 en hoger, maar u moet de consument inschakelen. -
Gebruikers in een wachtrij via een snijtaak inschakelen in
.magento.env.yamlmet behulp van de omgevingsvariabeleCRON_CONSUMERS_RUNNER.stage: deploy: CRON_CONSUMERS_RUNNER: cron_run: trueNOTEZie variabelen documentatieopstellen om over alle beschikbare configuratieopties te leren.
Als de bestelsynchronisatieservice is ingeschakeld, kunt u het historische bereik van de ordedatum opgeven op de pagina Data Connection .
Datumbereik van orderhistorie opgeven
Geef het datumbereik op voor de historische orders die u naar Experience Platform wilt verzenden.
-
In Admin, ga naar Systeem > de Diensten > Data Connection.
-
Selecteer de Geschiedenis van de Orde tabel.
-
Onder de Synchronisatie van de Geschiedenis van de Orde, wordt identiteitskaart van de Dataset van het Exemplaar van Montages checkbox reeds toegelaten. Dit verzekert u de zelfde dataset gebruikt die in de wordt gespecificeerd Montages tabel.
-
In van en aan gebieden, specificeer de datumwaaier voor de historische ordegegevens u wilt verzenden. U kunt geen datumbereik selecteren dat langer is dan vijf jaar.
-
Selecteer Start Sync om de synchronisatie te starten. 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
Aanpassing van gegevens
Op het lusje van de Aanpassing van Gegevens, kunt u om het even welke douanekenmerken bekijken die in Commerce worden gevormd en naar Experience Platform worden verzonden.
IMPORTANTWanneer u aangepaste kenmerken voor bestellingen maakt en deze naar de Experience Platform verzendt, moeten de kenmerknamen in Commerce overeenkomen met die in het Commerce -schema op de Experience Platform. Als ze niet overeenkomen, kan het moeilijk zijn om de verschillen vast te stellen. Als u namen verkeerd hebt overtroffen, kan de lijst van de Attributen van de Orde van de Douane helpen het probleem oplossen.
De Lijst van de Attributen van de Orde van de Douane verstrekt zicht in de configuratie en de afbeelding van de attributen van de douaneorde tussen het Commerce achterbureau en het Commerce schema in Experience Platform. In deze tabel kunt u aangepaste kenmerken op orderniveau en orderniveau in verschillende bronnen weergeven, zodat u ontbrekende of onjuist uitgelijnde kenmerken gemakkelijker kunt herkennen. Het toont ook dataset IDs helpen zich tussen levende en historische datasets onderscheiden, aangezien elk zijn eigen douanekenmerken kan hebben.
Als er geen groen vinkje wordt weergegeven naast de naam van een aangepast kenmerk in de tabel, wordt aangegeven dat de kenmerknamen in de bronnen niet overeenkomen. Corrigeer de kenmerknaam in één bron en er verschijnt een groen vinkje om aan te geven dat de namen nu overeenkomen.
- Als de attributennaam in het schema in Experience Platform wordt bijgewerkt, moet u de configuratie op het lusje van de Aanpassing van Gegevens bewaren om de het schemaverandering van Experience Platform teweeg te brengen. Deze verandering zal in de Lijst van de Attributen van de Orde van de Douane worden weerspiegeld wanneer u de Refresh knoop klikt.
- Als de attributennaam in Commerce wordt bijgewerkt, moet een ordegebeurtenis worden geproduceerd om de naam in de Lijst van de Attributen van de Orde van de Douane bij te werken. De verandering zal in ongeveer 60 minuten worden weerspiegeld.
Leer meer over hoe te de attributen van de opstellingsdouane.
Veldomschrijvingen
Bevestig dat gebeurtenisgegevens worden verzameld
Om te bevestigen dat het gegeven van uw opslag van Commerce wordt verzameld, gebruik debugger van Adobe Experience Platformom uw plaats van Commerce te onderzoeken. Nadat u bevestigt dat het gegeven wordt verzameld, kunt u verifiëren dat uw storefront en achterkantoorgebeurtenisgegevens bij de rand verschijnen door een vraag in werking te stellen die gegevens van de dataset terugkeert ucreeerde.
-
Selecteer Vragen in de linkernavigatie van 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:
SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC -
Na de vraaglooppas, worden de resultaten getoond in het lusje van Resultaten, naast de Console tabel. In deze weergave ziet u de tabeluitvoer van uw query.
In dit voorbeeld ziet u gebeurtenisgegevens van de deelvensters 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. Leer meer over de invoer van de het oplossen van problemenpartij.
Controleer of de profielgegevens worden weergegeven in de Experience Platform
Als u profielgegevens in Experience Platform ziet, zie Commerce KnowledgeBasevoor het oplossen van problemensuggesties.
Volgende stappen
Wanneer Commerce-gegevens naar de Experience Platform edge 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. Leer hoe u uw platform van Commerce kunt uitbreiden door klantenreizenin Journey Optimizer tot stand te brengen.