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:

Nieuw - Nieuwe functies
Repareren - Oplossingen en verbeteringen
Bug - 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.

Ondersteunde service-updates

15 augustus 2023

Repareren - De Real-Time CDP-dashboard Soorten publiek om het filteren te vereenvoudigen.

27 juni 2023

Repareren - Toegevoegde ondersteuning voor PHP 8.2 in de magento/module-data-services-graphql pakket.

30 mei 2023

Nieuw - De Real-Time CDP-dashboard Soorten publiek om het actieve publiek in uw Adobe Commerce-instantie te sorteren, te zoeken en te filteren.

2.2.0.

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

12 juni 2024

Nieuw - GA-release voor verwante productregels door het publiek geïnformeerd.

2.1.1.

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

4 april 2024

Nieuw - Toegevoegde ondersteuning voor PHP 8.3.

2.2.0-bèta1

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

16 februari 2024

Nieuw - Als u deelneemt aan de bètaversie, zorg er dan voor dat u composer.json bestand heeft het volgende op hoofdniveau: "minimum-stability": "beta".
Nieuw - (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

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

Repareren - Verbeterde stabiliteit.

2.0.0.

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

10 oktober 2023

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

1.2.0.

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

15 augustus 2023

Repareren - De versie van de UI-componenten is bijgewerkt.

1.1.0.

30 mei 2023

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

Nieuw - Toegevoegde ondersteuning voor dynamische blokken in een koploze winkel.

1.0.1.

11 mei 2023

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

Repareren - Probleem verholpen waarbij een dynamisch blok- of winkelprijscriterium niet werd toegepast.
Repareren - 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"}

Nieuw - 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:

  • Adobe Commerce versie 2.4.4 of hoger installeren
  • Activeren Adobe Commerce als bestemming in Real-Time CDP
  • Installeren de Audience Activation extensie in Admin
  • Configureren de Audience Activation extensie in Admin

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:

  1. Op de Beheerder zijbalk, ga naar System > Services>Commerce Services Connector.

  2. Aanmelden naar uw Adobe-account en selecteer uw organisatie-id.

  3. Op de Beheerder zijbalk, ga naar System > Services>Data Connection.

  4. In de Datastream ID veld, plak de id van de gegevensstroom die u hebt gemaakt toen u geactiveerd Adobe Commerce als bestemming in Real-Time CDP.

    Deze gegevensstroom verzendt gegevens van uw Commerce-website naar Real-Time CDP om te bepalen of een klant tot een publiek behoort. Als u nog geen gegevensstroom hebt gemaakt, maken één in Experience Platform, toevoegen het naar de bestemming Commerce in Real-Time CDP en naar de Data Connection extensie in het beheerprogramma.

    note note
    NOTE
    Wanneer u een gegevensstroom-id opgeeft, kunt u koppelen aan een specifieke website in de Data Connection extensie. Als uw Commerce-winkel meerdere websites heeft, een doel maken voor elke website in Real-Time CDP en gebruik voor elke website een andere gegevensstroom-id.
  5. Op de Beheerder zijbalk, ga naar Stores > Settings>Configuration.

  6. Uitbreiden Services en selecteert u Data Connection.

  7. Toevoegen serviceaccount en referentiedetails.

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

Met de Audience Activation extensie ingeschakeld, kunt u:

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

Real-Time CDP-dashboard Soorten publiek

Het dashboard bevat de volgende velden:

Kolom
Beschrijving
Hide filters
Hiermee kunt u alle filters tonen of verbergen die u op het dashboard kunt toepassen. U kunt momenteel alleen het filter toepassen Last updated. Met dit filter kunt u een datumbereik voor soorten publiek selecteren op basis van het tijdstip waarop ze voor het laatst zijn bijgewerkt.
Search
Hiermee kunt u zoeken naar actief publiek in uw Commerce-exemplaar.
Name
Naam gegeven aan het publiek in Real-Time CDP.
Origin
Geeft aan waar het publiek vandaan komt, zoals Experience Platform.
Websites
Geeft aan welke websites zijn geconfigureerd om het publiek te gebruiken.
Dynamic Blocks
Geeft aan welke dynamische blokken zijn geconfigureerd om het publiek te gebruiken.
Cart Price Rules
Geeft aan welke regels voor de winkelwagenprijs zijn geconfigureerd om het publiek te gebruiken.
Related Product Rules
Geeft aan welke gerelateerde productregels zijn geconfigureerd om het publiek te gebruiken.
Last updated
Geeft aan wanneer het publiek is gewijzigd in Real-Time CDP.
Sync now
Hiermee haalt u nieuwe of bijgewerkte soorten publiek op uit Real-Time CDP.
Customize table
Hiermee kunt u de Origin, Websites, Dynamic Blocks, Cart Price Rules, en Last updated kolommen.

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.

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:

Gegevens verzenden van Headless Storefront naar Backend

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.

IMPORTANT
De Adobe Experience Platform Mobile SDK voor iOS ondersteunt iOS 11 of hoger.

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:

  • Onjuist verificatietype geselecteerd in het dialoogvenster Gegevensverbinding configuratiepagina
  • Onvoldoende rechten voor gegenereerd token

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

Onjuist verificatietype geselecteerd in configuratie

  1. Open uw Commerce-exemplaar.
  2. Op de Beheerder zijbalk, ga naar Stores > Settings>Configuration.
  3. Uitbreiden Services en selecteert u Data Connection.
  4. Verzeker de server-aan-server vergunningsmethode die u in specificeerde Authentication Type is correct. Adobe raadt u aan OAuth. JWT is vervangen. Meer informatie.

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:

  1. Identificeer de systeembeheerder voor Adobe Experience Platform in uw organisatie.
  2. Zoek het project en de geloofsbrieven die u zult gebruiken.
  3. Identificeer de e-mail van de technische rekening, bijvoorbeeld: fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com.
  4. Laat de systeembeheerder Adobe Experience Platform starten en ga naar Permissions -> Users -> API credentials.
  5. Zoek met behulp van de e-mail over de technische account van boven naar de referenties die u wilt wijzigen.
  6. Open de referenties en selecteer Roles -> Add roles.
  7. De rol toevoegen die Manage destinations toestemming.
  8. Klik op Save.
  9. Regenereren het toegangstoken in Console.
  10. Controleer of het token een geldige reactie biedt met de functie API voor doelverbindingen.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c