Adobe Campaign

Mettez à jour les cartes The Wallet Crew depuis les workflows Adobe Campaign Classic en appelant l’API The Wallet Crew.

Adobe Campaign (Classic)

Les workflows Adobe Campaign peuvent déclencher des appels à l’API The Wallet Crew. Cela permet de mettre à jour automatiquement des cartes pendant une campagne. Les mises à jour typiques incluent l’ajout d’une offre, la mise à jour des données de fidélité ou l’écriture d’un message de campagne dans additionalData.

Exemples concrets

• Une marque de distribution ajoute un message personnalisé à une carte du segment VIP, juste après l’envoi.
• Un organisateur de spectacle met à jour un billet Wallet avec un changement de porte de dernière minute.
• Un fournisseur de billetterie écrit un campaignId dans additionalData pour mesurer les conversions Wallet.

Prérequis

Un accès à une clé API autorisée à mettre à jour des cartes est requis. Un identifiant stable doit également exister dans Adobe Campaign et correspondre à l’identifiant utilisé pour rechercher des cartes dans The Wallet Crew (par exemple, un ID client).

L’hôte et le chemin de l’API dépendent de l’environnement (QA vs production) et de la configuration du projet The Wallet Crew. Les valeurs d’URL d’exemple doivent être remplacées par celles fournies par The Wallet Crew.

Vue d’ensemble de la requête API

L’API de mise à jour des cartes The Wallet Crew est appelée avec PATCH. L’exemple ci-dessous filtre les cartes à l’aide d’un identifiant spécifique au projet (id.y2.customerId) et met à jour additionalData.

Exemple de requête PATCH

curl -X 'PATCH' \
  'https://app-qa.neostore.cloud/api/xxxxx/passes?id.y2.customerId=00100000207298' \
  -H 'accept: */*' \
  -H 'X-API-KEY: xyz' \
  -H 'Content-Type: application/json' \
  -d '{
        "additionalData": {
          "adobe_message": "Offre exclusive : venez nous rendre visite."
        }
      }'

Conception d’un workflow Adobe Campaign

La configuration la plus sûre sépare la sélection de l’exécution. La sélection définit qui doivent être mises à jour. L’exécution définit quoi doit être écrite sur la carte.

1

Sélectionner l’audience

Une activité de requête sélectionne la population cible. La transition sortante doit contenir l’identifiant qui correspond à la clé de recherche des cartes The Wallet Crew (exemple : customerId).

2

Parcourir les enregistrements

Un modèle de workflow peut traiter un enregistrement à la fois, ou de petits lots, selon le volume attendu. Cela réduit l’impact en cas d’erreurs API.

3

Appeler l’API The Wallet Crew

La PATCH /passes le point de terminaison est appelé pour chaque identifiant. La charge utile doit rester minimale et n’écrire que les champs qui doivent changer (exemple : additionalData.adobe_message).

4

Journaliser et gérer les erreurs

Les journaux du workflow doivent stocker le code de statut HTTP et le corps de la réponse. Un chemin d’erreur explicite pour les réponses non 2xx est recommandé (nouvelle tentative, mise en quarantaine ou révision manuelle), selon la criticité de la campagne.

5

Valider les résultats

La validation commence généralement par un petit segment de test. Les champs attendus peuvent ensuite être confirmés sur un échantillon de cartes dans The Wallet Crew.

Exemple d’implémentation (activité JavaScript)

Cette section fournit un exemple pour Adobe Campaign Classic activité JavaScript qui met à jour des cartes dans The Wallet Crew pour une population sélectionnée.

À confirmer : les API exactes disponibles dans les activités JavaScript varient selon la version d’Adobe Campaign et le modèle d’hébergement. L’extrait ci-dessous est un exemple d’implémentation et peut nécessiter une adaptation pour l’instance (méthode de requête, client HTTP, stockage des identifiants).

Exemple d’activité JavaScript (illustratif)

// Configuration de l’API The Wallet Crew
var apiUrl = "https://app-qa.neostore.cloud/api/xxxxx/passes";
var apiKey = "xyz"; // Les clés API doivent être stockées comme des secrets, et non codées en dur.

// Récupérer la liste des clients depuis le contexte du workflow (adapter au modèle de données de l’instance)
var query = xtk.queryDef.create();
query.select("customerId")        // Champ d’identifiant utilisé pour rechercher des cartes
     .from("customerTable");      // Table source
var customers = query.executeQuery();

for (var i = 0; i < customers.length; i++) {
  var customerId = customers[i].customerId;

  // Construire l’URL du point de terminaison API
  var url = apiUrl + "?id.y2.customerId=" + encodeURIComponent(customerId);

  // Définir la charge utile pour la requête API
  var payload = {
    additionalData: {
      adobe_message: "Offre exclusive : venez nous rendre visite."
    }
  };

  try {
    // Exécuter l’appel API (adapter le client HTTP aux capacités de l’instance)
    var response = http.request({
      method: "PATCH",
      url: url,
      headers: {
        "X-API-KEY": apiKey,
        "Content-Type": "application/json",
        "accept": "*/*"
      },
      body: JSON.stringify(payload)
    });

    logInfo("ID client " + customerId + ": mise à jour OK. Statut : " + response.statusCode);
  } catch (error) {
    logError("ID client " + customerId + ": échec de la mise à jour. Erreur : " + error.message);
  }
}

Bonnes pratiques

Les tests dans un environnement hors production réduisent les risques. La gestion des erreurs doit être explicite, car les échecs API peuvent être temporaires. Si la limitation de débit est activée sur le projet, le throttling ou le découpage en lots aide à éviter les réponses 429. Les clés API doivent être traitées comme des secrets et stockées à l’aide des options sécurisées d’Adobe Campaign, lorsque celles-ci sont disponibles.

FAQ

Quel identifiant doit être utilisé dans le filtre API ?

L’identifiant doit correspondre à ce qui a été configuré dans le projet The Wallet Crew pour la recherche de cartes. Les identifiants courants incluent un ID client, un ID de fidélité ou un ID utilisateur externe. Le nom du paramètre de requête (exemple : id.y2.customerId) dépend du modèle de données du projet.

Comment confirmer que les cartes ont été mises à jour avec succès ?

La confirmation nécessite généralement à la fois les journaux du workflow et des vérifications ponctuelles dans The Wallet Crew. Les journaux du workflow doivent conserver l’identifiant de la requête et la réponse HTTP. Les vérifications ponctuelles doivent valider les champs attendus (exemple : additionalData) sur un petit échantillon de cartes.

Comment éviter les limites de débit lors de la mise à jour de grandes audiences ?

Le découpage en lots et le throttling réduisent le risque d’atteindre les limites de l’API. Une approche courante consiste à traiter les enregistrements par petits groupes, à ajouter des pauses entre les lots et à réessayer avec temporisation exponentielle sur les réponses 429/5xx.

Où la clé API doit-elle être stockée dans Adobe Campaign ?

Les clés API doivent être gérées comme des secrets. Privilégiez les mécanismes d’Adobe Campaign prévus pour le stockage des identifiants, plutôt que de coder les valeurs en dur dans les activités ou les scripts. L’accès doit être limité au strict minimum d’opérateurs et de workflows.