Audience Activation

Die Audience Activation ermöglicht Ihnen die Aktivierung von Real-Time CDP-Zielgruppen in Adobe Commerce, um eindeutige Angebote im Warenkorb zu erstellen. Zu diesen Angeboten und Anreizen gehören gängige E-Commerce-Merchandising-Techniken wie Kauf 2 erhalten 1 gratis, Hero-Banner, die auf diesen Kunden ausgerichtet sind, und geänderte Produktpreise über verschiedene Angebote. Die in Real-Time CDP erstellten Zielgruppen basieren auf Daten aus verschiedenen Unternehmenssystemen, z. B. Enterprise Resource Planning (ERP), Customer Relationship Management (CRM), Point of Sale und Marketing-Systemen. Da Kundensegmentinformationen ständig aktualisiert werden, können Kunden beim Einkauf in Ihrem Geschäft mit einem Segment verknüpft und von diesem getrennt werden.

Sie können Zielgruppen in einer Luma-Storefront aktivieren oder Headless Storefront. In einer Luma-Storefront werden Zielgruppendaten (Segmentzugehörigkeit) in einem Cookie auf Commerce-Seite gespeichert. In einer Headless-Storefront werden Zielgruppendaten in der GraphQL-API-Kopfzeile als Parameter mit dem Namen übergeben: aep-segments-membership.

Versionshinweise

Dieser Abschnitt enthält Informationen zu Aktualisierungen der Audience Activation-Erweiterung und umfasst:

Neu - Neue Funktionen
Fehlerbehebung - Fehlerbehebungen und Verbesserungen
Fehler - Bekannte Probleme

Siehe Bevorstehende Versionen , um mehr über die Veröffentlichungszeitpläne und die Unterstützung zu erfahren.

Siehe die Entwicklerdokumentation zu Informationen zur Produktkompatibilität.

Unterstützte Dienstaktualisierungen

In diesen Versionshinweisen werden Funktionsänderungen und Fehlerbehebungen im Zusammenhang mit von Audience Activation verwendeten Erweiterungen beschrieben.

Unterstützte Dienstaktualisierungen

15. August 2023

Fehlerbehebung - Die Dashboard für Real-Time CDP-Zielgruppen zur Vereinfachung der Filterung.

27. Juni 2023

Fehlerbehebung - Unterstützung für PHP 8.2 im magento/module-data-services-graphql Paket.

30. Mai 2023

Neu - Die Dashboard für Real-Time CDP-Zielgruppen , um die Möglichkeit zur Sortierung, Suche und Filterung der aktiven Zielgruppen in Ihrer Adobe Commerce-Instanz einzuschließen.

2,2,0

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

12. Juni 2024

Neu - GA-Version für verwandte Produktregeln durch Zielgruppen informiert werden.

2.1.1

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

4. April 2024

Neu - Unterstützung für PHP 8.3 hinzugefügt.

2.2.0-beta1

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

16. Februar 2024

Neu - Wenn Sie an der Beta-Phase teilnehmen, stellen Sie sicher, dass Ihre composer.json -Datei hat Folgendes auf der Stammebene: "minimum-stability": "beta".
Neu - (Beta) Zusätzliche Funktion zum Erstellen verwandte Produktregeln durch Zielgruppen informiert werden.

2.1.0

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

24. Januar 2024

Neu - Die Dashboard für Real-Time CDP-Zielgruppen , um die Websites einzubeziehen, die die Zielgruppen enthalten, und anzugeben, welche dynamischen Bausteine und Warenkorbpreisregeln für die Verwendung dieser Zielgruppen konfiguriert sind.

2,0,1

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

16. November 2023

Fehlerbehebung - Verbesserung der Stabilität.

2,0,0

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

10. Oktober 2023

Neu - Unterstützung für OAuth 2.0 bei konfigurieren die Audience Activation-Erweiterung.
Fehlerbehebung - Verbesserung der Stabilität.

1,2,0

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

15. August 2023

Fehlerbehebung - Aktualisierung der Komponentenversion der Benutzeroberfläche.

1.1.0

30. Mai 2023

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

Neu - Unterstützung für dynamische Blöcke in einer Headless-Storefront.

1,0,1

11. Mai 2023

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

Fehlerbehebung - Es wurde ein Problem behoben, bei dem eine dynamische Block- oder Warenkorbpreisregel nicht auf die Storefront angewendet wurde.
Fehlerbehebung - Es wurde ein Problem behoben, bei dem eine nicht konfigurierte Installation der Audience Activation-Erweiterung einen Fehler verursachte, wenn ein Händler versuchte, einen dynamischen Block zu erstellen oder zu aktualisieren.

1,0,0

31. März 2023

[Kompatibilität]{class="badge informative" title="Kompatibilität"}

Neu - Allgemeine Verfügbarkeitsversion

Implementierung

