Audience Activation

La variable Audience Activation l’extension vous permet d’activer les audiences Real-Time CDP dans Adobe Commerce pour créer des offres uniques dans le panier. Ces offres et incitations incluent des techniques courantes de marchandisage du commerce électronique, telles que achat 2 obtenir 1 gratuit, bannières à forte identification destinées à ce client et modification du prix des produits au moyen 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 headless storefront. Dans un storefront Luma, les informations d’audience (appartenance à un segment) sont stockées dans un cookie côté Commerce. Dans un storefront sans interface utilisateur graphique, 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 :

Nouveau - Nouvelles fonctionnalités
Correction - Correctifs et améliorations
Bogue - 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 découvrez 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

Correction - Mise à jour de la Tableau de bord Audiences Real-Time CDP pour simplifier le filtrage.

27 juin 2023

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

30 mai 2023

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

2.1.1

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

4 avril 2024

Nouveau - 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 composer.json se présente comme suit au niveau racine : "minimum-stability": "beta".
Nouveau - (Beta) Possibilité de créer des règles de produit connexes par les audiences.

2.1.0

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

24 janvier 2024

Nouveau - Mise à jour de la Tableau de bord Audiences Real-Time CDP pour inclure les sites web qui contiennent les audiences et 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

Correction - Amélioration de la stabilité.

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 configure l’extension d’Audience Activation.
Correction - Amélioration de la stabilité.

1.2.0

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

15 août 2023

Correction - 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 de blocs dynamiques dans une vitrine sans tête.

1.0.1

11 mai 2023

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

Correction - 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 - 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 - Version de 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 comme destination dans Real-Time CDP
  • Installer la valeur Audience Activation dans Admin
  • Configurer la valeur Audience Activation dans Admin

Installation de l’extension

Installez le Audience Activation de l’extension marketplaceou exécutez la commande suivante :

composer require magento/audiences

Configuration de l’extension

Après avoir installé la variable Audience Activation , vous devez vous connecter à votre administrateur Commerce et effectuer les opérations suivantes :

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

  2. Se connecter à votre compte d’Adobe et sélectionnez l’ID d’organisation.

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

  4. Dans le Datastream ID , collez l’identifiant de la banque de données que vous avez créée lorsque vous 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, create un en Experience Platform, add à la destination Commerce dans Real-Time CDP et au Data Connection dans Admin.

    note note
    NOTE
    Lorsque vous spécifiez un identifiant de flux de données, vous l’associer à un site web spécifique dans le Data Connection extension . Si votre boutique Commerce comporte plusieurs sites Web, création d’une destination pour chaque site web dans Real-Time CDP et utilisez un identifiant de flux de données différent pour chaque site.
  5. Sur le Administration barre latérale, accédez à Stores > Settings>Configuration.

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

  7. Ajouter informations de compte de service et d’identification.

Où utiliser les audiences Real-Time CDP dans Commerce

Avec la variable Audience Activation extension activée, vous pouvez :

Tableau de bord des audiences Real-Time CDP

Vous pouvez afficher toutes les active audiences disponibles pour la personnalisation dans votre instance Adobe Commerce à l’aide de la variable Audiences Real-Time CDP tableau de bord.

Pour accéder au Audiences Real-Time CDP tableau de bord, accédez à la Administration barre latérale, puis accédez à Customers > Real-time CDP Audience.

Tableau de bord des audiences Real-Time CDP {width="700" modal="regular"}

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.
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 le Origin, Websites, Dynamic Blocks, Cart Price Rules, et Last updated colonnes.

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, un storefront sans interface communique avec l’Experience Platform via la variable Commerce integration framework (CIF). La structure fournit une API côté serveur implémentée à l’aide de GraphQL. Les informations d’audience, telles qu’un segment d’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 d’un storefront sans affichage au serveur principal {width="700" modal="regular"}

Après vous install et configure Avec l’extension , le SDK Web Experience Platform contient les informations d’audience sous la forme d’adhésion au segment.

Pour capturer ces appartenances à des segments à partir du SDK, reportez-vous à cette section 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, GraphQL dynamicBlocks Les requêtes peuvent contenir les audience_id attribut d’entrée. Si vous spécifiez une ou plusieurs audience_id dans une 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
    }
  }
}

En savoir plus sur les dynamicBlocks Requête GraphQL dans le 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 données en fonction de l’audience. règles de prix du panier, blocs dynamiques et règles de produit connexes 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û à :

  • Type d’authentification incorrect sélectionné dans la variable Connexion aux données page de configuration
  • Privilèges insuffisants sur le jeton généré

Les deux sections suivantes expliquent comment résoudre l’un ou l’autre de ces cas.

Type d’authentification incorrect sélectionné dans la configuration

  1. Ouvrez votre instance Commerce.
  2. Sur le Administration barre latérale, accédez à Stores > Settings>Configuration.
  3. Développer Services et sélectionnez Data Connection.
  4. Assurez-vous que la méthode d’autorisation serveur à serveur spécifiée dans la variable Authentication Type est correct. 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’adresse électronique 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. Ajouter Accès complet à la production.
  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 la variable API de connexions à Target.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c