DocumentationAudience ManagerGuide de l’administrateur

Macros de format de fichier file-format-macros

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Répertorie les macros que vous pouvez utiliser pour créer des fichiers de données basés sur FTP. Certaines macros peuvent être utilisées pour tous les champs et lignes du fichier de données. Les autres macros sont spécifiques à l’en-tête et aux lignes de données uniquement.

Macros courantes common-macros

Ces macros peuvent être utilisées dans n’importe quel champ de format. Pour obtenir des exemples, voir Exemples de macros au format de fichier.

Macro
Description
ASCII_SOH
Caractère ASCII non imprimable. Indique le début d’une ligne ou d’une section de contenu. Il peut également être utilisé pour séparer les colonnes de données d’un fichier.
DPID
ID du fournisseur de données cible.
MASTER_DPID
ID utilisateur ID de fournisseur de données de clé.
ORDER_ID
Identifiant de la commande/destination.
PIDALIAS

Alias pour un identifiant de commande/destination.

La valeur de cet alias est définie dans le champ de l’ID de compte étranger pour une destination (dans la section Paramètres de base ).

SYNC_MODE

Indique le type de synchronisation. Accepte les variables facultatives suivantes :

  • full : synchronisation complète.
  • iter : synchronisation incrémentielle.
SYNC_TYPE

Indique la méthode de transfert de données. Accepte les variables facultatives suivantes :

  • ftp
  • http
  • s3
TIMESTAMP

Horodatage Unix, UTC, à 10 chiffres.

Il peut également être formaté comme YYYYMMDDhhmmss règles de formatage de date/heure Java suivantes.

Macros de champ d’en-tête header-field-macros

Macros utilisées uniquement dans les champs d’en-tête. Pour obtenir des exemples, voir Exemples de macros au format de fichier.

Macro
Description
TAB
Utilisée comme séparateur, cette macro insère une tabulation entre les champs.

Macros de ligne de données data-row-macros

Macros utilisées uniquement dans les lignes de données. Pour obtenir des exemples, voir Exemples de macros au format de fichier.

Macro
Description
CLOSE_CURLY_BRACKET
Insère un crochet fermé } caractère.
COMMA
Insère une virgule.
DP_UUID

d’identifiant d’utilisateur unique du partenaire de données . Renvoie l’ID que vous avez attribué à un utilisateur/visiteur du site si cet ID a déjà été synchronisé avec un ID d’appareil Audience Manager .

Si le DPID est 0, cette macro renvoie l’ID de Audience Manager au lieu de votre ID pour l’utilisateur.

DP_UUID_LIST
Renvoie une liste contenant plusieurs identifiants pour un partenaire de données. Cela s’avère utile si vous disposez d’une grande organisation avec plusieurs subdivisions ou d’autres groupes organisationnels avec lesquels vous êtes autorisé à partager des données. Cette macro renvoie une liste des identifiants de ces groupes subordonnés.
DPUUIDS

La sortie de cette macro mappe l'ID de fournisseur de données (DPID) aux ID d'utilisateur uniques associés (DPUUID). Cette macro doit comporter une chaîne de formatage pour contrôler sa sortie. L’exemple de sortie ressemblerait à ce qui suit :

"dpids=dpid1,dpid2,...dpid n|maxMappings= n|format=json"

Le paramètre maxMappings détermine le nombre de mappages que la macro doit renvoyer. Lorsqu’elle est maxMappings=0, cette macro renvoie tous les mappages pour chaque DPID spécifié. Les données sont triées par horodatage (le plus récent en premier) et renvoie les résultats avec l’horodatage le plus grand en premier.

endif
Obligatoire lors de l’utilisation de la if conditionnelle et des macros SEGMENT_LIST et REMOVED_SEGMENT_LIST.
if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
Cette combinaison de macros crée une instruction conditionnelle qui répertorie les segments auxquels appartiennent les utilisateurs et à partir desquels ils ont été supprimés. Elle renvoie une chaîne vide si les deux conditions ne sont pas remplies ou s’il n’existe aucune donnée.
MCID
Adobe Experience Cloud ID.
OPEN_CURLY_BRACKET
Insère un crochet ouvert { caractère.
OPT_OUT
Obsolète. Ne pas utiliser.
OUTPUT_ATTRIBUTE_TYPE
Obsolète. Ne pas utiliser.
OUTPUT_ATTRIBUTE_VALUE
Renvoie 1 sous la forme d’une valeur statique codée en dur.
PID
Identifiant partenaire (PID). Le PID s’affiche sous l’onglet de profil dans l’interface utilisateur d’administration.
REMOVED_SEGMENT_LIST
Renvoie une liste des segments qui ont été supprimés, le cas échéant.
SEGMENT_LIST

Renvoie une liste de segments dans une liste. Accepte les variables facultatives suivantes :

  • segmentId : ID hérité. Obsolète. Utilisez sid (minuscules uniquement).
  • csegid : ID hérité. Obsolète. Utilisez sid (minuscules uniquement).
  • sid : identifiant du segment.
  • type : renvoie 5, une valeur statique codée en dur qui identifie les données en tant que données de segment.
  • alias : mappage du segment. Obsolète. Utilisez sid (minuscules uniquement).
  • lastUpdateTime : horodatage Unix qui indique la dernière fois qu’un segment a été réalisé.

Placez ces variables entre crochets après la macro. Par exemple, ce code sépare les résultats avec une barre verticale « | » : <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator="|">

SET_ATTRIBUTES
Renvoie 1 sous la forme d’une valeur statique codée en dur.
TAB
Insère un séparateur de tabulations.
TRAIT_LIST

Renvoie une liste de caractéristiques. Accepte les arguments optionnels suivants :

  • type : types de caractéristiques identifiées par un identifiant numérique. Cette variable renvoie :

    • 10 qui identifie une caractéristique DPM (hors ligne, intégrée par une tâche entrante).
    • 3 qui identifie une caractéristique basée sur des règles (en temps réel, intégrée à l’aide du DCS ).

  • traitId : ID de caractéristique.

  • lastRealized : Dernière fois que la caractéristique a été réalisée. Horodatage Unix.

Placez ces variables entre crochets après la macro. Par exemple, ce code sépare les résultats avec une barre verticale « | » : TRAIT_LIST{type|traitId};separator="|"

UUID
l’ID d’utilisateur d’Audience Manager.
recommendation-more-help
3d9f8cff-f6d8-4dcd-966c-cf2ea03db934