Audience Activation

Mit der Erweiterung Audience Activation können Sie Real-Time CDP-Zielgruppen in Adobe Commerce aktivieren, um eindeutige Angebote im Warenkorb zu erstellen. Zu diesen Angeboten und Anreizen gehören gängige E-Commerce-Merchandising-Techniken, wie z. B. Kauf 2 erhält 1 kostenlose, Hero-Banner, die auf diesen Kunden ausgerichtet sind, und modifizierte 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 oder einer Headless Storefront aktivieren. 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 aep-segments-membership übergeben.

Versionshinweise

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

- Neue Funktionen
- Fehlerbehebungen und Verbesserungen
- Bekannte Probleme

Unter Bevorstehende Versionen erfahren Sie mehr über die Veröffentlichungszeitpläne und die Unterstützung.

Weitere Informationen zur Produktkompatibilität finden Sie in der Entwicklerdokumentation zu .

Unterstützte Dienstaktualisierungen

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

2,2,0

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

12. Juni 2024

- GA-Version für verwandte Produktregeln, die von Zielgruppen informiert werden.

2.1.1

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

4. April 2024

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

2.2.0-beta1

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

16. Februar 2024

- Wenn Sie an der Beta-Phase teilnehmen, stellen Sie sicher, dass Ihre composer.json-Datei auf der Stammebene Folgendes aufweist: "minimum-stability": "beta".
- (Beta) Es wurde die Möglichkeit hinzugefügt, durch Zielgruppen informierte verwandte Produktregeln zu erstellen.

2.1.0

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

24. Januar 2024

- Das Dashboard Real-Time CDP-Zielgruppen wurde aktualisiert und enthält nun auch die Websites mit den Zielgruppen sowie die zur Verwendung dieser Zielgruppen konfigurierten dynamischen Bausteine und Warenkorbpreisregeln.

2,0,1

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

16. November 2023

- Verbesserte Stabilität.

2,0,0

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

10. Oktober 2023

- Unterstützung für OAuth 2.0 wurde hinzugefügt, wenn Sie die Audience Activation-Erweiterung konfigurieren.
- Verbesserte Stabilität.

1,2,0

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

15. August 2023

- Aktualisierung der Komponentenversion der Benutzeroberfläche.

1.1.0

30. Mai 2023

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

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

1,0,1

11. Mai 2023

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

- Es wurde ein Problem behoben, bei dem keine dynamische Block- oder Warenkorbpreisregel auf die Storefront angewendet wurde.
- 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"}

- 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 der Erweiterung

Installieren Sie die Erweiterung Audience Activation vom Marketplace oder führen Sie den folgenden Befehl aus:

composer require magento/audiences

Konfigurieren der Erweiterung

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

Verwendung von Real-Time CDP-Zielgruppen in Commerce

Wenn die Audience Activation -Erweiterung aktiviert ist, können Sie:

Dashboard für Real-Time CDP-Zielgruppen

Sie können alle aktiven Zielgruppen anzeigen, die in Ihrer Adobe Commerce-Instanz mithilfe des Dashboards Real-Time CDP-Zielgruppen personalisiert werden können.

Um auf das Dashboard Real-Time CDP-Zielgruppen zuzugreifen, wechseln Sie zur Seitenleiste Admin und dann zu Customers > Real-time CDP Audience.

Das Dashboard enthält die folgenden Felder:

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) an die Experience Platform. 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 aep-segments-membership an Commerce übergeben.

Die Gesamtarchitektur sieht wie folgt aus:

Nachdem Sie die Erweiterung install und configure installiert haben, 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 können GraphQL dynamicBlocks-Abfragen das Eingabeattribut audience_id enthalten. Wenn Sie in einer dynamicBlocks -Abfrage einen oder mehrere audience_id -Werte angeben, wird eine Liste mit dynamischen Bausteinen zurückgegeben, 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 zur Abfrage von dynamicBlocks GraphQL finden Sie in der 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.

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 zielgruppenbezogene Warenkorbpreisregeln, dynamische Bausteine und zugehörige Produktregeln in der Commerce-App zu erstellen.

Zielgruppen werden nicht in Commerce angezeigt

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

In den folgenden Abschnitten wird beschrieben, wie Sie diese Probleme beheben können.

Verbindung überprüfen

Führen Sie den folgenden Befehl aus, um die Anmeldeinformationen und die Antwort von Adobe Experience Platform zu überprüfen:

bin/magento audiences:config:status

Dieser Befehl gibt den Verbindungsstatus zurück. Fügen Sie das Flag -v hinzu, um eine zusätzliche ausführlichere Information bereitzustellen:

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

Beispiel:

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

Falscher Authentifizierungstyp in der Konfiguration ausgewählt

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: