Integrera Adobe Experience Platform Mobile SDK med Commerce
Genom att integrera Adobe Experience Platform Mobile SDK med Commerce mobilapp kan handlare skicka Commerce händelsedata till Experience Platform.
När händelsedata från Commerce finns tillgängliga i kanten kan de nås av andra Adobe Experience Cloud-program. Du kan till exempel använda data för att skapa målgrupper i Real-Time CDP och sedan använda dessa målgrupper för att anpassa din Commerce-mobilapp.
Konfiguration
Om du vill komma igång med att använda Adobe Experience Platform Mobile SDK med Commerce installerar och konfigurerar du SDK i Experience Platform. Slutför sedan konfigurationen i Commerce.
Experience Platform
-
Läs mer om mobilappsfunktioner i självstudiekursen Adobe Experience Cloud i mobilappar.
-
Installera och konfigurera SDK i Experience Platform.
note note NOTE Schemat som du skapar och konfigurerar i Experience Platform är samma schema som du använder i programkoden i din Commerce-mobilapp.
Commerce
När du har slutfört SDK-konfigurationen för Experience-plattformen lägger du till SDK-konfigurationen i Commerce.
-
Om du vill skicka händelsedata från Commerce till Experience Platform via SDK måste du ange ett XDM-schema i programkoden. Det här schemat måste matcha schemat konfigurerat för SDK i Experience Platform.
I följande exempel visas hur du spårar händelsen
web.webpagedetails.pageViews
och angeridentityMap
med hjälp av e-postfältet.code language-swift let stateName = "luma: content: ios: us: en: home" var xdmData: [String: Any] = [ "eventType": "web.webpagedetails.pageViews", "web": [ "webPageDetails": [ "pageViews": [ "value": 1 ], "name": "Home page" ] ] ] let experienceEvent = ExperienceEvent(xdm: xdmData) Edge.sendEvent(experienceEvent: experienceEvent) // Adobe Experience Platform - Update Identity let emailLabel = "mobileuser@example.com" let identityMap: IdentityMap = IdentityMap() identityMap.add(item: IdentityItem(id: emailLabel), withNamespace: "Email") Identity.updateIdentities(with: identityMap)
-
Koppla upp dig till Commerce Cloud.
Lägg till URL:en till slutpunkten för Commerce GraphQL i projektets bygginställningar. Till exempel:
- Felsök: http://debug.commercialSite.cloud/graphql/
- Version: http://release.commercialSite.cloud/graphql/
-
Om du vill hämta data från slutpunkterna för Commerce GraphQL måste du först generera de filer och kataloger som behövs i ditt projekt med Apollo Code Generator.
-
Installera Apollo iOS från projektkatalogen.
-
Initiera Apollo Codegen CLI.
Detta skapar en
apollo-codegen-configuration.json
-fil. -
Generera nödvändiga GraphQL-filer och -kataloger i ditt projekt genom att ersätta innehållet i filen
apollo-codegen-configuration.json
med följande:code language-json { "schemaName" : "MagentoAPI", "input" : { "operationSearchPaths" : [ "**/*.graphql" ], "schemaSearchPaths" : [ "**/*.graphqls" ] }, "output" : { "testMocks" : { "none" : { } }, "schemaTypes" : { "path" : "../MagentoAPI", "moduleType" : { "swiftPackageManager" : { } } }, "operations" : { "inSchemaModule" : { } } }, "schemaDownloadConfiguration": { "downloadMethod": { "introspection": { "endpointURL": "http://magento24.com/graphql/", "httpMethod": { "POST": {} }, "includeDeprecatedInputValues": false, "outputFormat": "SDL" } }, "downloadTimeout": 60, "headers": [], "outputPath": "magento.graphqls" } }
-
Hämta Commerce GraphQL-schemat.
Kontrollera att sökvägen är till filen
./apollo-codegen-config.json
som innehåller referensen till Commerce GraphQL-schemat. -
Generera källkoden.
Kontrollera att sökvägen är till filen
./apollo-codegen-config.json
, som innehåller konfigurationsinformationen för att generera de filer och kataloger som krävs. -
Lägg till eller redigera GraphQL-typer i den nyligen skapade GraphQLGenerated -mappen. Du kan till exempel lägga till en
DynamicBlocks.graphql
-typ med följande innehåll:code language-graphql query dynamicBlocks($input: DynamicBlocksFilterInput){ dynamicBlocks(input: $input) { items { content { html } } } }
Du har nu integrerat Adobe Experience Platform Mobile SDK med din Commerce-mobilapp. Händelsedata flödar från appen till Experience Platform.
-
Hur man särskiljer Commerce-händelser som genereras från mobilprogram
Alla händelser innehåller fältet channel
. Fältet channel
innehåller channel._id
och channel._type
som för en Luma storefront har namnutrymmesvärdena "https://ns.adobe.com/xdm/channels/web"
respektive "https://ns.adobe.com/xdm/channel-types/web"
. I en mobilbutik är namnutrymmesvärdena "https://ns.adobe.com/xdm/channels/mobile-app"
respektive "https://ns.adobe.com/xdm/channel-types/mobile"
.
Nästa steg
Mer information om hur du hämtar Real-Time CDP-målgrupper från din Commerce-mobilapp för att informera om kundvagnsregler, dynamiska block och relaterade produktregler finns i Audience Activation.