Instructions d'utilisation des macros personnalisées

Tenez compte des instructions suivantes lors de la création ou de l'utilisation d'une macro personnalisée :

Le nom de la macro personnalisée doit être alphanumérique. Vous ne pouvez pas utiliser d'espaces dans la chaîne nom. En revanche, vous pouvez vous servir de traits de soulignement (_).

Si une source de données a été configurée avec la propriété ENABLE_SELECT_SORT_BY = TRUE, vous devez écrire des macros personnalisées en SQL brut avec une clause ORDER BY afin de trier les enregistrements renvoyés en fonction des zones de clé d'audience dans laquelle vous travaillez. En effet, si l'ordre de tri est différent, une erreur se produit lors de l'utilisation de la macro personnalisée dans une zone dérivée d'un processus d'instantané.

Si vous ne comparez pas une valeur renvoyée par une macro personnalisée et que la valeur est numérique, les valeurs différentes de zéro sont traitées comme TRUE (et les ID qui leur sont associés sont donc sélectionnés) et les valeurs nulles sont traitées comme FALSE. Les valeurs de chaîne sont toujours traitées comme FALSE.

Lors de la création d'une macro personnalisée utilisant le langage SQL brut, l'emploi d'une table temporaire peut améliorer de façon significative les performances de SQL brut en se concentrant sur le volume de données nécessaire.

Lorsqu'une macro personnalisée utilise des tables temporaires dans sa logique sous-jacente, une des tables temporaires est créée dans la base de données afin que la logique aboutisse.

Cependant, si une macro personnalisée est utilisée dans une propriété SELECT de niveau supérieur, Campaign ne peut utiliser aucun historique pour créer une table temporaire dans la base de données et la logique échoue.

Par conséquent, lorsque vous créez une macro personnalisée utilisant SQL brut, vous pouvez avoir besoin de créer deux versions de la même macro : l'une utilisant des jetons de table temporaire et l'autre non.

La macro personnalisée sans jetons de table temporaire peut être utilisée au niveau supérieur d'une arborescence (par exemple, dans la première propriété SELECT). La macro contenant des jetons de table temporaire peut être utilisée à tout autre endroit de l'arborescence où l'inclusion d'une table temporaire peut s'avérer bénéfique.

Des auto-jointures indésirables peuvent se produire lors de la combinaison des valeurs renvoyées par les macros personnalisées quand la requête se fait sur des données non normalisées.

Par exemple, si vous utilisez une macro personnalisée basée sur SQL brut qui renvoie une valeur et que (dans un processus d'instantané, par exemple) vous générez la macro personnalisée et une autre zone à partir de la table sur laquelle se fonde la macro personnalisée, Campaign effectue une auto-jointure sur cette table. Si la table n'est pas normalisée, vous obtiendrez un produit cartésien (à savoir, le nombre d'enregistrements affiché sera supérieur au nombre attendu).

Les macros personnalisées sont désormais automatiquement triées par référence, car leur définition n'est pas copiée dans le processus en cours.

Lors de l'exécution, une macro personnalisée est résolue en recherchant sa définition dans la table système UA_CustomMacros (dans laquelle les définitions sont stockées), puis utilisée/exécutée.

Contrairement aux requêtes enregistrées, les noms des macros personnalisées doivent être uniques et indépendants du chemin d'accès au dossier. Dans les éditions antérieures à la version 5.0, une requête enregistrée nommée A, par exemple, peut se trouver à la fois dans les dossiers D1 et D2.

Campaign prend en charge les requêtes enregistrées provenant d'éditions antérieures. Toutefois, les références à des requêtes enregistrées non uniques doivent utiliser l'ancienne syntaxe :

storedquery(<nom requête>)

Lors de la résolution de variables utilisateur dans des macros personnalisées, Campaign utilise la valeur en cours de la variable utilisateur au moment de la vérification de la syntaxe. Si la valeur en cours est laissée à blanc, Campaign génère une erreur.

Le jeton de table temporaire est une fonctionnalité avancée d'optimisation des performances qui délimite le volume de données extrait de la base de données à l'aide de l'ensemble d'ID audience figurant dans la table temporaire qui sera ensuite utilisé par le processus en cours. Cette liste d'ID dans la table temporaire peut être un sur-ensemble des identifiants de la cible en cours. Par conséquent, les fonctions d'agrégation exécutées sur la table temporaire (par exemple, moyenne ou somme) n'étant pas supportées, elles risquent de générer des résultats incorrects.

Si vous avez l'intention d'utiliser la macro personnalisée sur plusieurs bases de données différentes, vous pouvez utiliser une expression IBM ® plutôt que SQL brut, car ce dernier peut être spécifique à une base de données particulière.

Si une macro personnalisée comporte du SQL brut ainsi qu'une autre macro personnalisée, cette dernière est résolue, exécutée et renvoie une valeur avant l'exécution de SQL brut.

Campaign traite les virgules comme des séparateurs de paramètres. Si vous utilisez des virgules en tant que caractères littéraux dans un paramètre, placez le texte entre accolades ({}), comme indiqué dans l'exemple suivant :

TestCM( {STRING_CONCAT(UserVar.Test1, UserVar.Test2) } )

Campaign prend en charge la substitution simple de paramètres dans les macros personnalisées utilisant du code SQL brut. Par exemple, si vous configurez un processus Sélection dans un diagramme contenant cette requête :

exec dbms_stats.gather_table_stats(tabname=> <temptable>,ownname=> 'autodcc')

Campaign substitue la table temporaire réelle à la place du jeton <temptable>. Notez que les guillemets simples autour du nom de table sont requis.

Les tableaux suivants indiquent la façon dont Campaign traite les macros personnalisées dans les requêtes et les zones dérivées.

Macros personnalisées dans les requêtes et les zones dérivées (processus Sélection, Segment et Audience)

Type de macro personnalisée	Mode d'utilisation
SQL brut : ID	S'exécute en tant que requête distincte. La liste d'ID est fusionnée avec d'autres résultats. Si une macro personnalisée comporte d'autres macros personnalisées plus du code SQL brut, les macros personnalisées sont résolues et exécutées, puis le code SQL brut est exécuté.
SQL brut : ID + valeur	La valeur renvoyée doit normalement être utilisée dans une expression ou comme comparaison. Si la valeur n'est pas utilisée de cette manière, Campaign traite une valeur différente de zéro comme TRUE pour la sélection d'ID, tandis qu'une valeur zéro et une chaîne sont traitées comme FALSE.
Expression IBM®	L'expression est résolue et la syntaxe est vérifiée. Une requête est prise en charge pour chaque table et les ID sont mis en correspondance/fusionnés.

Dans une requête en SQL brut (processus Sélection, Segment et Audience)

Type de macro personnalisée	Mode d'utilisation
SQL brut : ID	La macro personnalisée est résolue, puis la requête est exécutée.
SQL brut : ID + valeur	Non pris en charge
Expression IBM®	L'expression est résolue, mais la syntaxe n'est pas vérifiée. Si l'expression est incorrecte, l'erreur est détectée par le serveur de base de donnée au moment de l'exécution.