Audience Activation
- Rubriques :
- Clients
- Configuration
Créé pour :
- Expérimenté
- Administration
- Utilisateur ou utilisatrice
L’extension Audience Activation vous permet d’activer les audiences Real-Time CDP dans Adobe Commerce afin de créer des offres uniques dans le panier. Ces offres et incentives incluent des techniques de marchandisage d’e-commerce courantes, telles que pour deux produits, obtenez-en un gratuit, des bannières principales destinées à ce client ou à cette cliente, et la modification de la tarification des produits par le biais de diverses offres. Les audiences créées dans Real-Time CDP sont basées sur des données provenant de divers systèmes d’entreprise, tels que la planification des ressources de l’entreprise (ERP), la gestion de la relation client (CRM), les points de vente et les systèmes marketing. Comme les informations sur les segments de clients sont constamment actualisées, les clients peuvent être associés et dissociés d’un segment lorsqu’ils font leurs achats dans votre boutique.
Vous pouvez activer des audiences dans un storefront Luma ou headless. Dans un storefront Luma, les informations sur l’audience (appartenance à un segment) sont stockées dans un cookie côté Commerce. Dans un storefront découplé, les informations d’audience sont transmises dans l’en-tête de l’API GraphQL sous la forme d’un paramètre nommé : aep-segments-membership
.
Notes de mise à jour
Cette section contient des informations sur les mises à jour de l’extension Audience Activation et comprend :
Voir Prochaines versions pour en savoir plus sur les plannings de publication et la prise en charge.
Consultez la documentation destinée aux développeurs pour en savoir plus sur la compatibilité des produits.
Mises à jour de service prises en charge
Ces notes de mise à jour décrivent les modifications de fonctionnalités et les correctifs liés aux extensions utilisées par Audience Activation.
15 août 2023
27 juin 2023
magento/module-data-services-graphql
.
30 mai 2023
2.4.0
Compatibilité
24 mars 2025
2.3.1
Compatibilité
12 novembre 2024
2.3.0
Compatibilité
29 juillet 2024
2.2.0
Compatibilité
12 juin 2024
2.1.1
Compatibilité
4 avril 2024
2.2.0-beta1
Compatibilité
16 février 2024
composer.json
comporte les éléments suivants au niveau racine : "minimum-stability": "beta"
.
2.1.0
Compatibilité
24 janvier 2024
2.0.1
Compatibilité
16 novembre 2023
2.0.0
Compatibilité
10 octobre 2023
1.2.0
Compatibilité
15 août 2023
1.1.0
30 mai 2023
Compatibilité
1,0,1
1 mai 2023
Compatibilité
1.0.0
31 mars 2023
Compatibilité
Mise en œuvre
Les tâches suivantes s’appliquent à la fois aux implémentations de storefront Luma et découplé. Pour activer des audiences dans Adobe Commerce, vous devez :
- Installation d’Adobe Commerce version 2.4.4 ou ultérieure
- Activer Adobe Commerce comme destination dans Real-Time CDP
- Installer l’extension Audience Activation dans Admin
- Configurer l’extension Audience Activation dans Admin
Installation de l’extension
Installez l’extension Audience Activation à partir de la marketplace ou exécutez la commande suivante :
composer require magento/audiences
Configuration de l’extension
Après avoir installé l’extension Audience Activation, vous devez vous connecter à votre administrateur Commerce et effectuer les opérations suivantes :
-
Dans la barre latérale Admin, accédez à System > Services>Commerce Services Connector.
-
Connectez-vous à votre compte Adobe et sélectionnez votre ID d’organisation.
-
Dans la barre latérale Admin, accédez à System > Services>Data Connection.
-
Dans le champ Datastream ID , collez l’identifiant du flux de données que vous avez créé lorsque vous activé Adobe Commerce en tant que destination dans Real-Time CDP.
Ce flux de données envoie des données de votre site web Commerce à Real-Time CDP afin de déterminer si un acheteur appartient à une audience. Si vous n’avez pas encore créé de flux de données, créez un flux dans Experience Platform, ajoutez à la destination Commerce dans Real-Time CDP et à l’extension Data Connection dans Admin.
NOTE
Lorsque vous spécifiez un identifiant de flux de données, vous l’associer à un site web spécifique dans l’extension Data Connection. Si votre boutique Commerce comporte plusieurs sites web, créez une destination pour chaque site web dans Real-Time CDP et utilisez un identifiant de flux de données différent pour chacun. -
Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
-
Développez Services et sélectionnez Data Connection.
-
Ajouter détails du compte de service et des informations d’identification.
Où utiliser les audiences Real-Time CDP dans Commerce
Une fois l’extension Audience Activation activée, vous pouvez :
- Créer une règle de prix de panier basée sur les audiences
- Créer un bloc dynamique informé par les audiences
- Créer une règle de produit associée basée sur les audiences
Tableau de bord des audiences Real-Time CDP
Vous pouvez afficher toutes les audiences actives qui peuvent être personnalisées dans votre instance Adobe Commerce à l’aide du tableau de bord Audiences Real-Time CDP.
Pour accéder au tableau de bord Audiences Real-Time CDP, positionnez-vous sur la barre latérale Admin, puis sur Customers > Real-time CDP Audience.
Le tableau de bord contient les champs suivants :
Hide filters
Last updated
. Ce filtre vous permet de sélectionner une période pour les audiences en fonction de la date de leur dernière mise à jour.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
et Last updated
.Prise en charge du découplage
Vous pouvez activer des audiences dans une instance Adobe Commerce découplée, telle qu’AEM et PWA, pour afficher les règles de prix de panier, les règles de produit associées ou les blocs dynamiques en fonction des audiences.
Règles de prix du panier et règles de produits associées
Pour les règles de prix de panier et les règles de produit associées, un storefront découplé communique avec Experience Platform via Commerce integration framework (CIF). Le framework fournit une API côté serveur implémentée à l’aide de GraphQL. Les informations d’audience, telles que le segment d’un acheteur, sont transmises à Commerce par le biais d’un paramètre d’en-tête GraphQL nommé : aep-segments-membership
.
L’architecture globale est la suivante :
Après avoir installé et configuré l’extension, le SDK Web Experience Platform contient les informations d’audience sous la forme de l’appartenance à un segment.
Pour capturer ces appartenances à un segment à partir du SDK, consultez ce fragment de code.
Une fois récupéré, vous pouvez transmettre ces segments à Commerce dans l’en-tête GraphQL. Par exemple :
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}"}'
Blocs dynamiques
Pour les blocs dynamiques, les requêtes dynamicBlocks
GraphQL peuvent contenir l’attribut d’entrée audience_id
. Si vous spécifiez une ou plusieurs valeurs de audience_id
dans une requête dynamicBlocks
, elle renvoie une liste de blocs dynamiques affectés à ces audiences.
Exemple d’utilisation
La requête suivante renvoie tous les blocs dynamiques associés à plusieurs identifiants d’audience.
Requête:
{
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
}
}
Réponse:
{
"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
}
}
}
Pour en savoir plus sur la requête dynamicBlocks
GraphQL, consultez la documentation destinée aux développeurs.
Récupérer des audiences à l’aide de Adobe Experience Platform Mobile SDK
Vous pouvez récupérer les audiences Real-Time CDP à l’aide de Adobe Experience Platform Mobile SDK.
- Installez l’extension Audience Activation.
- installer et configurer SDK pour votre site mobile Commerce.
Une fois la configuration terminée, utilisez les opérations mobiles de SDK pour récupérer les données d’audience. Par exemple :
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)")
}
}
}
}
Une fois les données récupérées, vous pouvez les utiliser pour créer des règles de prix de panier, blocs dynamiques et règles de produit associées basées sur l’audience dans l’application Commerce.
Les audiences ne s’affichent pas dans Commerce
Si les audiences Real-Time CDP ne s’affichent pas dans Commerce, cela peut être dû à :
- Connexion non valide
- Type d’authentification incorrect sélectionné dans la page de configuration Connexion aux données
- Privilèges insuffisants sur le jeton généré
Les sections suivantes décrivent comment résoudre ces problèmes.
Valider la connexion
Pour valider les informations d’identification et la réponse de Adobe Experience Platform, exécutez la commande suivante :
bin/magento audiences:config:status
Cette commande renvoie le statut de la connexion. Ajoutez l’indicateur -v
pour fournir plus de détails :
./bin/magento audiences:config:status -v
Par exemple :
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 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 |
Type d’authentification incorrect sélectionné dans la configuration
- Ouvrez votre instance Commerce.
- Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
- Développez Services et sélectionnez Data Connection.
- Assurez-vous que la méthode d’autorisation serveur à serveur que vous avez spécifiée dans le champ Authentication Type est correcte. Adobe recommande d’utiliser OAuth. Le jeton JWT a été abandonné. En savoir plus.
Privilèges insuffisants sur le jeton généré
Ce problème peut être dû à des privilèges d’API insuffisants pour le jeton généré. Pour vous assurer que le jeton dispose des privilèges appropriés :
- Identifiez l’administrateur système pour Adobe Experience Platform au sein de votre organisation.
- Recherchez le projet et les informations d’identification que vous utiliserez.
- Identifiez l’e-mail du compte technique, par exemple :
fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com
. - Demandez à l’administrateur système de lancer Adobe Experience Platform et d’accéder à Permissions -> Users -> API credentials.
- À l’aide de l’e-mail du compte technique ci-dessus, recherchez les informations d’identification à modifier.
- Ouvrez les informations d’identification, puis sélectionnez Roles -> Add roles.
- Ajoutez le rôle contenant l’autorisation Manage destinations.
- Cliquez sur Save.
- Régénérer le jeton d’accès dans la console.
- Vérifiez que le jeton fournit une réponse valide à l’aide de l’API Target Connections.