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:

  1. Meld u aan bij uw Commerce-account om productie- en sandbox-API-sleutels ophalen.
  2. Selecteer een SaaS-gegevensruimte.
  3. 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.

  1. Navigeer in Commerce Admin naar Winkels > Instellingen > Configuratie > Services > Data Connection.

  2. 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.

  3. (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.

  4. Kopieer de inhoud van het dialoogvenster <workspace-name>.json in het bestand Servicerekening/Referentiedetails veld.

    Data Connection Beheerdersconfiguratie {width="700" modal="regular"}

  5. Klikken Config opslaan.

Algemeen

  1. Ga in Beheer naar Systeem > Services > Data Connection.

  2. 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.

  3. In de Toepassingsgebied vervolgkeuzelijst, de context instellen op Website.

  4. (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 ProductAdd 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.

NOTE
Alle velden in het dialoogvenster Gegevensverzameling van toepassing Website bereik of hoger.
  1. Selecteren Gebeurtenissen van Storefront als u gedragsgegevens van de storefront wilt verzenden.

  2. 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.
  3. (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.

  4. Voer de Dataset-id die je Commerce-gegevens wilt bevatten. De id van de gegevensset zoeken:

    1. 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.
    2. Open de dataset verbonden aan uw gegevensstroom.
    3. In de rechterruit, bekijk de details over de dataset. Kopieer de id van de gegevensset.
  5. Om de updates van de backoffice gebeurtenisgegevens te verzekeren die op een programma volgens een kraan taak, moet u de Sales Orders Feed indexeren naar Update by Schedule.

    1. Op de Beheerder zijbalk, ga naar System > Tools>Index Management.

    2. Schakel het selectievakje in voor de Sales Orders Feed indexeerprogramma.

    3. Set Actions tot Update by Schedule.

    4. 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

Veld
Beschrijving
Toepassingsgebied
Specifieke website waarop u de configuratie-instellingen wilt toepassen.
Organisatie-id (wereldwijd)
Id die behoort tot de organisatie die het Adobe DX-product heeft aangeschaft. Deze id koppelt uw Adobe Commerce-exemplaar aan Adobe Experience Platform.
Is de AEP Web SDK reeds opgesteld aan uw plaats
Schakel dit selectievakje in als u uw eigen AEP Web SDK aan uw site hebt toegewezen
AEP Web SDK Name (global)
Als u reeds een Experience Platform Web SDK hebt die aan uw plaats wordt opgesteld, specificeer de naam van die SDK op dit gebied. Dit staat de Collector van de Gebeurtenis Storefront en de Gebeurtenis SDK toe om uw Experience Platform Web SDK eerder dan de versie te gebruiken die door wordt opgesteld Data Connection extensie. Als u geen Experience Platform Web SDK hebt die aan uw plaats wordt opgesteld, verlaat dit gebied leeg, en Data Connection De extensie implementeert er één voor u.
Gebeurtenissen van Storefront
Wordt standaard ingeschakeld zolang de organisatie-id en de gegevensstroom-id geldig zijn. Met Storefront-gebeurtenissen worden geanonimiseerde gedragsgegevens verzameld bij kopers die door uw site bladeren.
Back office evenementen
Als deze optie is ingeschakeld, bevat de gebeurtenislading geanonimiseerde gegevens over de status van de bestelling, zoals of een bestelling is geplaatst, geannuleerd, terugbetaald of verzonden.
DataStream-id (website)
ID die gegevens om van Adobe Experience Platform aan andere Adobe DX producten toestaat te stromen. Deze id moet zijn gekoppeld aan een specifieke website in uw specifieke Adobe Commerce-exemplaar. Als u uw eigen SDK van het Web van het Experience Platform specificeert, specificeer geen gegevensstroom identiteitskaart op dit gebied. De Data Connection De extensie gebruikt de gegevensstroom-id die aan die SDK is gekoppeld en negeert de gegevensstroom-id die in dit veld is opgegeven (indien aanwezig).
Gegevensset-id (website)
Id van de dataset die uw gegevens van Commerce bevat. Dit veld is vereist tenzij u de optie Gebeurtenissen van Storefront of Back office evenementen selectievakjes. Ook, als u uw eigen SDK van het Web van het Experience Platform gebruikt en daarom geen gegevensstroom identiteitskaart specificeerde, moet u dataset ID nog toevoegen verbonden aan uw gegevensstroom. Anders kunt u dit formulier niet opslaan.

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

IMPORTANT
Deze functie is in bèta.

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.

  1. Zorg ervoor dat u verstrekt serviceaccount en referentiedetails.

  2. Zorg ervoor u een schema en dataset hebt die voor wordt gespecificeerd opnemen van profielrecordgegevens en tijdreeksprofiel voor gebeurtenisgegevens invoeren.

  3. Een vinkje plaatsen in het dialoogvenster Klantprofielen Schakel het selectievakje in als u profielgegevens naar het Experience Platform wilt verzenden.

  4. Voer de Profielgegevensset-id.

    De het verslaggegevens van het profiel moeten een verschillende dataset gebruiken dan wat u momenteel voor gedrags en achterkantoorgebeurtenisgegevens gebruikt.

  5. 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

Veld
Beschrijving
Klantprofielen
Schakel dit selectievakje in als u records met klantprofielen wilt verzamelen en verzenden.
Profielgegevensset-id
Een profielverslag moet een verschillende dataset gebruiken dan de dataset die voor gedrags en achterkantoorgebeurtenissen wordt gebruikt.
Klantprofielen streamen via dezelfde gegevensstroom-id
Bepaal of u dezelfde gegevensstroom wilt gebruiken die momenteel wordt gebruikt voor uw gedrags- en backoffice-gebeurtenissen.
DataStream voor klantprofielen
Geef de recordspecifieke gegevensstroom voor het klantprofiel op.

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.

  1. Zorg ervoor dat u verstrekt serviceaccount en referentiedetails.

  2. Inschakelen RabbitMQ.

    note note
    NOTE
    RabbitMQ is al ingesteld voor Commerce versie 2.4.7 en hoger, maar u moet de consument inschakelen.
  3. Gebruikers in een wachtrij met berichten inschakelen op snijtaak in .magento.env.yaml gebruiken CRON_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.

  1. Ga in Beheer naar Systeem > Services > Data Connection.

  2. Selecteer de Orderhistorie tab.

  3. 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.

  4. 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.

  5. 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
Veld
Beschrijving
Gegevensset-id kopiëren uit instellingen
Kopieert dataset ID u op ingegaan Instellingen tab.
Gegevensset-id (website)
Id van de dataset die uw gegevens van Commerce bevat. Dit veld is vereist tenzij u de optie Gebeurtenissen van Storefront of Back office evenementen selectievakjes. Ook, als u uw eigen SDK van het Web van het Experience Platform gebruikt en daarom geen gegevensstroom identiteitskaart specificeerde, moet u dataset ID nog toevoegen verbonden aan uw gegevensstroom. Anders kunt u dit formulier niet opslaan.
Van
Datum vanaf wanneer u wilt beginnen met het verzamelen van gegevens over de ordergeschiedenis.
Naar
Datum vanaf welke u het verzamelen van de gegevens van de ordegeschiedenis wilt beëindigen.
Synchronisatie starten
Begint het proces om de gegevens van de ordegeschiedenis aan de rand van het Experience Platform te synchroniseren. Deze knop is uitgeschakeld als de Dataset ID veld is leeg of de id van de gegevensset is ongeldig.

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.

  1. Selecteren Zoekopdrachten in de linkernavigatie van het Experience Platform en klik Create Query.

    Query-editor

  2. Wanneer de Redacteur van de Vraag opent, ga een vraag in die gegevens van de dataset selecteert.

    Query maken

    Uw query ziet er bijvoorbeeld als volgt uit:

    code language-sql
    SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
    
  3. 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.

    Query-editor

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.

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