DocumentationCommerceGestion des clients

Audience Activation

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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 :

Nouveau - Nouvelles fonctionnalités
Correctif - Correctifs et améliorations
Bug - Problèmes connus

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.

Mises à jour de service prises en charge

15 août 2023

Correctif - Mise à jour du tableau de bord Audiences Real-Time CDP pour simplifier le filtrage.

27 juin 2023

Fix - Ajout de la prise en charge de PHP 8.2 dans le package magento/module-data-services-graphql.

30 mai 2023

Nouveau - Mise à jour du tableau de bord Audiences Real-Time CDP afin d’inclure la possibilité de trier, rechercher et filtrer les audiences actives dans votre instance Adobe Commerce.

2.4.0

Compatibilité ​

24 mars 2025

Nouveau - Ajout de la prise en charge de PHP 8.4.

2.3.1

Compatibilité ​

12 novembre 2024

Correctif - Correction d’un problème lors du filtrage des audiences Real-Time CDP disponibles.

2.3.0

Compatibilité ​

29 juillet 2024

Nouveau - Ajout d’une syntaxe de ligne de commande afin que vous puissiez tester les informations d’identification afin de déterminer si elles doivent être mises à jour pour extraire les données d’audience de Adobe Experience Platform.

2.2.0

Compatibilité ​

12 juin 2024

Nouveau - Version GA pour les règles de produit associées selon les audiences.

2.1.1

Compatibilité ​

4 avril 2024

Nouveau - Ajout de la prise en charge de PHP 8.3.

2.2.0-beta1

Compatibilité ​

16 février 2024

Nouveau - 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".
Nouveau - (Beta) Possibilité de créer des règles de produit associées basées sur les audiences.

2.1.0

Compatibilité ​

24 janvier 2024

Nouveau - 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 de panier configurés pour utiliser ces audiences.

2.0.1

Compatibilité ​

16 novembre 2023

Correctif - Stabilité améliorée.

2.0.0

Compatibilité ​

10 octobre 2023

Nouveau - Ajout de la prise en charge d’OAuth 2.0 lorsque vous configurez l’extension Audience Activation.
Correctif - Stabilité améliorée.

1.2.0

Compatibilité ​

15 août 2023

Correctif - Mise à jour de la version des composants de l’interface utilisateur.

1.1.0

30 mai 2023

Compatibilité ​

Nouveau - Ajout de la prise en charge des blocs dynamiques dans un storefront découplé.

1,0,1

1 mai 2023

Compatibilité ​

Correctif - 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.
Correctif - Correction d’un problème en raison duquel une installation non configurée de l’extension 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é ​

Nouveau - Version à disponibilité générale

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 :

  1. Dans la barre latérale Admin, accédez à System > Services>Commerce Services Connector.

  2. Connectez-vous à votre compte Adobe et sélectionnez votre ID d’organisation.

  3. Dans la barre latérale Admin, accédez à System > Services>Data Connection.

  4. 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.
  5. Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.

  6. Développez Services et sélectionnez Data Connection.

  7. 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
TIP
Pour un cas pratique complet sur l’exportation de données Commerce vers Real-Time CDP, la création d’une audience, puis l’activation de cette audience vers Commerce, consultez la section Création d’une audience dans Real-Time CDP à l’aide Commerce données d’événement.

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.

Tableau de bord des audiences Real-Time CDP

Le tableau de bord contient les champs suivants :

Colonne
Description
Hide filters
Permet d’afficher ou de masquer les filtres que vous pouvez appliquer au tableau de bord. Actuellement, le seul filtre que vous pouvez appliquer est 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
Permet de rechercher des audiences actives dans votre instance Commerce.
Name
Nom donné à l’audience dans Real-Time CDP.
Origin
Indique l’origine de l’audience, par exemple Experience Platform.
Websites
Indique quels sites web sont configurés pour utiliser les audiences.
Dynamic Blocks
Indique quels blocs dynamiques sont configurés pour utiliser les audiences.
Cart Price Rules
Indique quelles règles de prix de panier sont configurées pour utiliser les audiences.
Related Product Rules
Indique les règles de produit associées configurées pour utiliser les audiences.
Last updated
Indique le moment où l’audience a été modifiée dans Real-Time CDP.
Sync now
Récupère les audiences nouvelles ou mises à jour de Real-Time CDP.
Customize table
Permet d’afficher ou de masquer les colonnes 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 :

Envoi de données du storefront découplé au serveur principal

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>&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
    }
  }
}

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.

  1. Installez l’extension Audience Activation.
  2. installer et configurer SDK pour votre site mobile Commerce.
IMPORTANT
Adobe Experience Platform Mobile SDK for iOS prend en charge iOS 11 ou une version ultérieure.

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

  1. Ouvrez votre instance Commerce.
  2. Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
  3. Développez Services et sélectionnez Data Connection.
  4. 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 :

  1. Identifiez l’administrateur système pour Adobe Experience Platform au sein de votre organisation.
  2. Recherchez le projet et les informations d’identification que vous utiliserez.
  3. Identifiez l’e-mail du compte technique, par exemple : fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com.
  4. Demandez à l’administrateur système de lancer Adobe Experience Platform et d’accéder à Permissions -> Users -> API credentials.
  5. À l’aide de l’e-mail du compte technique ci-dessus, recherchez les informations d’identification à modifier.
  6. Ouvrez les informations d’identification, puis sélectionnez Roles -> Add roles.
  7. Ajoutez le rôle contenant l’autorisation Manage destinations.
  8. Cliquez sur Save.
  9. Régénérer le jeton d’accès dans la console.
  10. Vérifiez que le jeton fournit une réponse valide à l’aide de l’API Target Connections.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c