Audience Activation

Mit der Audience Activation-Erweiterung können Sie Real-Time CDP-Zielgruppen in Adobe Commerce aktivieren, um individuelle Angebote im Warenkorb zu erstellen. Zu diesen Angeboten und Incentives gehören gängige E-Commerce-Merchandising-Techniken wie Buy 2 get 1 free, Hero-Banner, die auf diesen Kunden zugeschnitten sind, und modifizierte Produktpreise durch 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 mit einem Segment verknüpft und von ihm getrennt werden, wenn sie in Ihrem Geschäft einkaufen.

Sie können Zielgruppen in einer Luma-Storefront oder einer Headless-Storefront aktivieren. In einer Luma-Storefront werden Zielgruppeninformationen (Segmentzugehörigkeit) in einem Cookie auf der Commerce-Seite gespeichert. In einer Headless-Storefront werden Zielgruppeninformationen im GraphQL-API-Header 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 Kommende Versionen erfahren Sie mehr über Versionspläne und Support.

Weitere Informationen zur Produktkompatibilität finden in der Entwicklerdokumentation.

Unterstützte Service-Updates

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

2,3,1

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

12. November 2024

- Es wurde ein Problem beim Filtern der verfügbaren Real-Time CDP-Zielgruppen zur Auswahl behoben.

2,3,0

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

29. Juli 2024

- Es wurde eine Befehlszeilensyntax hinzugefügt, mit der Sie Anmeldedaten testen um festzustellen, ob sie aktualisiert werden müssen, um Zielgruppendaten aus Adobe Experience Platform abzurufen.

2,2,0

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

12. Juni 2024

- GA-Version für Produktregeln mit Informationen von Zielgruppen.

2.1.1

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

4. April 2024

- PHP 8.3 wird nun unterstützt.

2.2.0-beta1

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

16. Februar 2024

- Wenn Sie die Betaversion verwenden, stellen Sie sicher, dass Ihre composer.json-Datei auf der Stammebene Folgendes enthält: "minimum-stability": "beta".
- (Beta) Es besteht nun die Möglichkeit, verwandte Produktregeln“Zielgruppen zu erstellen.

2,1,0

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

24. Januar 2024

- Das Dashboard Real-Time CDP-Zielgruppen wurde aktualisiert, um die Websites einzuschließen, die die Zielgruppen enthalten, und um anzugeben, welche dynamischen Blöcke und Warenkorbpreisregeln für die Verwendung dieser Zielgruppen konfiguriert sind.

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

- Es wurde Unterstützung für OAuth 2.0 beim (Konfigurieren der Audience Activation-Erweiterung hinzugefügt.
- Verbesserte Stabilität.

1,2,0

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

15. August 2023

- Die Version der Benutzeroberflächenkomponenten wurde aktualisiert.

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 eine dynamische Block- oder Warenkorb-Preisregel nicht 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 Luma- als auch für Headless-Storefront-Implementierungen. Zum Aktivieren von Zielgruppen in Adobe Commerce ist Folgendes erforderlich:

Installieren der Erweiterung

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

composer require magento/audiences

Konfigurieren der Erweiterung

Nachdem Sie die Audience Activation-Erweiterung installiert haben, 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 aktiviert ist, können Sie:

Real-Time CDP-Zielgruppen-Dashboard

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, gehen Sie zur Seitenleiste Admin und dann zu Customers > Real-time CDP Audience.

{width="700" modal="regular"}

Das Dashboard enthält die folgenden Felder:

Headless-Unterstützung

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

Regeln für Warenkorbpreise und zugehörige Produkte

Für Regeln zum Warenkorbpreis und zugehörige Produktregeln kommuniziert eine Headless-Storefront über die Commerce integration framework (CIF) mit der Experience Platform. Das Framework bietet eine Server-seitige API, die mithilfe von GraphQL implementiert wird. Zielgruppeninformationen, wie z. B. das Segment eines Käufers, werden über einen GraphQL-Kopfzeilenparameter namens aep-segments-membership an Commerce übergeben.

Die Gesamtarchitektur sieht wie folgt aus:

{width="700" modal="regular"}

Nach dem Installieren und Konfigurieren der Erweiterung enthält die Experience Platform Web SDK die Zielgruppeninformationen in Form von Segmentzugehörigkeit.

Informationen zum Erfassen dieser Segmentzugehörigkeiten aus der SDK finden Sie in diesem Code-Snippet.

Nach dem Abrufen 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 Blöcken können GraphQL-dynamicBlocks-Abfragen das audience_id Eingabeattribut enthalten. Wenn Sie einen oder mehrere audience_id Werte in einer dynamicBlocks Abfrage angeben, wird eine Liste der dynamischen Blöcke 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 dynamicBlocks GraphQL-Abfrage finden Sie in der Entwicklerdokumentation.

Abrufen von Zielgruppen mit der Adobe Experience Platform Mobile SDK

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

Verwenden Sie nach Abschluss der Konfiguration mobile SDK-Vorgänge, um die Zielgruppendaten abzurufen. 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 zielgruppenorientierte Warenkorbpreisregeln, dynamische Blöcke und verwandte Produktregeln in der Commerce-App zu erstellen.

Zielgruppen werden in Commerce nicht angezeigt

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

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

Verbindung validieren

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ührlichkeit zu erzielen:

./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 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: