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 :

New - Nouvelles fonctionnalités
Correctif - Correctifs et améliorations
Bug - 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.

Mises à jour du service prises en charge

15 août 2023

Correctif - Mise à jour du tableau de bord des 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 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

Nouveau - 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

Nouveau - 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

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

2.2.0-beta1

[Compatibilité]{class="badge informative" title="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 connexes informées par les audiences.

2.1.0

[Compatibilité]{class="badge informative" title="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 du panier configurés pour utiliser ces audiences.

2.0.1

[Compatibilité]{class="badge informative" title="Compatibilité"}

16 novembre 2023

Correctif - Stabilité améliorée.

2.0.0

[Compatibilité]{class="badge informative" title="Compatibilité"}

10 octobre 2023

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

1.2.0

[Compatibilité]{class="badge informative" title="Compatibilité"}

15 août 2023

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

1.1.0

30 mai 2023

[Compatibilité]{class="badge informative" title="Compatibilité"}

Nouveau - 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é"}

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.
Fix - 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é"}

Nouveau - 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 :

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

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

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

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

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

  7. 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 :

TIP
Pour obtenir un cas d’utilisation complet sur l’exportation de données Commerce vers Real-Time CDP, créez une audience, puis activez cette audience vers Commerce, voir Création d’une audience dans Real-Time CDP à l’aide de Commerce données d’événement.

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.

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 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 d’où provient l’audience, par exemple Experience Platform.
Websites
Indique les sites web configurés pour utiliser les audiences.
Dynamic Blocks
Indique les blocs dynamiques configurés pour utiliser les audiences.
Cart Price Rules
Indique les règles de prix du panier configurées pour utiliser les audiences.
Related Product Rules
Indique les règles de produit connexes 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 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 :

Envoi de données de Storefront sans affichage vers le serveur principal

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>&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é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.

IMPORTANT
Le SDK Mobile Adobe Experience Platform pour iOS prend en charge iOS 11 ou version ultérieure.

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

  1. Ouvrez votre instance Commerce.
  2. Sur 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. 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 de Adobe Experience Platform de votre entreprise.
  2. Recherchez le projet et les informations d’identification que vous utiliserez.
  3. Identifiez l'email 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 de connexions Target.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c