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:
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.
15. August 2023
27. Juni 2023
magento/module-data-services-graphql
-Paket hinzugefügt.
30. Mai 2023
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 aufweist: "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 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 Sie die Erweiterung Audience Activation im Admin
- Konfigurieren Sie die Erweiterung Audience Activation im Admin
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:
-
Wechseln Sie in der Seitenleiste Admin zu System > Services>Commerce Services Connector.
-
Melden Sie sich bei Ihrem Adobe-Konto an und wählen Sie Ihre Organisations-ID aus.
-
Wechseln Sie in der Seitenleiste Admin zu System > Services>Data Connection.
-
Fügen Sie im Feld Datastream ID die ID des Datastreams ein, den Sie beim Aktivieren von Adobe Commerce als Ziel in Real-Time CDP erstellt haben.
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 Sie 🔗einen in der Experience Platform, fügen Sieihn zum Commerce-Ziel in Real-Time CDP und zur Erweiterung Data Connection im Admin hinzu.
note note NOTE Wenn Sie eine Datastraam-ID angeben, verknüpfen Sie sie mit einer bestimmten Website in der Erweiterung Data Connection . Wenn Ihr Commerce-Store über mehrere Websites verfügt, erstellen Sie in Real-Time CDP für jede Website ein Ziel 🔗 und verwenden Sie für jede Website eine andere Datastraam-ID. -
Wechseln Sie in der Seitenleiste Admin zu Stores > Settings>Configuration.
-
Erweitern Sie Services und wählen Sie Data Connection aus.
-
Fügen Sie das Dienstkonto und die Anmeldeinformationen hinzu.
Verwendung von Real-Time CDP-Zielgruppen in Commerce
Wenn die Audience Activation -Erweiterung aktiviert ist, können Sie:
- Erstellen einer Preisregel für den Warenkorb, die von Zielgruppen informiert wird
- Dynamischen Block erstellen, der von Zielgruppen informiert wird
- Erstellen einer verwandten Produktregel, die von Zielgruppen informiert wird
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:
Hide filters
Last updated
. Mit diesem Filter können Sie einen Datumsbereich für Zielgruppen auswählen, basierend auf dem Zeitpunkt der letzten Aktualisierung.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
ein- oder ausblenden.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> </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 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.
- Installieren Sie die Audience Activation-Erweiterung.
- Installieren und Konfigurieren des SDK für Ihre mobile Commerce-Site.
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:
- Ungültige Verbindung
- Falscher Authentifizierungstyp, der auf der Konfigurationsseite Datenverbindung ausgewählt wurde
- Unzureichende Berechtigungen für generiertes Token
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
- Öffnen Sie Ihre Commerce-Instanz.
- Wechseln Sie in der Seitenleiste Admin zu Stores > Settings>Configuration.
- Erweitern Sie Services und wählen Sie Data Connection aus.
- Vergewissern Sie sich, dass die von Ihnen im Feld Authentication Type angegebene Server-zu-Server-Autorisierungsmethode korrekt ist. Adobe empfiehlt die Verwendung von 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:
- Identifizieren Sie den Systemadministrator für Adobe Experience Platform in Ihrem Unternehmen.
- Suchen Sie das Projekt und die Anmeldeinformationen, die Sie verwenden werden.
- Geben Sie die E-Mail-Adresse des technischen Kontos an, z. B.
fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com
. - Lassen Sie den Systemadministrator Adobe Experience Platform starten und gehen Sie zu "Permissions -> Users -> API credentials".
- Suchen Sie mithilfe der E-Mail-Adresse des technischen Kontos oben nach den zu ändernden Anmeldeinformationen.
- Öffnen Sie die Anmeldeinformationen und wählen Sie dann Roles -> Add roles aus.
- Fügen Sie die Rolle hinzu, die die Berechtigung Manage destinations enthält.
- Klicken Sie auf Save.
- Regenerieren Sie das Zugriffstoken in der Konsole.
- Stellen Sie sicher, dass das Token mithilfe der Target-Verbindungs-API eine gültige Antwort bereitstellt.