Die folgenden Aufgaben gelten sowohl für die Implementierung von Luma als auch für die Implementierung von Headless-Storefront. Um Zielgruppen in Adobe Commerce zu aktivieren, müssen Sie:

  • Installieren Sie Adobe Commerce-Version 2.4.4 oder höher
  • Aktivieren Adobe Commerce als Ziel in Real-Time CDP
  • Installieren die Audience Activation Erweiterung in der Admin-Konsole
  • Konfigurieren die Audience Activation Erweiterung in der Admin-Konsole

Installieren der Erweiterung

Installieren Sie die Audience Activation -Erweiterung aus der Marketplaceoder führen Sie den folgenden Befehl aus:

composer require magento/audiences

Konfigurieren der Erweiterung

Nach der Installation Audience Activation müssen Sie sich bei Ihrem Commerce-Administrator anmelden und Folgendes ausführen:

  1. Im Admin Seitenleiste, navigieren Sie zu System > Services>Commerce Services Connector.

  2. Anmelden auf Ihr Adobe-Konto klicken und Ihre Organisations-ID auswählen.

  3. Im Admin Seitenleiste, navigieren Sie zu System > Services>Data Connection.

  4. Im Datastream ID -Feld die Kennung des von Ihnen erstellten Datastreams ein. enabled Adobe Commerce als Ziel in Real-Time CDP.

    Dieser Datastream sendet Daten von Ihrer Commerce-Website an Real-Time CDP, um festzustellen, ob ein Käufer zu einer Zielgruppe gehört. Wenn Sie noch keinen Datastream erstellt haben, erstellen eine in Experience Platform, add Sie zum Commerce-Ziel in Real-Time CDP und zum Data Connection -Erweiterung in Admin.

    note note
    NOTE
    Wenn Sie eine Datastream-ID angeben, müssen Sie Zuordnung zu einer bestimmten Website im Data Connection -Erweiterung. Wenn Ihr Commerce-Store über mehrere Websites verfügt, Ziel erstellen für jede Website in Real-Time CDP verwenden und jeweils eine andere Datastream-ID verwenden.
  5. Im Admin Seitenleiste, navigieren Sie zu Stores > Settings>Configuration.

  6. Erweitern Services und wählen Data Connection.

  7. Hinzufügen Dienstkonto und Anmeldedaten.

Verwendung von Real-Time CDP-Zielgruppen in Commerce

Mit dem Audience Activation -Erweiterung aktiviert haben, können Sie:

TIP
Für einen vollständigen durchgängigen Anwendungsfall zum Exportieren Commerce Daten an Real-Time CDP übermitteln, eine Zielgruppe erstellen und diese Zielgruppe dann für Commerce, siehe Erstellen einer Zielgruppe in Real-Time CDP mithilfe von Commerce Ereignisdaten.

Dashboard für Real-Time CDP-Zielgruppen

Alle active Zielgruppen, die in Ihrer Adobe Commerce-Instanz mithilfe der Real-Time CDP-Zielgruppen Dashboard.

So greifen Sie auf die Real-Time CDP-Zielgruppen Dashboard, navigieren Sie zum Admin Seitenleiste, dann zu Customers > Real-time CDP Audience.

Dashboard für Real-Time CDP-Zielgruppen

Das Dashboard enthält die folgenden Felder:

Spalte
Beschreibung
Hide filters
Ermöglicht das Anzeigen oder Verbergen von Filtern, die Sie auf das Dashboard anwenden können. Derzeit ist der einzige Filter, den Sie anwenden können Last updated. Mit diesem Filter können Sie einen Datumsbereich für Zielgruppen auswählen, basierend auf dem Zeitpunkt der letzten Aktualisierung.
Search
Ermöglicht die Suche nach aktiven Zielgruppen in Ihrer Commerce-Instanz.
Name
Name der Audience in Real-Time CDP.
Origin
Gibt an, woher die Zielgruppe stammt, beispielsweise Experience Platform.
Websites
Gibt an, welche Websites für die Verwendung der Zielgruppen konfiguriert sind.
Dynamic Blocks
Gibt an, welche dynamischen Blöcke für die Verwendung der Zielgruppen konfiguriert sind.
Cart Price Rules
Gibt an, welche Regeln für den Warenkorbpreis für die Verwendung der Zielgruppen konfiguriert sind.
Related Product Rules
Gibt an, welche verwandten Produktregeln für die Verwendung der Zielgruppen konfiguriert sind.
Last updated
Gibt an, wann die Zielgruppe in Real-Time CDP geändert wurde.
Sync now
Ruft neue oder aktualisierte Zielgruppen aus Real-Time CDP ab.
Customize table
Ermöglicht das Anzeigen oder Verbergen der Origin, Websites, Dynamic Blocks, Cart Price Rules, und Last updated Spalten.

Headless-Unterstützung

