[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Audience Activation

Met de extensie Audience Activation kunt u het Real-Time CDP-publiek in Adobe Commerce activeren en unieke aanbiedingen in het winkelwagentje maken. Deze aanbiedingen en de prikkels omvatten gemeenschappelijke e-handel die technieken, zoals koopt 2 krijgt 1 vrije, heldenbanners die op die klant worden gericht, en gewijzigde productprijs door diverse aanbiedingen. Het publiek dat in Real-Time CDP is samengesteld, is gebaseerd op gegevens van verschillende bedrijfssystemen, zoals Enterprise Resource Planning (ERP), Customer Relationship Management (CRM), verkooppunten en marketingsystemen. Omdat de informatie van het klantensegment constant wordt verfrist, kunnen de klanten van een segment worden geassocieerd en worden losgemaakt aangezien zij in uw opslag winkelen.

U kunt publiek in een Luma storefront of ​ zonder kop ​ storefront activeren. In een Luma-winkel wordt de publieksinformatie (segmentlidmaatschap) opgeslagen in een cookie aan de Commerce-zijde. In een koploze winkel wordt publieksinformatie doorgegeven in de GraphQL API-header als een parameter met de naam: aep-segments-membership .

Opmerkingen bij de release

Deze sectie bevat informatie over updates voor de Audience Activation-extensie en bevat:

- Nieuwe eigenschappen
- Oplossingen en verbeteringen
- Bekende kwesties

Zie ​ Komende Versies ​ om over versieschema's en steun te leren.

Zie de ontwikkelaarsdocumentatie aan ​ over productverenigbaarheid ​ leren.

Ondersteunde service-updates

In deze releaseopmerkingen worden wijzigingen in functies en correcties beschreven die betrekking hebben op extensies die door Audience Activation worden gebruikt.

2.4.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

Maart 24, 2025

- Toegevoegde PHP 8.4 steun.

2.3.1.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

12 November, 2024

- Vloeiende een kwestie wanneer het filtreren van de beschikbare publiek van Real-Time CDP om te kiezen van.

2.3.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

29 juli, 2024

- toegevoegde bevel-lijn syntaxis zodat kunt u ​ geloofsbrieven ​ testen om te bepalen als zij moeten worden bijgewerkt om publieksgegevens van Adobe Experience Platform te trekken.

2.2.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

12 Juni, 2024

- de versie van GA voor ​ verwante productregels ​ die door publiek worden geïnformeerd.

2.1.1.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

4 April, 2024

- Toegevoegde steun voor PHP 8.3.

2.2.0-bèta1

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

16 februari 2024

- als u aan bèta deelneemt, zorg ervoor uw composer.json dossier het volgende op het wortelniveau heeft: "minimum-stability": "beta".
- (Beta) toegevoegde capaciteit om ​ verwante productregels ​ tot stand te brengen die door publiek worden geïnformeerd.

2.1.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

Januari 24, 2024

- Bijgewerkt het ​ dashboard van het Soorten Soorten publiek van Real-Time CDP ​ om de websites te omvatten die het publiek bevatten en specificeren welke dynamische blokken en de regels van de kartprijs worden gevormd om die soorten publiek te gebruiken.

2.0.1.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

16 november 2023

- Verbeterde stabiliteit.

2.0.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

10 oktober, 2023

- Toegevoegde steun voor OAuth 2.0 wanneer u ​ ​ de uitbreiding van Audience Activation vormt.
- Verbeterde stabiliteit.

1.2.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

Augustus 15, 2023

- werkte de UI componentenversie bij.

1.1.0.

30 Mei, 2023

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

- Toegevoegde steun voor ​ dynamische blokken ​ in een headless storefront.

1.0.1.

Mei 11, 2023

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

- Vaste een kwestie waar een dynamisch blok of de regel van de kartprijs niet op de storefront werd toegepast.
- Vloedigde een kwestie waar een niet gevormde installatie van de uitbreiding van Audience Activation een fout veroorzaakte wanneer een handelaar probeerde om een dynamisch blok tot stand te brengen of bij te werken.

1.0.0.

Maart 31, 2023

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"} versies van Adobe Commerce 2.4.4 en nieuwer

- Algemene beschikbaarheidsversie

Implementatie

De volgende taken zijn van toepassing op zowel de uitvoeringen van het Luma als van het hoofdloze winkelcentrum. Als u het publiek in Adobe Commerce wilt activeren, moet u:

De extensie installeren

Installeer de Audience Activation uitbreiding van ​ marktPlace ​, of stel het volgende bevel in werking:

composer require magento/audiences

De extensie configureren

Nadat u de extensie Audience Activation hebt geïnstalleerd, moet u zich aanmelden bij uw Commerce-beheerder en het volgende invullen:

Waar kan het Real-Time CDP-publiek in Commerce worden gebruikt?

Als de extensie Audience Activation is ingeschakeld, kunt u:

Real-Time CDP-doeldashboard

U kunt alle ​ actieve ​ publiek bekijken dat beschikbaar is om binnen uw instantie van Adobe Commerce te personaliseren gebruikend het 3} dashboard van het Soorten publiek van Real-Time CDP {.

Om tot het publiek van Real-Time CDP dashboard toegang te hebben, ga naar Admin sidebar, dan ga Customers > Real-time CDP Audience.

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

Het dashboard bevat de volgende velden:

Hoofdondersteuning

U kunt het publiek in een Adobe Commerce-instantie zonder kop, zoals AEM en PWA, activeren om regels voor de winkelwagenprijs, verwante productregels of dynamische blokken weer te geven die zijn gebaseerd op het publiek.

Cart price rules and related product rules

Voor de regels van de kartprijs en verwante productregels, communiceert een koploze winkel aan Experience Platform door ​ Commerce integration framework (CIF) ​. Het framework biedt een server-side API die met GraphQL is geïmplementeerd. Publiek-informatie, zoals het segment van een klant, gaat naar Commerce via een GraphQL-headerparameter genaamd: aep-segments-membership .

De architectuur ziet er als volgt uit:

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

Nadat u ​ ​ installeert en ​ ​ de uitbreiding vormt, bevat het Web SDK van Experience Platform de publieksinformatie in de vorm van segmentlidmaatschap.

Om die segmentlidmaatschap van SDK te vangen, zie dit ​ codefragment ​.

Nadat u de segmenten hebt opgehaald, kunt u deze in de GraphQL-koptekst doorgeven aan Commerce. Bijvoorbeeld:

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}"}'

Dynamische blokken

Voor dynamische blokken kunnen GraphQL dynamicBlocks -query's het invoerkenmerk audience_id bevatten. Als u een of meer audience_id -waarden opgeeft in een dynamicBlocks -query, wordt een lijst met dynamische blokken geretourneerd die aan dat publiek zijn toegewezen.

Voorbeeldgebruik

De volgende vraag keert alle dynamische blokken verbonden aan veelvoudige publiek IDs terug.

Verzoek:

{
  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
  }
}

Reactie:

{
  "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
    }
  }
}

Leer meer over de dynamicBlocks vraag van GraphQL in de ​ ontwikkelaardocumentatie ​.

Soorten publiek ophalen met de Adobe Experience Platform Mobile SDK

U kunt het Real-Time CDP-publiek ophalen met de Adobe Experience Platform Mobile SDK.

Nadat u de configuratie hebt voltooid, gebruikt u mobiele SDK-bewerkingen om de publieksgegevens op te halen. Bijvoorbeeld:

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)")
            }
        }
    }
}

Nadat het gegeven wordt teruggewonnen, kunt u het gebruiken om publiek-geïnformeerde ​ regels van de wortelprijs ​ tot stand te brengen, ​ dynamische blokken ​ en ​ verwante productregels ​ in Commerce app.

Soorten publiek wordt niet weergegeven in Commerce

Als Real-Time CDP-publiek niet wordt weergegeven in Commerce, kan dit worden veroorzaakt door:

In de volgende secties wordt beschreven hoe u deze problemen kunt oplossen.

De verbinding valideren

Voer de volgende opdracht uit om de referenties en het antwoord van Adobe Experience Platform te valideren:

bin/magento audiences:config:status

Dit bevel keert de verbindingsstatus terug. Voeg de markering -v toe voor extra breedtegraad:

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

Bijvoorbeeld:

+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 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          |

Onjuist verificatietype geselecteerd in configuratie

Onvoldoende rechten voor gegenereerd token

Dit probleem kan worden veroorzaakt door onvoldoende API-bevoegdheden voor het gegenereerde token. Om ervoor te zorgen dat het token de juiste rechten heeft: