Audience Activation

Med tillägget Audience Activation kan du aktivera Real-Time CDP-målgrupper i Adobe Commerce för att skapa unika erbjudanden i kundvagnen. Erbjudandena och incitamenten omfattar vanliga tekniker för e-handel, som köp 2 få 1 kostnadsfritt, hjältebanners som är inriktade på den kunden och ändrade produktpriser genom olika erbjudanden. De målgrupper som byggs inom Real-Time CDP bygger på data från olika affärssystem, t.ex. ERP (Enterprise Resource Planning), CRM (Customer Relationship Management), försäljningsställen och marknadsföringssystem. Eftersom kundsegmentsinformationen uppdateras kontinuerligt kan kunderna associeras och kopplas bort från ett segment när de handlar i din butik.

Du kan aktivera målgrupper i en Luma storefront eller headless store. I en Lumabutik lagras målgruppsinformation (segmentmedlemskap) i en cookie på Commerce-sidan. I ett headless-lager skickas målgruppsinformation i GraphQL API-huvudet som en parameter med namnet: aep-segments-membership.

Versionsinformation

Det här avsnittet innehåller information om uppdateringar av tillägget Audience Activation och innehåller:

- Nya funktioner
- Korrigeringar och förbättringar
- Kända fel

Läs Kommande releaser om du vill veta mer om releasescheman och support.

Läs utvecklardokumentationen för att lära dig mer om produktkompatibilitet.

Uppdateringar av tjänster som stöds

I versionsinformationen beskrivs funktionsändringar och korrigeringar för tillägg som används av Audience Activation.

2.3.1

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

12 november 2024

- Ett fel har korrigerats vid filtrering av tillgängliga Real-Time CDP-målgrupper att välja bland.

2.3.0

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

29 juli 2024

- Kommandoradssyntax har lagts till så att du kan testa autentiseringsuppgifter för att avgöra om de behöver uppdateras för att hämta målgruppsdata från Adobe Experience Platform.

2.2.0

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

12 juni 2024

- GA-version för relaterade produktregler informerad av målgrupper.

2.1.1

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

4 april 2024

- Stöd för PHP 8.3 har lagts till.

2.2.0-beta1

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

16 februari 2024

- Om du deltar i betaversionen kontrollerar du att composer.json-filen har följande på rotnivån: "minimum-stability": "beta".
- (Beta) Lagt till möjlighet att skapa relaterade produktregler som har informerats av målgrupper.

2.1.0

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

24 januari 2024

- Kontrollpanelen Real-Time CDP Audiences har uppdaterats för att inkludera de webbplatser som innehåller målgrupperna och ange vilka dynamiska block och kundprisregler som har konfigurerats för att använda dessa målgrupper.

2.0.1

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

16 november 2023

- Förbättrad stabilitet.

2.0.0

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

10 oktober 2023

- Stöd för OAuth 2.0 har lagts till när du konfigurerar tillägget Audience Activation.
- Förbättrad stabilitet.

1.2.0

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

15 augusti 2023

- Uppdaterade UI-komponentens version.

1.1.0

30 maj 2023

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

- Stöd för dynamiska block har lagts till i en headless-butik.

1.0.1

11 maj 2023

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

- Ett problem har korrigerats där en dynamisk spärr- eller kundvagnsprisregel inte tillämpades på butiken.
- Ett problem har korrigerats där en okonfigurerad installation av tillägget Audience Activation orsakade ett fel när en handlare försökte skapa eller uppdatera ett dynamiskt block.

1.0.0

31 mars 2023

[Kompatibilitet]{class="badge informative" title="Kompatibilitet"}

- allmän tillgänglighetsrelease

Implementering

Följande uppgifter gäller både Luma-implementeringar och implementeringar utan headless storefront. Om du vill aktivera målgrupper i Adobe Commerce måste du:

Installera tillägget

Installera tillägget Audience Activation från Marketplace eller kör följande kommando:

composer require magento/audiences

Konfigurera tillägget

När du har installerat tillägget Audience Activation måste du logga in i Commerce Admin och slutföra följande:

Var kan man använda Real-Time CDP målgrupper i Commerce?

När tillägget Audience Activation är aktiverat kan du:

Real-Time CDP målgruppspanel

Du kan visa alla aktiva målgrupper som är tillgängliga för anpassning i din Adobe Commerce-instans med kontrollpanelen Real-Time CDP-målgrupper.

Gå till sidofältet Admin och gå till Customers > Real-time CDP Audience för att komma åt kontrollpanelen Real-Time CDP Audiences.

{width="700" modal="regular"}

Kontrollpanelen innehåller följande fält:

Headless-support

Du kan aktivera målgrupper i en headless Adobe Commerce-instans, som AEM och PWA, för att visa kundprisregler, relaterade produktregler eller dynamiska block baserade på målgrupperna.

Kundprisregler och relaterade produktregler

