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.

2.3.1

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

12 novembre 2024

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

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

Où utiliser les audiences Real-Time CDP dans Commerce

Une fois l’extension Audience Activation activée, vous pouvez :

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.

{width="700" modal="regular"}

Le tableau de bord contient les champs suivants :

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 :

{width="700" modal="regular"}

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.

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û à :

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

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 :