Audience Activation

De Audience Activation Met deze extensie kunt u Real-Time CDP-publiek in Adobe Commerce activeren om unieke aanbiedingen in de winkelwagen te maken. Deze aanbiedingen en prikkels omvatten gemeenschappelijke technieken voor elektronische handel, zoals koop 2 krijg 1 gratis, hoofdbanners gericht op die klant, en gewijzigde productprijzen 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 een publiek activeren in een Luma-winkel of krankzinnig storefront. In een Luma-winkel wordt de publieksinformatie (segmentlidmaatschap) opgeslagen in een cookie aan de Commerce-zijde. In een koploze winkel wordt de 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 functies
- Oplossingen en verbeteringen
- Bekende problemen

Zie Volgende releases om over versieschema's en steun te leren.

Zie de documentatie voor ontwikkelaars op informatie over productcompatibiliteit.

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

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

4 april 2024

- Toegevoegde ondersteuning voor PHP 8.3.

2.2.0-bèta1

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

16 februari 2024

- Als u deelneemt aan de bètaversie, zorg er dan voor dat u composer.json bestand heeft het volgende op hoofdniveau: "minimum-stability": "beta".
- (Beta) Toegevoegde mogelijkheid om te maken verwante productregels door het publiek geïnformeerd.

2.1.0.

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

24 januari 2024

- De Real-Time CDP-dashboard Soorten publiek de websites met het publiek op te nemen en te specificeren welke dynamische blokken en regels voor de kartprijs zijn geconfigureerd om dat publiek te gebruiken.

2.0.1.

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

16 november 2023

- Verbeterde stabiliteit.

2.0.0.

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

10 oktober 2023

- Toegevoegde ondersteuning voor OAuth 2.0 wanneer u vormen de extensie Audience Activation.
- Verbeterde stabiliteit.

1.2.0.

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

15 augustus 2023

- De versie van de UI-componenten is bijgewerkt.

1.1.0.

30 mei 2023

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

- Toegevoegde ondersteuning voor dynamische blokken in een koploze winkel.

1.0.1.

11 mei 2023

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

- Probleem verholpen waarbij een dynamisch blok- of winkelprijscriterium niet werd toegepast.
- Probleem verholpen waarbij een niet-geconfigureerde installatie van de extensie Audience Activation een fout veroorzaakte wanneer een handelaar probeerde een dynamisch blok te maken of bij te werken.

1.0.0.

31 maart 2023

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

- Algemene beschikbaarheidsrelease

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 van de marktplaatsof voer de volgende opdracht uit:

composer require magento/audiences

De extensie configureren

Nadat u de Audience Activation -extensie, dient u zich aan te melden bij uw Commerce Admin en het volgende in te vullen:

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

Met de Audience Activation extensie ingeschakeld, kunt u:

Voor een volledige gebruiksscenario van begin tot eind over hoe te om uit te voeren Commerce gegevens naar Real-Time CDP, maak een publiek en activeer dat publiek vervolgens naar Commerce, zie Een publiek maken in Real-Time CDP met Commerce gebeurtenisgegevens.

Real-Time CDP-doeldashboard

U kunt alle actief publiek dat binnen uw Adobe Commerce-instantie kan worden gepersonaliseerd met behulp van de Real-Time CDP-publiek dashboard.

Als u toegang wilt krijgen tot Real-Time CDP-publiek dashboard, ga naar Beheerder zijbalk, ga vervolgens naar 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 betreffende de kartprijs en de desbetreffende productregels geeft een koploze winkel het Experience Platform via de Commerce integration framework (CIF). Het framework biedt een server-side API die met GraphQL is geïmplementeerd. De informatie van het publiek, zoals het segment van een verkoopster, gaat tot Commerce door een kopbalparameter van GraphQL genoemd over: aep-segments-membership.

De architectuur ziet er als volgt uit:

Na u installeren en vormen Voor de uitbreiding, bevat het Web SDK van het Experience Platform de publieksinformatie in de vorm van segmentlidmaatschap.

Om die segmentlidmaatschappen 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, GraphQL dynamicBlocks query's kunnen de audience_id invoerkenmerk. Als u een of meer audience_id waarden in a dynamicBlocks query, geeft het een lijst met dynamische blokken 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
    }
  }
}

Meer informatie over de dynamicBlocks GraphQL-query in het dialoogvenster ontwikkelaarsdocumentatie.

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 de gegevens zijn opgehaald, kunt u deze gebruiken om op de doelgroep gebaseerde gegevens te maken regels betreffende de kartonprijs, dynamische blokken en verwante productregels in de Commerce-app.

Soorten publiek wordt niet weergegeven in Commerce

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

De volgende twee secties beschrijven hoe te om één van beide geval problemen op te lossen.

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: