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:
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.
15. August 2023
27. Juni 2023
magento/module-data-services-graphql
-Paket wurde hinzugefügt.
30. Mai 2023
2,3,1
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
12. November 2024
2,3,0
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
29. Juli 2024
2,2,0
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
12. Juni 2024
2.1.1
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
4. April 2024
2.2.0-beta1
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
16. Februar 2024
composer.json
-Datei auf der Stammebene Folgendes enthält: "minimum-stability": "beta"
.
2,1,0
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
24. Januar 2024
2,0,1
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
16. November 2023
2,0,0
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
10. Oktober 2023
1,2,0
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
15. August 2023
1,1,0
30. Mai 2023
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
1,0,1
11. Mai 2023
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
1,0,0
31. März 2023
[Kompatibilität]{class="badge informative" title="Kompatibilität"}
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 Sie Adobe Commerce Version 2.4.4 oder höher
- Aktivieren Adobe Commerce als Ziel in Real-Time CDP
- Installieren Sie die Audience Activation-Erweiterung in der Admin Console.
- Konfigurieren der Audience Activation-Erweiterung in der Admin Console
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:
-
Navigieren Sie in Admin-Seitenleiste zu System > Services>Commerce Services Connector.
-
Melden Sie sichIhrem Adobe-Konto an und wählen Sie Ihre Organisations-ID aus.
-
Navigieren Sie in Admin-Seitenleiste zu System > Services>Data Connection.
-
Fügen Sie im Feld Datastream ID die ID des Datenstroms ein, den Sie beim Aktivieren Adobe CommerceZiel in Real-Time CDP erstellt haben.
Dieser Datenstrom sendet Daten von Ihrer Commerce-Website an Real-Time CDP, um festzustellen, ob ein Erstkäufer zu einer Zielgruppe gehört. Wenn Sie noch keinen Datenstrom erstellt haben, Siein Experience Platform, fügen ihn zum Commerce-Ziel in Real-Time CDP und zur Data Connection-Erweiterung in Admin hinzu.
note note NOTE Wenn Sie eine Datenstrom-ID angeben verknüpfen Sie sie mit einer bestimmten Websiteder Data Connection. Wenn Ihr Commerce-Store über mehrere Websites verfügt erstellen Siefür jede Website in Real-Time CDP ein Ziel und verwenden Sie für jede eine andere Datenstrom-ID. -
Navigieren Sie in Admin-Seitenleiste zu Stores > Settings>Configuration.
-
Erweitern Sie Services und wählen Sie Data Connection.
-
Hinzufügen Details zum Service-Konto und den Anmeldedaten.
Verwendung von Real-Time CDP-Zielgruppen in Commerce
Wenn die Audience Activation aktiviert ist, können Sie:
- Erstellen einer Warenkorb-Preisregel informiert durch Zielgruppen
- Erstellen eines dynamischen Blocks basierend auf Audiences
- Erstellen einer zugehörigen Produktregel informiert durch Zielgruppen
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.
Das Dashboard enthält die folgenden Felder:
Hide filters
Last updated
. Mit diesem Filter können Sie einen Datumsbereich für Zielgruppen basierend auf dem Zeitpunkt ihrer letzten Aktualisierung auswählen.Search
Name
Origin
Experience Platform
.Websites
Dynamic Blocks
Cart Price Rules
Related Product Rules
Last updated
Sync now
Customize table
Origin
, Websites
, Dynamic Blocks
, Cart Price Rules
und Last updated
.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:
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> </p>"
}
},
{
"uid": "Mg==",
"audience_id": [
"cd29a789-9be8-40ad-a1ef-640c33b3742e",
"92c3e14d-c72b-40d0-96b7-b96801dcc135"
],
"content": {
"html": "<p><img src=\"{{media url="wysiwyg/save20.png"}}\" 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.
- Installieren Sie die Audience Activation-Erweiterung.
- Installieren und konfigurieren Sie die SDK für Ihre mobile Commerce-Site.
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:
- Ungültige Verbindung
- Falscher Authentifizierungstyp auf der Konfigurationsseite Datenverbindung ausgewählt
- Unzureichende Berechtigungen für generiertes Token
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
- Öffnen Sie Ihre Commerce-Instanz.
- Navigieren Sie in Admin-Seitenleiste zu Stores > Settings>Configuration.
- Erweitern Sie Services und wählen Sie Data Connection.
- Stellen Sie sicher, dass die im Feld Authentication Type angegebene Server-zu-Server-Autorisierungsmethode korrekt ist. Adobe empfiehlt die Verwendung von OAuth. JWT wird nicht mehr unterstützt. Weitere Informationen.
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:
- Bestimmen Sie den Systemadministrator für Adobe Experience Platform in Ihrem Unternehmen.
- Suchen Sie das Projekt und die Anmeldeinformationen, die Sie verwenden werden.
- Identifizieren Sie die E-Mail-Adresse des technischen Kontos, zum Beispiel:
fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com
. - Bitten Sie den Systemadministrator, Adobe Experience Platform zu starten und zu Permissions -> Users -> API credentials zu gehen.
- Suchen Sie mithilfe der E-Mail-Adresse des technischen Kontos von oben nach den Anmeldedaten, die geändert werden sollen.
- Öffnen Sie die Anmeldeinformationen und wählen Sie Roles -> Add roles aus.
- Fügen Sie die Rolle hinzu, die Manage destinations Berechtigung enthält.
- Klicken Sie auf Save.
- Erneutesdes Zugriffstokens in der Konsole.
- Vergewissern Sie sich mithilfe der „Target Connections ", dass das Token eine gültige Antwort.