This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Enrichissement de l’URL du lien Wallet

Réécrivez une URL de redirection de lien Wallet avant qu’un client ne soit redirigé, à l’aide de `runtime.wallet.linkUrlEnricher`.

Ce hook facultatif s'exécute lorsqu'une redirection d'un lien Wallet (un court wlt.pm/~... lien) est résolu, avant que le client ne soit redirigé vers l'URL de destination. Il peut réécrire l'URL — par exemple, pour ajouter des paramètres de suivi spécifiques au locataire. Il ne nécessite aucune configuration supplémentaire — l'enregistrement du point de terminaison dans un script suffit pour qu'il soit appelé.

/**
 * @typedef {Object} CarteContext
 * @property {string} CarteId
 * @property {string} CarteType
 * @property {Record<string, string>} Identifiants
 * @property {Record<string, any>} [DonnéesSupplémentaires]
 * @property {Record<string, any>} Métadonnées
 * @property {"apple"|"google"} [Appareil]
 * @property {string} [Origine]
 * @property {string} [IdentifiantSource]
 * @property {string} [Langue]
 */

/**
 * @param {string} url - L'URL de destination sur le point d'être utilisée pour la redirection.
 * @param {CarteContext} context - Informations sur la carte et la source du lien.
 * @returns {Promise<string|null>} L'URL vers laquelle rediriger, ou null pour conserver l'URL d'origine inchangée.
 */
async function enrich(url, context) {
  return url + (url.includes("?") ? "&" : "?") + "carteType=" + encodeURIComponent(context.CarteType);
}

export default function (context) {
  context.register('runtime.wallet.linkUrlEnricher', {
    Enrich: enrich
  });
}

Lorsque ce point de terminaison n'est pas enregistré, The Wallet Crew applique ses propres paramètres UTM par défaut (utm_source=thewalletcrew, plus utm_medium/utm_campaign/utm_content dérivés de la source du lien) à la place. L'enregistrement de ce hook remplace entièrement ce comportement par défaut pour chaque lien Wallet.