Voici un tableau de référence des différentes fonctions du AMPscript :
| Nom | Description |
|---|---|
| Add | Cette fonction permet de retourner la somme des valeurs fournies. |
| AddMscrmListMember | Cette fonction permet d'ajouter l'enregistrement indiqué à la liste marketing indiquée. Ne renvoie pas de valeur. |
| AddObjectArrayItem | Cette fonction permet d'ajouter un objet à un tableau sur un objet API. |
| AttachFile | Cette fonction permet de joindre un fichier à un courriel sortant et peut inclure un lien vers le fichier lorsque vous affichez le courriel en tant que page Web. Contactez votre représentant de compte Marketing Cloud pour activer les pièces jointes AMPscript pour votre compte avant d'utiliser cette fonction. Vous pouvez également contacter votre représentant de compte pour ajuster le seuil d'erreur entraînant l'arrêt prématuré de la tâche d'envoi. Cette fonctionnalité permet d'éviter qu'une seule erreur n'arrête l'ensemble du travail. |
| AttributeValue | Cette fonction permet de renvoyer la valeur d'un attribut d'abonné. |
| AuthenticatedEmployeeID | Cette fonction permet de retourner l'identificateur d'employé de l'utilisateur authentifié de la page de destination. Utilisez cette fonction uniquement avec les microsites lors de l'utilisation de la redirection authentifiée de l'expéditeur. Ne pas utiliser avec CloudPages. |
| AuthenticatedEmployeeNotificationAddress | Cette fonction permet de retourner l'adresse de courriel d'avertissement de l'utilisateur authentifié de la page de destination. Utilisez cette fonction uniquement avec les microsites lors de l'utilisation de la redirection authentifiée de l'expéditeur. Ne pas utiliser avec CloudPages. |
| AuthenticatedEmployeeUserName | Cette fonction permet de retourner le nom d'utilisateur de l'utilisateur authentifié de la page de destination. Utilisez cette fonction uniquement avec les microsites lors de l'utilisation de la redirection authentifiée de l'expéditeur. Ne pas utiliser avec CloudPages. |
| AuthenticatedEnterpriseID | Cette fonction permet de retourner l'identificateur d'entreprise de l'utilisateur authentifié de la page de destination. Utilisez cette fonction uniquement avec les microsites lors de l'utilisation de la redirection authentifiée de l'expéditeur. Ne pas utiliser avec CloudPages. |
| AuthenticatedMemberID | Cette fonction permet de retourner l'identificateur de membre de l'utilisateur authentifié de la page de destination. Utilisez cette fonction uniquement avec les microsites lors de l'utilisation de la redirection authentifiée de l'expéditeur. Ne pas utiliser avec CloudPages. |
| AuthenticatedMemberName | Cette fonction permet de retourner le nom de membre de l'utilisateur authentifié de la page de destination. Utilisez cette fonction uniquement avec les microsites lors de l'utilisation de la redirection authentifiée de l'expéditeur. Ne pas utiliser avec CloudPages. |
| BarCodeURL | Cette fonction permet de générer le code-barres spécifié à l'aide des informations fournies. Cette fonction ne prend pas en charge les codes-barres matriciels (2-D) tels que les codes QR. Utilisez cette fonction au maximum deux fois par message ou page de destination. |
| Base64Decode | Cette fonction permet de décoder les informations Base64 en texte lisible par l'homme. |
| Base64Encode | Cette fonction permet d'encoder le texte lisible par l'homme en informations Base64. |
| BeginImpressionRegion | Cette fonction permet d'indiquer le début d'une région à suivre avec le suivi des impressions. |
| BuildOptionList | Cette fonction permet de créer une liste d'options parmi lesquelles un destinataire de message peut sélectionner. Répétez les noms de valeur et de présentation pour toutes les options de la liste. |
| BuildRowSetFromString | Cette fonction permet de créer un ensemble de lignes à partir d'une chaîne de caractères en divisant la chaîne de caractères au délimiteur spécifié. |
| BuildRowSetFromXML | Cette fonction permet de créer un ensemble de lignes à partir de XML. Cette fonction peut renvoyer un ensemble de lignes vide en cas d'erreur. Cette fonction est à utiliser uniquement au moment de l'envoi. |
| Char | Cette fonction permet de retourner le caractère ASCII spécifié par le code de caractère ASCII dans le premier paramètre. Un deuxième paramètre facultatif spécifie le nombre de fois pour répéter le retour du caractère ASCII. |
| ClaimRow | Cette fonction renvoie une ligne à partir d'une extension de données et verrouille la ligne pour empêcher l'utilisation des informations dans un autre contexte jusqu'à ce que l'état revendiqué de la ligne change. Si la fonction trouve une ligne avec l'ensemble de clefs correspondant correct, la fonction renvoie ces valeurs. Si la fonction ne trouve aucune ligne revendiquée, la fonction définit des valeurs de clef dans une ligne non revendiquée et renvoie cette ligne. Si la fonction ne renvoie aucune ligne, vous devez configurer la fonction pour générer une erreur, ignorer le résultat ou fournir un contenu par défaut. Spécifiez plusieurs paires de noms de colonnes et de valeurs selon vos besoins. |
| ClaimRowValue | Cette fonction renvoie une valeur à partir d'une extension de données et verrouille la ligne pour empêcher l'utilisation des informations dans un autre contexte jusqu'à ce que l'état de la valeur revendiquée change. Si la fonction trouve une ligne avec l'ensemble de clefs correspondant correct, la fonction renvoie la valeur de colonne demandée. Si la fonction ne trouve aucune ligne réclamée, la fonction tente de réclamer une ligne inutilisée. Si la fonction ne peut pas trouver ou revendiquer la valeur, la fonction renvoie la valeur par défaut spécifiée. Sinon, la fonction renvoie une erreur. Spécifiez plusieurs paires de noms de colonnes et de valeurs selon vos besoins. |
| CloudPagesURL | Cette fonction permet de fournir aux utilisateurs un moyen de référencer une URL CloudPages dans un compte à partir d'un message électronique. Utilisez cette fonction dans un courriel pour transmettre des informations via une URL dans une chaîne de requête chiffrée. Par exemple, vous pouvez partager une seule page de désabonnement ou de centre de profil à utiliser dans n'importe quel message électronique envoyé. Cette méthode transmet les informations dans une chaîne de requête chiffrée sans transmettre les informations d'abonné ou les valeurs en texte clair. |
| Concat | Cette fonction permet de concaténer les chaînes de caractères spécifiées dans les paramètres. Incluez autant de valeurs que nécessaire. |
| ContentArea | Cette fonction permet de retourner le contenu contenu dans la zone de contenu entreposé spécifiée pour le contenu classique. Pour Content Builder, utilisez ContentBlockById. |
| ContentAreaByName | Cette fonction permet de retourner le contenu contenu dans la zone de contenu entreposée spécifiée. |
| ContentBlockbyId | Cette fonction permet de retourner le contenu contenu dans le bloc de contenu entreposé spécifié ou l'extrait de code de Content Builder, y compris le type de bloc d'image. Ces fonctions ne prennent en charge que les courriels. Pour les parties textuelles du courriel ou du message mobile, telles que l'adresse de l'expéditeur, le nom de l'expéditeur ou la ligne d'objet, référencez le bloc d'extrait de code. |
| ContentBlockbyKey | Cette fonction permet de retourner le contenu contenu dans le bloc de contenu entreposé spécifié ou l'extrait de code de Content Builder, y compris le type de bloc d'image. Ces fonctions ne prennent en charge que les courriels. Pour les parties textuelles du courriel, telles que l'adresse de l'expéditeur, le nom de l'expéditeur ou la ligne d'objet, référencez le bloc d'extrait de code. |
| ContentBlockbyName | Cette fonction permet de retourner le contenu contenu dans le bloc de contenu entreposé spécifié ou l'extrait de code de Content Builder, y compris le type de bloc d'image. Ces fonctions ne prennent en charge que les courriels. Pour les parties textuelles du courriel, telles que l'adresse de l'expéditeur, le nom de l'expéditeur ou la ligne d'objet, référencez le bloc d'extrait de code. |
| ContentImagebyID | Cette fonction permet de retourner une balise IMG avec l'attribut SRC contenant le chemin d'accès à une image de Content Builder. Identifiez l'image à inclure avec la valeur ID. La balise IMG comprend le titre et les informations ALT de l'image sélectionnée, ainsi qu'une valeur de bordure (mesurée en pixels) et toute valeur thid identifiée. Si la valeur du premier paramètre n'est pas liée à une image valide, vous pouvez inclure une autre valeur d'image pour le second paramètre comme option par défaut. À utiliser uniquement avec du contenu de type Image dans Content Builder. Cette fonction ne fonctionne pas avec le type Bloc Image. |
| ContentImagebyKey | Cette fonction permet de retourner une balise IMG avec l'attribut SRC contenant le chemin d'accès à une image de Content Builder. Identifiez l'image à inclure avec la valeur ID. La balise IMG comprend le titre et les informations ALT de l'image sélectionnée, ainsi qu'une valeur de bordure (mesurée en pixels) et toute valeur THID identifiée. Si la valeur du premier paramètre n'est pas liée à une image valide, vous pouvez inclure une autre valeur d'image pour le second paramètre comme option par défaut. À utiliser uniquement avec du contenu de type Image dans Content Builder. Cette fonction ne fonctionne pas avec le type Bloc Image. |
| CreateMscrmRecord | Cette fonction permet de créer un seul enregistrement Dynamics CRM dans l'entité cible. Renvoie le GUID de l'enregistrement créé. Incluez plusieurs paires nom/valeur si nécessaire. |
| CreateObject | Cette fonction permet de retourner un nouvel objet d'API de service Web Marketing Cloud. |
| CreateSalesforceObject | Cette fonction permet de créer un enregistrement dans votre compte Salesforce intégré et renvoie l'identificateur de l'enregistrement créé. Cette fonction fonctionne uniquement pour un compte intégré à un compte Salesforce. |
| CreateSmsConversation | Cette fonction permet de créer une conversation avec l'utilisateur MO spécifié. Utilisez cette fonction AMPscript pour MobileConnect. Vous ne pouvez pas utiliser cette fonction avec des modèles basés sur la conversation, y compris Double Opt-In ou Info Capture. Étant donné que cette fonction renvoie toujours une valeur vraie, n'utilisez pas cette fonction dans le cadre d'un flux de travail de prise de décision. |
| DataExtensionRowCount | Cette fonction permet de retourner le nombre de lignes dans l'extension de données spécifiée. Utilisez cette fonction à la place d'un appel Lookup() lorsque vous ne comptez que le nombre de lignes dans une extension de données. |
| DateAdd | Cette fonction permet de retourner la somme d'une date et d'un entier, ainsi qu'un horodatage. |
| DateDiff | Cette fonction permet de retourner la différence entre deux dates. |
| DateParse | Cette fonction permet de retourner un objet DateTime à partir d'une chaîne de caractères de date. |
| DatePart | Cette fonction permet de retourner une partie spécifiée d'une date. |
| DecryptSymmetric | Cette fonction permet de décrypter les données cryptées à l'aide de l'algorithme et des valeurs de cryptage fournis. Fournissez une valeur ou une clef externe valide pour le mot de passe, le vecteur d'initialisation (IV) et le Salt. Vous pouvez également utiliser les clefs externes si vous avez précédemment créé des clefs dans la section Gestion des clefs de l'application Marketing Cloud. Sinon, la fonction génère un mot de passe à l'aide du paramètre password ou de la valeur entreposée, du paramètre salt ou de la valeur entreposée et du paramètre IV ou de la valeur entreposée. Si vous ne transmettez pas ou ne faites pas référence à un vecteur d'initialisation, la fonction utilise le paramètre de mot de passe ou la valeur entreposée comme vecteur d'initialisation. Cette fonction traite les valeurs Salt et IV fournies directement ou recherchées par clef comme des chaînes de caractères hexadécimales, chaque paire de caractères représentant un seul octet dans les chaînes plus grandes. N'essayez pas d'utiliser ces valeurs comme chaîne de chiffrement, car vous ne pouvez pas déchiffrer ces chaînes avec succès à l'aide de cette fonction. Vous pouvez envelopper les fonctions EncryptSymmetric() et DecryptSymmetric() dans les fonctions Base64Encode() et Base64Decode() pour afficher la chaîne finale en texte brut. Vous ne pouvez utiliser la fonction AMPscript EncryptSymmetric() et DecryptSymmetric() que sur les données contenues dans Marketing Cloud. Marketing Cloud ne prend pas en charge l'utilisation de ces fonctions conjointement avec des fonctionnalités de chiffrement et de déchiffrement externes ou tierces. |
| DeleteData | Cette fonction permet de supprimer les lignes d'une extension de données avec des valeurs de colonne spécifiées dans des paires nom-valeur. Renvoie le nombre de lignes affectées. Vous pouvez également utiliser cette fonction avec des données SMS. |
| DeleteDE | Cette fonction permet de supprimer les lignes d'une extension de données avec des valeurs de colonne spécifiées dans des paires nom-valeur. Ne renvoie aucune valeur. Utilisez cette fonction avec les courriels au moment de l'envoi uniquement. |
| DescribeMscrmEntities | Cette fonction permet de retourner le nom logique et le nom d'affichage de toutes les entités Dynamics CRM. |
| DescribeMscrmEntityAttributes | Cette fonction permet de retourner le nom logique, le nom d'affichage et le type de l'entité Dynamics CRM. Les résultats incluent une liste d'options et de valeurs d'affichage séparées par des virgules lorsque l'attribut contient une valeur booléenne, d'état, de liste de sélection ou d'état. |
| Divide | Cette fonction permet de retourner le résultat de la division du premier paramètre par le deuxième paramètre. |
| Domain | Cette fonction permet de retourner la partie domaine d'une adresse de courriel. |
| Empty | Cette fonction permet de retourner True si la valeur est la chaîne de caractères vide ou NULL. |
| EncryptSymmetric | Cette fonction permet de crypter les données en texte brut à l'aide de l'algorithme et des valeurs de cryptage fournis. Vous pouvez fournir une valeur ou une clef externe valide pour le mot de passe, le vecteur d'initialisation (IV) et le Salt. Vous pouvez également utiliser les clefs externes si vous avez précédemment créé des clefs dans la section Gestion des clefs de l'interface utilisateur. Sinon, la fonction génère un mot de passe à l'aide du paramètre password ou de la valeur entreposée, du paramètre salt ou de la valeur entreposée et du paramètre IV ou de la valeur entreposée. Si vous ne transmettez pas ou ne faites pas référence à un vecteur d'initialisation, la fonction utilise le paramètre de mot de passe ou la valeur entreposée comme vecteur d'initialisation. Toutes les sorties fournies par cette fonction utilisent l'encodage Base64. Cette fonction traite les valeurs Salt et IV fournies directement ou recherchées par key comme des chaînes de caractères hexadécimales, chaque paire de caractères représentant un seul octet dans les chaînes plus grandes. N'essayez pas d'utiliser ces valeurs comme chaîne de chiffrement, car vous ne pouvez pas chiffrer ces chaînes de caractères avec succès à l'aide de cette fonction. Vous pouvez envelopper les fonctions EncryptSymmetric() et DecryptSymmetric() dans les fonctions Base64Encode() et Base64Decode() pour afficher la chaîne de caractères finale en texte brut. Vous ne pouvez utiliser la fonction AMPscript EncryptSymmetric() et DecryptSymmetric() que sur les données contenues dans Marketing Cloud. Marketing Cloud ne prend pas en charge l'utilisation de ces fonctions conjointement avec des fonctionnalités de chiffrement et de déchiffrement externes ou tierces. |
| EndImpressionRegion | Cette fonction permet d'identifier la fin d'une région à suivre par le suivi des impressions. |
| EndSmsConversation | Cette fonction permet de mettre fin à toute conversation en cours sur une réponse SMS d'un utilisateur MO. Utilisez cette fonction AMPscript pour MobileConnect. Vous ne pouvez pas utiliser cette fonction avec des modèles basés sur la conversation, y compris Double Opt-In ou Info Capture. Étant donné que cette fonction renvoie toujours une valeur vraie, n'utilisez pas cette fonction dans le cadre d'un flux de travail de prise de décision. |
| ExecuteFilter | Cette fonction permet d'exécuter un filtre de données prédéfini et renvoie un ensemble de lignes contenant les résultats. Utilisez cette fonction uniquement dans des contextes de page de destination. Vous devez utiliser une extension de données comme source de données pour le filtre de données. Cette fonction ne fonctionne pas avec les attributs de profil. |
| ExecuteFilterOrderedRows | Cette fonction permet d'exécuter un filtre de données prédéfini et renvoie un ensemble de lignes contenant les résultats. Vous devez utiliser une extension de données comme source de données pour le filtre de données. Cette fonction ne fonctionne pas avec les attributs de profil. Cette fonction vous permet également de contrôler l'ordre de tri et le nombre maximal de lignes dans l'ensemble de lignes résultant. Utilisez cette fonction uniquement avec les pages de destination et les messages SMS. |
| Field | Cette fonction permet de retourner le champ spécifié dans la ligne ou la valeur de propriété spécifiée à partir d'un objet API. |
| Format | Cette fonction permet de formater la valeur en fonction de la chaîne de caractères que vous spécifiez. |
| FormatCurrency | Cette fonction permet de formater une chaîne de caractères spécifiée en tant que valeur monétaire. Cette fonction arrondit les nombres si le format spécifié utilise moins de décimales que la valeur elle-même et si les nombres restants totalisent 5 ou plus. La fonction arrondit les nombres vers le bas si le format spécifié utilise moins de décimales que la valeur elle-même et que les nombres restants totalisent moins de 5. |
| FormatDate | Cette fonction permet de formater une chaîne de caractères spécifiée en tant que valeur de date. |
| FormatNumber | Cette fonction permet d'arrondir les nombres décimaux si le format spécifié utilise moins de points décimaux que la valeur elle-même et si les nombres restants sont supérieurs ou égaux à 5. La fonction arrondit les nombres décimaux vers le bas si le format spécifié utilise moins de points décimaux que la valeur elle-même et que les nombres restants totalisent moins de 5. Les nombres entiers en dehors de l'intervalle de -9 223 372 036 854 775 808 à 9 223 372 036 854 775 807 s'affichent en notation scientifique. |
| GetJWT | Cette fonction permet de retourner un jeton Web JSON (JWT) comprenant un hachage de la charge utile JWT créé avec une clé choisie pour permettre la vérification du contenu JWT. Il n'y a pas de cryptage de la charge utile. |
| GetJWTByKeyName | Cette fonction permet de retourner un jeton Web JSON (JWT) comprenant un hachage de la charge utile JWT créé avec un nom de clé qui correspond à une valeur CustomerKey d'un MID pour permettre la vérification du contenu JWT. Il n'y a pas de cryptage de la charge utile. |
| GetPortfolioItem | Cette fonction permet de renvoyer la valeur textuelle d'un élément de Portfolio. |
| GetPublishedSocialContent | Cette fonction permet de retourner le contenu à partager sur un réseau social tel que spécifié par l'identificateur de région. À utiliser uniquement dans les pages de destination ou la fonctionnalité Social Forward. |
| GetSocialPublishURL | Cette fonction permet de récupérer l'URL d'un réseau social à partir d'une table de recherche et crée un lien vers ce réseau social à utiliser avec le contenu à partager à partir d'un courriel. Les paires de paramètres facultatives font référence à des informations supplémentaires telles que les numéros d'identification et les connexions de l'éditeur ShareThis. Vous pouvez inclure plusieurs paires nom/valeur. Utilisez cette fonction avec la fonction Social Forward. |
| GetSocialPublishURLByName | Cette fonction permet de retourner l'URL de la page de contenu de publication, y compris un nom de site, un code de pays, un ID de région et des paires facultatives d'informations de paramètre, telles que les informations d'ID ShareThis. Inclut plusieurs paires nom/valeur. À utiliser avec la fonction Social Forward de Marketing Cloud. |
| GUID | Cette fonction permet de retourner un nouveau GUID sous forme de valeur de chaîne de caractères. |
| HTTPGet | Cette fonction permet de retourner le contenu d'une URL spécifiée. Cette fonction fonctionne uniquement avec HTTP sur le port 80 et HTTPS sur le port 443. Les affectations de port non standard entraînent l'échec de cette fonction. Marketing Cloud respecte tout ensemble de caractères renvoyé dans les entêtes HTTP via Content-Type. Par exemple, vous pouvez utiliser un fichier HTML encodé en UTF-8 avec Content-Type: text/html ; charset=utf-8 inclus dans l'entête. Si l'encodage n'est pas spécifié dans l'entête, l'application suppose que toutes les données renvoyées seront dans l'ensemble de caractères WindowsCodePage 1252. Vous pouvez modifier cette valeur par défaut en contactant votre représentant de compte Marketing Cloud. |
| HTTPPost | Cette fonction permet de publier du contenu sur l'URL spécifiée. Cette fonction fonctionne uniquement avec HTTP sur le port 80 et HTTPS sur le port 443. Les affectations de port non standard entraînent l'échec de cette fonction. Marketing Cloud respecte tout ensemble de caractères renvoyé dans les entêtes HTTP via Content-Type. Par exemple, vous pouvez utiliser un fichier HTML encodé en UTF-8 avec Content-Type : text/html ; charset=utf-8 inclus dans l'entête. Si l'entête ne spécifie pas d'encodage, l'application suppose que toutes les données renvoyées utiliseront l'ensemble de caractères WindowsCodePage 1252. Vous pouvez modifier cette valeur par défaut en contactant votre représentant de compte Marketing Cloud. Incluez autant de paires de nom d'entête et de valeur que nécessaire. |
| HTTPPost2 | Cette fonction permet de publier du contenu sur l'URL spécifiée. Cette fonction fonctionne uniquement avec HTTP sur le port 80 et HTTPS sur le port 443. Les affectations de port non standard entraînent l'échec de cette fonction. Marketing Cloud respecte tout ensemble de caractères renvoyé dans les entêtes HTTP via Content-Type. Par exemple, vous pouvez utiliser un fichier HTML encodé en UTF-8 avec Content-Type : text/html ; charset=utf-8 inclus dans l'entête. Si l'entête ne spécifie pas le type d'encodage, l'application suppose que toutes les données renvoyées utilisent l'ensemble de caractères WindowsCodePage 1252. Modifiez cette valeur par défaut en contactant votre représentant de compte Marketing Cloud. Incluez autant de paires nom/valeur que nécessaire. |
| HTTPRequestHeader | Cette fonction permet de récupérer l'entête spécifié d'une requête HTTP. Vous ne pouvez utiliser que les en-têtes HTTP standard décrits dans la RFC 7231 avec cette fonction. À utiliser uniquement dans les pages de destination. |
| IIf | Cette fonction permet de retourner le deuxième paramètre si le premier paramètre vaut True. Renvoie le troisième paramètre si le premier paramètre vaut False. |
| Image | Cette fonction permet de retourner une balise IMG avec l'attribut SRC contenant le chemin vers une image de votre portfolio. Identifiez l'image à inclure avec la valeur de clef externe. La balise IMG comprend le titre et les informations ALT de l'image sélectionnée, ainsi qu'une valeur de bordure mesurée en pixels et toute valeur identifiée. |
| IndexOf | Cette fonction permet de retourner la position du caractère où la chaîne apparaît dans la variable. La numérotation de l'index commence par 1. |
| InsertData | Cette fonction permet d'insérer une ligne dans une extension de données. Renvoie le nombre de lignes affectées. Utilisez cette fonction avec les pages d'accueil, les messages SMS et MMS dans MobileConnect, les messages push dans MobilePush et les messages dans GroupConnect. |
| InsertDE | Cette fonction permet d'insérer une ligne dans une extension de données avec les valeurs de colonne répertoriées dans des paires nom/valeur. Vous pouvez inclure plusieurs paires nom/valeur si nécessaire. Ne renvoie aucune valeur. Utilisez cette fonction avec les courriels au moment de l'envoi uniquement. Aucune valeur n'est renvoyée. Cette fonction s'applique aux courriels au moment de l'envoi uniquement. |
| InvokeCreate | Cette fonction permet d'appeler la méthode Create sur un objet API. Renvoie le code d'état de l'API. |
| InvokeDelete | Cette fonction permet d'appeler la méthode Delete sur un objet API. Renvoie le code d'état de l'API. |
| InvokeExecute | Cette fonction permet d'appeler la méthode Execute sur un objet API. Renvoie le code d'état de l'API. |
| InvokePerform | Cette fonction permet d'appeler la méthode Perform sur un objet API. Renvoie le code d'état de l'API. |
| InvokeRetrieve | Cette fonction permet de retourner un tableau d'objets API à partir d'un objet RetrieveRequest. |
| InvokeUpdate | Cette fonction permet d'appeler la méthode Update sur un objet API. |
| IsCHTMLBrowser | Cette fonction permet d'indiquer si la valeur d'agent utilisateur transmise représente un navigateur CHTML. Les navigateurs CHTML, tels que ceux trouvés sur les téléphones polyvalents, utilisent une version modifiée de HTML pour afficher des informations sur des écrans plus petits avec moins de ressources que les téléphones intelligents. Renvoie une valeur true ou false indiquant si le navigateur utilise CHTML. Utilisez cette valeur pour déterminer s'il faut ou non afficher le contenu CHTML. À utiliser uniquement avec les pages de destination. |
| IsEmailAddress | Cette fonction permet de retourner un résultat true ou false indiquant si la valeur de chaîne transmise contient une adresse de courriel valide. Cette fonction utilise la même logique de validation des courriels que le reste de l'application. |
| IsNull | Cette fonction permet de retourner une valeur true si le paramètre spécifié est nul. |
| IsNullDefault | Cette fonction permet de retourner les données de test lorsqu'elles ne sont pas nulles. Si null, la fonction renvoie la valeur spécifiée. Les formulaires Smart Capture utilisent cette fonction pour renvoyer une valeur par défaut pour une valeur de formulaire Smart Capture vide ou inexistante. |
| IsPhoneNumber | Cette fonction permet de retourner un résultat true ou false indiquant si la valeur de chaîne transmise est un numéro de téléphone valide. Cette fonction utilise la même validation de numéro de téléphone que les composants SMS de l'application. |
| Length | Cette fonction permet de retourner le nombre de caractères dans la chaîne de caractères spécifiée. |
| LiveContentMicrositeURL | Cette fonction permet de fournir un moyen de renvoyer une URL de microsite en faisant référence à un nom de coupon hébergé sur un microsite. |
| LocalDateToSystemDate | Cette fonction permet de convertit une chaîne de caractères ou un objet datetime local en heure système. |
| LongSFID | Cette fonction permet de retourner l'identificateur Salesforce à 18 caractères à partir d'une version abrégée à 15 caractères. |
| Lookup | Cette fonction permet de retourner la valeur spécifiée à partir d'une extension de données. Vous pouvez spécifier plusieurs paires champ/valeur supplémentaires dans le cadre d'une clause AND. |
| LookupOrderedRows | Cette fonction permet de retourner un nombre spécifié de lignes. Vous pouvez spécifier plusieurs paires champ/valeur supplémentaires dans le cadre d'une clause AND. La fonction renvoie un ensemble vide lorsqu'aucune valeur ne correspond. |
| LookupRows | Cette fonction permet de retourner un ensemble de lignes à partir d'une extension de données où le champ correspond à la valeur spécifiée. Spécifiez des paires de valeurs de champ supplémentaires dans le cadre d'une clause AND. Cette fonction renvoie un maximum de 2000 lignes. Pour mieux contrôler le nombre ou l'ordre des lignes renvoyées, utilisez la fonction LookupOrderedRows(). Cette limitation améliore les performances du script. |
| LookupRowsCS | Cette fonction permet de retourner un ensemble de lignes à partir d'une extension de données où le champ correspond à la valeur spécifiée. Le système traite les chaînes de caractères comme sensibles à la casse. Spécifiez des paires de valeurs de champ supplémentaires dans le cadre d'une clause AND. Cette fonction renvoie un maximum de 2000 lignes. Pour mieux contrôler le nombre ou l'ordre des lignes renvoyées, utilisez la fonction LookupOrderedRowsCS(). Cette limitation améliore les performances du script. |
| Lowercase | Cette fonction permet de retourner la valeur spécifiée dans toutes les lettres minuscules. |
| MD5 | Cette fonction permet de convertir une chaîne de caractères en une valeur de hachage MD5 de 16 octets. Cette fonction renvoie une représentation hexadécimale du résultat de hachage MD5 de 16 octets. Cette conversion de hachage unidirectionnelle ne permet pas un décryptage ultérieur. |
| MicrositeURL | Cette fonction permet aux utilisateurs d'Enterprise 2.0 de référencer une URL de page d'arrivée dans l'unité commerciale de niveau supérieur d'un compte Enterprise 2.0 à partir d'un message électronique dans n'importe quelle unité commerciale enfant du même compte Enterprise 2.0. Utilisez cette fonction dans un courriel pour transmettre des informations via une URL dans une chaîne de requête chiffrée. Par exemple, vous pouvez partager une seule page de désabonnement ou de centre de profil à partir du compte de niveau supérieur pour une utilisation dans les courriels envoyés à partir de n'importe quelle unité commerciale enfant de ce compte. Cette méthode transmet les informations dans une chaîne de requête chiffrée sans transmettre les informations d'abonné ou les valeurs en texte clair. |
| Mod | Cette fonction permet de retourner le reste après avoir divisé le premier nombre par le deuxième nombre. |
| Multiply | Cette fonction permet de retourner le produit de la multiplication de deux nombres. |
| Now | Cette fonction permet de retourner la date et l'heure actuelles du système (serveur). Lorsqu'elle est incluse dans le contenu des envois déclenchés, l'heure indique quand la définition d'envoi déclenché pour le message a démarré ou republié. L'heure ne reflète pas le moment où l'envoi s'est réellement produit. Now() est en heure normale du Centre (CST) sans heure d'été. |
| Output | Cette fonction permet de retourner les résultats du code AMPscript exécuté dans un bloc de code, tel que Concat() ou V(), et inclut les résultats dans le contenu rendu. La fonction ne renvoie aucun littéral direct passé. |
| OutputLine | Cette fonction permet de retourner les résultats du code AMPscript exécuté dans un bloc de code, tel que Concat() ou V()), et inclut les résultats dans le contenu rendu. La fonction ajoute également un CRLF après les résultats. La fonction ne renvoie aucun littéral direct passé. |
| ProperCase | Cette fonction permet de retourner la chaîne de caractères spécifiée avec la lettre initiale de chaque mot en majuscule. |
| QueryParameter | Cette fonction permet de récupérer la valeur d'une chaîne de caractères de requête, en fonction de la clef définie pour celle-ci. Utilisez cette fonction pour fournir des informations sur les utilisateurs visitant un site via l'URL. |
| RaiseError | Cette fonction permet de lever l'erreur indiquée dans la chaîne de caractères et arrête le traitement du travail. Si l'option B1 est incluse avec la valeur true, cette fonction arrête l'envoi pour l'abonné actuel uniquement. |
| Random | Cette fonction permet de retourner un entier aléatoire entre les valeurs que vous spécifiez, incluses. |
| Redirect | Cette fonction permet de rediriger le navigateur du destinataire vers l'URL spécifiée. |
| RedirectTo | Cette fonction permet à un client de spécifier la cible d'un lien provenant d'une URL complète stockée dans un attribut, un champ d'extension de données ou une variable. N'utilisez cette fonction que dans les courriels HTML dans l'attribut href d'une balise <a>. Dans les courriels texte, incluez le préfixe http:// et assurez-vous de n'utiliser aucun espace entre les parenthèses. Afin de conserver les informations de suivi des liens cliqués, vous devez inclure les balises d'ancrage <a<a< dans le courriel lui-même et non dans le lien récupéré via AMPscript. Cette fonction fournit uniquement des informations de suivi pour les liens cliquables dans un message électronique. Vous ne pouvez pas récupérer les informations de suivi lorsque vous utilisez cette fonction avec des URL entreposées dans une variable ou utilisées dans le cadre d'un paramètre de chaîne de requête. |
| RegExMatch | Cette fonction permet d'utiliser une expression régulière pour rechercher des informations dans une chaîne de caractères. Utilisez n'importe quelle valeur de l'énumération RegexOptions de .NET , telle que IgnoreCase et Multiline. |
| Replace | Cette fonction permet de remplacer la première valeur de chaîne par la deuxième valeur de chaîne de caractères partout où elle se trouve dans la variable. |
| ReplaceList | Cette fonction permet de rechercher une valeur de chaîne de caractères pour une ou plusieurs valeurs de chaîne que vous spécifiez et remplace ces valeurs par une autre valeur de chaîne de caractères. |
| RequestParameter | Cette fonction permet de retourner la valeur d'un paramètre transmis dans la chaîne de requête d'une URL de page de destination ou transmis via une publication de formulaire. |
| RetrieveMscrmRecords | Cette fonction permet de récupérer plusieurs enregistrements CRM. Utilisez des champs dans l'entité cible ou sélectionnez des champs à partir d'entités associées à l'aide d'attributs de recherche plusieurs-à-un. |
| RetrieveMscrmRecordsFetchXML | Cette fonction permet de prendre une requête Fetch XML correctement formée et renvoie les attributs spécifiés dans la requête. |
| RetrieveSalesforceJobSources | Cette fonction permet de retourner un ensemble de lignes avec les colonnes SourceID, SourceType et IsInclusionSource de la tâche avec l'identificateur spécifié. Cette fonction fonctionne uniquement avec la version 2 de l'intégration Salesforce avec Marketing Cloud. Cette fonction ne renvoie aucune information sur l'état du travail lui-même. Par exemple, la fonction renvoie les mêmes informations d'un travail terminé que d'un travail démarré puis annulé. N'utilisez pas ces informations comme une garantie que l'envoi a été effectué. Étant donné que cette fonction renvoie des données sous forme d'ensemble de lignes, utilisez Row() et Field() pour évaluer les données. |
| RetrieveSalesforceObjects | Cette fonction permet de retourner un ensemble de lignes avec les informations sélectionnées à partir des objets Salesforce correspondant aux critères que vous spécifiez. Cette fonction fonctionne uniquement avec un compte intégré à un compte Salesforce. Incluez plusieurs ensembles d'ordinaux 3, 4 et 5 pour récupérer les informations nécessaires. Étant donné que cette fonction renvoie des données sous forme d'ensemble de lignes, utilisez Row() et Field() pour évaluer les données. |
| Row | Cette fonction permet de retourner la ligne spécifiée à partir de l'ensemble de lignes ou du tableau spécifié. |
| RowCount | Cette fonction permet de retourner le nombre de lignes dans l'ensemble de lignes ou le tableau spécifié. |
| SetObjectProperty | Cette fonction permet de définir une valeur pour un objet créé par la fonction CreateObject. |
| SetSmsConversationNextKeyword | Cette fonction permet de définir le mot clef pour le chemin de conversation suivant en fonction d'une réponse SMS d'un utilisateur MO. Utilisez le mot-clef actuel ou un nouveau mot-clef pour un chemin de conversation différent. Vous pouvez utiliser cette fonction AMPscript pour MobileConnect. Cette fonction ne crée pas de nouvelle conversation. SetSMSConversationNextKeyword dirige la conversation en cours vers le mot-clef suivant à utiliser dans le cadre de cette conversation globale. Vous ne pouvez pas utiliser cette fonction avec des modèles basés sur la conversation, y compris Double Opt-In ou Info Capture. |
| SetStateMscrmRecord | Cette fonction permet de définir l'état et le statut de l'enregistrement indiqué et fournit -1 comme valeur d'état pour l'état par défaut de l'état. Ne renvoie aucune valeur. Certaines entités, y compris Opportunity, nécessitent des demandes CRM spéciales pour modifier leur état. Cette fonction ne fonctionnera pas pour ces entités. |
| SHA1 | Cette fonction permet de retourner un hachage SHA1 basé sur la valeur de chaîne transmise via la fonction. La balise de hachage SHA1 renvoie une valeur hexadécimale. |
| SHA256 | Cette fonction permet de retourner une balise de hachage SHA256 basée sur la valeur de chaîne de caractères transmise via la fonction. |
| SHA512 | Cette fonction permet de retourner une balise de hachage SHA512 basée sur la valeur de chaîne transmise via la fonction. |
| StringToDate | Cette fonction permet d'analyser une chaîne de caractères datetime avec les paramètres actuels de l'utilisateur et renvoie un objet datetime de .NET. |
| StringToHex | Cette fonction permet de retourner la chaîne hexadécimale d'octets qui composent une valeur de chaîne de caractères. |
| Substring | Cette fonction permet de retourner la partie de la chaîne spécifiée commençant par la position de caractère spécifiée et ne dépassant pas la longueur spécifiée. Si la position de caractère spécifiée dépasse la longueur de la chaîne spécifiée, la fonction renvoie une chaîne vide. |
| Subtract | Cette fonction permet de retourner la différence de deux entiers. |
| SystemDateToLocalDate | Cette fonction permet de convertir une chaîne de caractères ou un objet datetime système en heure locale de l'utilisateur Marketing Cloud. |
| TransformXML | Cette fonction permet d'appliquer une transformation XSL à un document XML. |
| TreatAsContent | Cette fonction permet de traiter la chaîne de caractères comme si elle provenait d'une zone de contenu. Pour récupérer les informations de suivi associées à ces chaînes de caractères, encapsulez les liens intégrés dans votre contenu HTML à l'aide de la commande HTTPGETWRAP pour le suivi et l'analyse. Utilisez la fonction TreatAsContentArea() pour traiter votre chaîne de caractères comme si elle provenait d'une zone de contenu. |
| TreatAsContentArea | Cette fonction permet de traiter le contenu extrait d'une extension de données ou d'une autre source comme s'il s'agissait d'un contenu fixe provenant d'une zone de contenu. |
| Trim | Cette fonction permet de retourner la valeur du paramètre de chaîne avec les espaces blancs de début et de fin supprimés. |
| UpdateData | Cette fonction permet de mettre à jour une ligne existante dans une extension de données pour le nombre spécifié de colonnes utilisées pour créer la clause WHERE répertoriée dans les paires nom-valeur, suivie d'une liste de colonnes à mettre à jour dans les paires nom-valeur. Renvoie le nombre de lignes affectées. Utilisez cette fonction uniquement avec les pages de destination et les messages SMS. |
| UpdateDE | Cette fonction permet de mettre à jour une ligne existante dans une extension de données pour le nombre spécifié de colonnes utilisées pour créer la clause WHERE répertoriée dans les paires nom-valeur, suivie d'une liste de colonnes à mettre à jour dans les paires nom-valeur. Ne renvoie aucune valeur. Utilisez cette fonction avec les courriels au moment de l'envoi uniquement. |
| UpdateMscrmRecords | Cette fonction permet de mettre à jour un ou plusieurs enregistrements dans une entité Dynamics CRM. Renvoie également le nombre d'enregistrements mis à jour avec succès. Incluez plusieurs paires nom/valeur pour les attributs à mettre à jour sur les enregistrements cibles si nécessaire. |
| UpdateSingleSalesforceObject | Cette fonction permet de mettre à jour un enregistrement dans un objet de votre compte Salesforce intégré. Vous pouvez spécifier plusieurs paires champ/valeur supplémentaires dans le cadre d'une clause AND. Renvoie 1 en cas de succès ou 0 en cas d'échec. |
| Uppercase | Cette fonction permet de retourner la valeur spécifiée dans toutes les lettres majuscules. |
| UpsertContact | Cette fonction permet de mettre à jour un contact existant dans le canal spécifié avec la clef primaire et la valeur de clef primaire spécifiées. Répertoriez autant de noms d'attributs et de valeurs d'attributs que nécessaire. |
| UpsertData | Cette fonction permet de mettre à jour une ligne existante dans une extension de données pour le nombre spécifié de colonnes de filtre répertoriées dans des paires nom-valeur, suivies d'une liste de colonnes à mettre à jour dans des paires nom-valeur. Si aucune donnée n'existe dans cette ligne, la fonction insère une ligne. La fonction renvoie le nombre de lignes affectées. Vous pouvez inclure plusieurs paires nom/valeur pour créer vos clauses WHERE et INSERT. Utilisez cette fonction uniquement avec les pages de destination et les messages SMS. |
| UpsertDE | Cette fonction permet de mettre à jour une ligne existante dans une extension de données pour le nombre spécifié de colonnes de filtre répertoriées dans des paires nom-valeur, suivies d'une liste de colonnes à mettre à jour dans des paires nom-valeur. Si aucune donnée n'existe dans cette ligne, la fonction insère une ligne. La fonction renvoie le nombre de lignes affectées. Vous pouvez inclure plusieurs paires nom/valeur pour créer vos clauses WHERE et INSERT. Utilisez cette fonction avec les courriels au moment de l'envoi uniquement. |
| UpsertMscrmRecord | Cette fonction permet de récupérer un enregistrement unique à partir de Dynamics CRM, en utilisant les paires nom et valeur pour filtrer les résultats. La fonction trie ensuite les résultats à l'aide du champ de tri et de l'ordre fournis. Le processus met à jour un enregistrement trouvé avec les paires nom/valeur applicables. Si le processus ne trouve pas d'enregistrement, il en crée un avec toutes les paires nom/valeur fournies. Cette fonction renvoie le GUID de l'enregistrement mis à jour ou créé. |
| URLEncode | Cette fonction permet de retourner l'URL spécifiée avec des espaces remplacés par %20 ou encode entièrement tous les caractères non alphanumériques. |
| V | Cette fonction permet d'afficher la valeur d'une variable. |
| WAT | Cette fonction permet de retourner les valeurs du paramètre Web Analytics Tracking (WAT) avec la clef externe spécifiée. Contactez le support Marketing Cloud pour définir les valeurs de clef externe dans le connecteur Web Analytics. La fonction remplace les appels à la fonction WATP par des paramètres facultatifs dans le paramètre de suivi défini dans le profil de l'expéditeur. Les valeurs de variable, d'attribut, de champ et de faction ne permettent pas la résolution au niveau de la tâche des paramètres de chaîne de requête de lien souhaités. |
| WATP | Cette fonction permet de retourner les valeurs du paramètre Web Analytics Tracking (WAT) avec la clef externe spécifiée. Contactez le support Marketing Cloud pour définir les valeurs de clef externe dans le connecteur Web Analytics. Les paramètres d'appel WAT doivent utiliser des valeurs constantes ou numériques. Les valeurs de variable, d'attribut, de champ et de faction ne permettent pas la résolution au niveau de la tâche des paramètres de chaîne de requête de lien souhaités. |
| WrapLongURL | Cette fonction permet de retourner une URL encapsulée pour l'URL longue fournie dans le paramètre de chaîne de la fonction. Vous ne pouvez modifier que les URL de plus de 975 caractères, et cette fonction ne remplace pas la fonctionnalité d'habillage de lien standard implémentée dans l'application Marketing Cloud. Utilisez cette fonction pour atténuer une limitation connue avec des URL longues dans Outlook 2007 et des URL telles que celles incluses dans une balise de source d'image. |
Dernière mise à jour : Vendredi, le 23 juin 2023