För kundvagnsprisregler och relaterade produktregler kommunicerar en headless Store till Experience Platform via Commerce integrationa frameworken (CIF). Ramverket innehåller ett API på serversidan som implementeras med GraphQL. Målgruppsinformation, till exempel en kunds segment, skickas till Commerce via en GraphQL-huvudparameter med namnet aep-segments-membership.

Den övergripande arkitekturen är följande:

{width="700" modal="regular"}

När du har installerat och konfigurerat tillägget innehåller Experience Platform Web SDK målgruppsinformation i form av segmentmedlemskap.

Information om hur du fångar dessa segmentmedlemskap från SDK finns i det här kodfragmentet.

När segmenten har hämtats kan du skicka dem till Commerce i GraphQL sidhuvud. Exempel:

curl 'http://magento.config/graphql' -H 'Authorization: Bearer abc123' -H 'aep-segments-membership: urlencoded_list_of_segments' -H 'Content-Type: application/json' --data-binary '{"query":"query {\ncustomer {\nfirstname\nlastname\nemail\n}\n}"}'

Dynamiska block

För dynamiska block kan GraphQL dynamicBlocks-frågor innehålla indataattributet audience_id. Om du anger ett eller flera audience_id-värden i en dynamicBlocks-fråga returneras en lista med dynamiska block som tilldelats dessa målgrupper.

Exempel på användning

Följande fråga returnerar alla dynamiska block som är associerade med flera målgrupps-ID:n.

Begäran:

{
  dynamicBlocks(input:
  {
    type: SPECIFIED
    audience_id: {
      in: [
        "cd29a789-9be8-40ad-a1ef-640c33b3742e"
        "92c3e14d-c72b-40d0-96b7-b96801dcc135"
      ]
    }
  })
  {
    items {
      uid
      audience_id
      content {
        html
      }
    }
    page_info {
      current_page
      page_size
      total_pages
    }
    total_count
  }
}

Svar:

{
  "data": {
    "dynamicBlocks": {
      "items": [
        {
          "uid": "MQ==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e"
          ],
          "content": {
            "html": "<h2><strong>SAVE 20%</strong></h2>\r\n<p>(some restrictions apply)</p>\r\n<p>&nbsp;</p>"
          }
        },
        {
          "uid": "Mg==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e",
            "92c3e14d-c72b-40d0-96b7-b96801dcc135"
          ],
          "content": {
            "html": "<p><img src=\"{{media url=&quot;wysiwyg/save20.png&quot;}}\" alt=\"save 20% red\"></p>"
          }
        }
      ],
      "page_info": {
        "current_page": 1,
        "page_size": 20,
        "total_pages": 1
      },
      "total_count": 2
    }
  }
}

Läs mer om GraphQL-frågan dynamicBlocks i utvecklardokumentationen.

Hämta målgrupper med Adobe Experience Platform Mobile SDK

Du kan hämta Real-Time CDP-målgrupper med Adobe Experience Platform Mobile SDK.

När du är klar med konfigurationen kan du använda SDK-åtgärder för mobilen för att hämta målgruppsdata. Exempel:

Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
    for handle in handles {
        if handle.type == "activation:pull" {
        let payloadItems = handle.payload ?? []
            for payloadItem in payloadItems {
                if let segments = payloadItem["segments"] as? any Sequence {
                    var segmentsArr = [Any]()
                    for segment in segments {
                        let response = segment as AnyObject?
                        segmentsArr.append(response?.object(forKey: "id")! ?? "")
                    }
                    print("Saving segments ->  \(segments)")
                    storage.set(segmentsArr, forKey: "segments")
                    print("End saving segments")
                }

                // Show segments
                let rSegments = storage.object(forKey: "segments") ?? nil;
                print("Retrieving segments -> \(rSegments)")
            }
        }
    }
}

När data har hämtats kan du använda den för att skapa kundorienterade kundprisregler, dynamiska block och relaterade produktregler i Commerce-appen.

Målgrupper visas inte i Commerce

Om Real-Time CDP-målgrupper inte visas i Commerce kan det bero på:

I följande avsnitt beskrivs hur du felsöker dessa problem.

Validera anslutningen

Kör följande kommando för att validera inloggningsuppgifterna och svaret från Adobe Experience Platform:

bin/magento audiences:config:status

Det här kommandot returnerar anslutningsstatusen. Lägg till flaggan -v om du vill ha mer utförlig information:

./bin/magento audiences:config:status -v

Exempel:

+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| Client ID                        | Client secret | Technical account ID                        | Technical account email                                 | Sandbox name |
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 1234bd57fac8497d8933327c535347d8 | *****         | 12341E116638D6B00A495C80@techacct.adobe.com | 12345-b95b-4894-a41c-a4130d26bd80@techacct.adobe.com | dev          |

Felaktig autentiseringstyp har valts i konfigurationen

Otillräckliga privilegier för genererad token

Problemet kan bero på otillräcklig API-behörighet för den genererade token. Så här ser du till att din token har rätt behörigheter: