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 kopstorefront 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 extensie Audience Activation en bevat:

- Nieuwe eigenschappen
- Oplossingen en verbeteringen
- Bekende kwesties

Zie Komende Versiesom over versieschema's en steun te leren.

Zie de ontwikkelaarsdocumentatie aan over productverenigbaarheidleren.

Ondersteunde service-updates

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

2.3.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

29 juli, 2024

- toegevoegde bevel-lijn syntaxis zodat kunt u geloofsbrieventesten 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"}

12 Juni, 2024

- de versie van GA voor verwante productregelsdie door publiek worden geïnformeerd.

2.1.1.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

4 April, 2024

- Toegevoegde steun voor PHP 8.3.

2.2.0-bèta1

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

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 productregelstot stand te brengen die door publiek worden geïnformeerd.

2.1.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

Januari 24, 2024

- Bijgewerkt het dashboard van het Soorten Soorten publiek van Real-Time CDPom 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"}

16 november 2023

- Verbeterde stabiliteit.

2.0.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

10 oktober, 2023

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

1.2.0.

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

Augustus 15, 2023

- werkte de UI componentenversie bij.

1.1.0.

30 Mei, 2023

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

- Toegevoegde steun voor dynamische blokkenin een headless storefront.

1.0.1.

Mei 11, 2023

[​ Verenigbaarheid ​]{class="badge informative" title="Compatibiliteit"}

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

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

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 headless storefront aan het Experience Platform door het 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:

Nadat u 🔗 installeert en 🔗 de uitbreiding vormt, bevat het Web SDK van het 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 een 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 wortelprijstot stand te brengen, dynamische blokkenen verwante productregelsin 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: