Audience Activation
L’extension Audience Activation vous permet d’activer les audiences Real-Time CDP dans Adobe Commerce pour créer des offres uniques dans le panier. Ces offres et avantages incluent des techniques courantes de marchandisage de l’e-commerce, telles que purchase 2 get 1 gratuit, des bannières à héros adaptées à ce client et des prix modifiés par le biais de diverses offres. Les audiences créées dans Real-Time CDP sont basées sur les données de divers systèmes d’entreprise, tels que le ERP (Enterprise Resource Planning), la gestion de la relation client (CRM), les points de vente et les systèmes marketing. Les informations sur les segments de clients étant 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 les audiences dans un storefront Luma ou un storefront headless. Dans un storefront Luma, les informations d’audience (appartenance à un segment) sont stockées dans un cookie côté Commerce. Dans une vitrine sans interface utilisateur, 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 apportées à l’extension d’Audience Activation et comprend :
- Nouvelles fonctionnalités
- Correctifs et améliorations
- Problèmes connus
Voir Versions à venir pour en savoir plus sur les calendriers de publication et l’assistance.
Consultez la documentation destinée aux développeurs pour en savoir plus sur la compatibilité des produits.
Mises à jour du service prises en charge
Ces notes de mise à jour décrivent les modifications et correctifs de fonctionnalités liés aux extensions utilisées par Audience Activation.
15 août 2023
- Mise à jour du tableau de bord des audiences Real-Time CDP pour simplifier le filtrage.
27 juin 2023
- Ajout de la prise en charge de PHP 8.2 dans le package magento/module-data-services-graphql
.
30 mai 2023
- Mise à jour du tableau de bord des audiences Real-Time CDP afin d’inclure la possibilité de trier, rechercher et filtrer les audiences actives dans votre instance Adobe Commerce.
2.3.0
[Compatibilité]{class="badge informative" title="Compatibilité"}
29 juillet 2024
- Ajout d’une syntaxe de ligne de commande afin que vous puissiez tester les informations d’identification pour déterminer si elles doivent être mises à jour pour extraire les données d’audience de Adobe Experience Platform.
2.2.0
[Compatibilité]{class="badge informative" title="Compatibilité"}
12 juin 2024
- Version GA pour les règles de produit connexes informées par les audiences.
2.1.1
[Compatibilité]{class="badge informative" title="Compatibilité"}
4 avril 2024
- Ajout de la prise en charge de PHP 8.3.
2.2.0-beta1
[Compatibilité]{class="badge informative" title="Compatibilité"}
16 février 2024
- Si vous participez à la version bêta, assurez-vous que votre fichier composer.json
comporte les éléments suivants au niveau racine : "minimum-stability": "beta"
.
- (Beta) Possibilité de créer des règles de produit connexes informées par les audiences.
2.1.0
[Compatibilité]{class="badge informative" title="Compatibilité"}
24 janvier 2024
- Mise à jour du tableau de bord Audiences Real-Time CDP afin d’inclure les sites web qui contiennent les audiences et de spécifier les blocs dynamiques et les règles de prix du panier configurés pour utiliser ces audiences.
2.0.1
[Compatibilité]{class="badge informative" title="Compatibilité"}
16 novembre 2023
- Stabilité améliorée.
2.0.0
[Compatibilité]{class="badge informative" title="Compatibilité"}
10 octobre 2023
- Ajout de la prise en charge d’OAuth 2.0 lorsque vous configurez l’extension de l’Audience Activation.
- Stabilité améliorée.
1.2.0
[Compatibilité]{class="badge informative" title="Compatibilité"}
15 août 2023
- Mise à jour de la version des composants de l’interface utilisateur.
1.1.0
30 mai 2023
[Compatibilité]{class="badge informative" title="Compatibilité"}
- Ajout de la prise en charge des blocs dynamiques dans un storefront sans interface.
1.0.1
11 mai 2023
[Compatibilité]{class="badge informative" title="Compatibilité"}
- Correction d’un problème en raison duquel une règle de prix de bloc ou de panier dynamique n’était pas appliquée au storefront.
- Correction d’un problème en raison duquel une installation non configurée de l’extension d’Audience Activation provoquait une erreur lorsqu’un commerçant tentait de créer ou de mettre à jour un bloc dynamique.
1.0.0
31 mars 2023
[Compatibilité]{class="badge informative" title="Compatibilité"}
- Disponibilité générale
Implémentation
Les tâches suivantes s’appliquent aux mises en oeuvre de storefront sans interface et Luma. Pour activer les audiences dans Adobe Commerce, vous devez :
- Installation d’Adobe Commerce version 2.4.4 ou ultérieure
- Activer Adobe Commerce en tant que destination dans Real-Time CDP
- Installezl’extension Audience Activation dans l’Admin
- Configurez l’extension Audience Activation dans l’Admin
Installation de l’extension
Installez l’extension Audience Activation à partir de 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 :
-
Sur la barre latérale Admin, accédez à System > Services>Commerce Services Connector.
-
Connectez-vous à votre compte d’Adobe et sélectionnez votre ID d’organisation.
-
Sur la barre latérale Admin, accédez à System > Services>Data Connection.
-
Dans le champ Datastream ID , collez l’identifiant de la banque de données que vous avez créée lorsque vous avez activé Adobe Commerce comme destination dans Real-Time CDP.
Ce flux de données envoie des données de votre site web Commerce à Real-Time CDP pour déterminer si un acheteur appartient à une audience. Si vous n’avez pas encore créé de flux de données, créez un flux de données dans l’Experience Platform, ajoutez-le à la destination Commerce dans Real-Time CDP et à l’extension Data Connection dans l’Admin.
note note NOTE Lorsque vous spécifiez un identifiant de flux de données, vous l’associez à 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 d’eux. -
Sur la barre latérale Admin, accédez à Stores > Settings>Configuration.
-
Développez Services et sélectionnez Data Connection.
-
Ajoutez le compte de service et les 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 informée par les audiences
- Créer un bloc dynamique informé par les audiences
- Créez une règle de produit associéeinformée par les audiences
Tableau de bord des audiences Real-Time CDP
Vous pouvez afficher toutes les audiences actives disponibles pour la personnalisation 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, accédez à la barre latérale Admin, puis accédez à Customers > Real-time CDP Audience.
Le tableau de bord contient les champs suivants :
Hide filters
Last updated
. Ce filtre 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 sans tête
Vous pouvez activer les audiences dans une instance Adobe Commerce sans interface utilisateur graphique, telle qu’AEM et PWA, pour afficher les règles de prix du 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 connexes sur les produits
Pour les règles de prix du panier et les règles de produit associées, une vitrine sans interface communique avec l’Experience Platform par le biais du Commerce integration framework (CIF). La structure 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 sur l’audience sous la forme d’adhésion au segment.
Pour capturer ces appartenances de segment à partir du SDK, reportez-vous à cet extrait de code.
Une fois récupérés, vous pouvez transmettre ces segments à Commerce dans l’en-tête de 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 GraphQL dynamicBlocks
peuvent contenir l’attribut d’entrée audience_id
. Si vous spécifiez une ou plusieurs valeurs 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ération des audiences à l’aide du SDK Adobe Experience Platform Mobile
Vous pouvez récupérer les audiences Real-Time CDP à l’aide du SDK Adobe Experience Platform Mobile.
- Installez l’extension d’Audience Activation.
- installez et configurez le SDK pour votre site Commerce mobile.
Une fois la configuration terminée, utilisez les opérations du SDK mobile 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 du panier, des blocs dynamiques et des règles de produit connexes 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 identifiants et la réponse de Adobe Experience Platform, exécutez la commande suivante :
bin/magento audiences:config:status
Cette commande renvoie l’état de la connexion. Ajoutez l’indicateur -v
pour fournir une plus grande précision :
./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.
- Sur 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. 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 de Adobe Experience Platform de votre entreprise.
- Recherchez le projet et les informations d’identification que vous utiliserez.
- Identifiez l'email 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 de connexions Target.