Sie können Zielgruppen in einer Headless-Adobe Commerce-Instanz aktivieren, z. B. AEM und PWA, um Warenkorbpreisregeln, zugehörige Produktregeln oder dynamische Bausteine basierend auf den Zielgruppen anzuzeigen.

Preisregeln für Warenkorb und zugehörige Produktregeln

Bei Warenkorbpreisregeln und damit zusammenhängenden Produktregeln kommuniziert eine Headless-Storefront über die Commerce integration framework (CIF). Das Framework stellt eine serverseitige API bereit, die mithilfe von GraphQL implementiert wird. Zielgruppendaten wie das Segment eines Käufers werden über einen GraphQL-Header-Parameter mit dem Namen an Commerce übergeben: aep-segments-membership.

Die Gesamtarchitektur sieht wie folgt aus:

Senden von Daten von Headless-Storefront an Backend

Nach install und konfigurieren In der -Erweiterung enthält das Experience Platform Web SDK die Zielgruppeninformationen in Form einer Segmentmitgliedschaft.

Informationen zum Erfassen dieser Segmentmitgliedschaften vom SDK finden Sie in diesem Codeausschnitt.

Nachdem sie abgerufen wurde, können Sie diese Segmente im GraphQL-Header an Commerce übergeben. Beispiel:

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 Blöcke

Bei dynamischen Bausteinen: GraphQL dynamicBlocks -Abfragen können audience_id Eingabeattribut. Wenn Sie eine oder mehrere audience_id Werte in einer dynamicBlocks -Abfrage eine Liste mit dynamischen Bausteinen zurückgibt, die diesen Zielgruppen zugewiesen sind.

Beispielverwendung

Die folgende Abfrage gibt alle dynamischen Blöcke zurück, die mit mehreren Zielgruppen-IDs verknüpft sind.

Anfrage:

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

Antwort:

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

Weitere Informationen zum dynamicBlocks GraphQL-Abfrage im Entwicklerdokumentation.

Abrufen von Zielgruppen mit dem Adobe Experience Platform Mobile SDK

Sie können Real-Time CDP-Zielgruppen mit dem Adobe Experience Platform Mobile SDK abrufen.

IMPORTANT
Das Adobe Experience Platform Mobile SDK für iOS unterstützt iOS 11 oder höher.

Nachdem Sie die Konfiguration abgeschlossen haben, verwenden Sie mobile SDK-Vorgänge zum Abrufen der Zielgruppendaten. Beispiel:

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

Nachdem die Daten abgerufen wurden, können Sie sie verwenden, um zielgruppeninformierte Warenkorbpreisregeln, dynamische Blöcke und verwandte Produktregeln in der Commerce-App.

Zielgruppen werden nicht in Commerce angezeigt

Wenn Real-Time CDP-Zielgruppen nicht in Commerce angezeigt werden, kann dies folgende Gründe haben:

  • Falscher Authentifizierungstyp, der in der Datenverbindung Konfigurationsseite
  • Unzureichende Berechtigungen für generiertes Token

In den folgenden beiden Abschnitten wird beschrieben, wie Sie in beiden Fällen eine Fehlerbehebung durchführen.

Falscher Authentifizierungstyp in der Konfiguration ausgewählt

  1. Öffnen Sie Ihre Commerce-Instanz.
  2. Im Admin Seitenleiste, navigieren Sie zu Stores > Settings>Configuration.
  3. Erweitern Services und wählen Data Connection.
  4. Stellen Sie sicher, dass die von Ihnen in der Variablen Authentication Type korrekt ist. Adobe empfiehlt, OAuth. JWT ist veraltet. Weitere Infos.

Unzureichende Berechtigungen für generiertes Token

Dieses Problem kann durch unzureichende API-Berechtigungen für das generierte Token verursacht werden. So stellen Sie sicher, dass das Token über die richtigen Berechtigungen verfügt:

  1. Identifizieren Sie den Systemadministrator für Adobe Experience Platform in Ihrem Unternehmen.
  2. Suchen Sie das Projekt und die Anmeldeinformationen, die Sie verwenden werden.
  3. Geben Sie die E-Mail-Adresse des technischen Kontos an, z. B.: fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com.
  4. Lassen Sie den Systemadministrator Adobe Experience Platform starten und navigieren Sie zu Permissions -> Users -> API credentials.
  5. Suchen Sie mithilfe der E-Mail-Adresse des technischen Kontos oben nach den zu ändernden Anmeldeinformationen.
  6. Öffnen Sie die Anmeldeinformationen und wählen Sie Roles -> Add roles.
  7. Hinzufügen der Rolle, die Manage destinations -Berechtigung.
  8. Klicks Save.
  9. Regenerieren das Zugriffstoken in der Konsole.
  10. Stellen Sie sicher, dass das Token eine gültige Antwort mit der Target-Verbindungs-API.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c