Macros Format du fichier file-format-macros

Répertorie les macros que vous pouvez utiliser pour créer des fichiers de données FTP. Certaines macros peuvent être utilisées pour tous les champs et lignes du fichier de données. Les autres macros sont spécifiques aux lignes d’en-tête et 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 macro Format du fichier.

Macro
Description
ASCII_SOH
Caractère ASCII non imprimable. Elle 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 dans un fichier.
DPID
Identifiant du fournisseur de données Target.
MASTER_DPID
ID utilisateur Identifiant du fournisseur de données de clé.
ORDER_ID
ID de commande/destination.
PIDALIAS

Un alias pour un identifiant de commande/destination.

La valeur de cet alias est définie dans le champ Identifiant 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 des données. Accepte les variables facultatives suivantes :

  • ftp
  • http
  • s3
TIMESTAMP

Horodatage à 10 chiffres, UTC, Unix.

Il peut également être formaté sous la forme YYYYMMDDhhmmss suivant les règles de formatage de date/horodatage Java.

Macros 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 macro Format du fichier.

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

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

Macros utilisées dans les lignes de données uniquement. Pour obtenir des exemples, voir Exemples de macro Format du fichier.

Macro
Description
CLOSE_CURLY_BRACKET
Insère une accolade fermée } .
COMMA
Insère une virgule.
DP_UUID

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

Si le DPID est égal à 0, cette macro renvoie l’identifiant Audience Manager au lieu de votre identifiant 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 sous-divisions ou d’autres groupes organisationnels avec lesquels vous êtes autorisé à partager des données. Cette macro renvoie une liste des identifiants pour ces groupes Secondaires.
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 avoir 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. Lorsque 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 d’abord les résultats avec l’horodatage le plus grand.

endif
Requis lors de l’utilisation des macros if conditionnelles et 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 dont les utilisateurs appartiennent à et qui ont été supprimés. Elle renvoie une chaîne vide si les deux conditions ne sont pas remplies ou s’il n’y a aucune donnée.
MCID
Identifiant Adobe Experience Cloud.
OPEN_CURLY_BRACKET
Insère une accolade ouverte { .
OPT_OUT
Obsolète. N’utilisez pas .
OUTPUT_ATTRIBUTE_TYPE
Obsolète. N’utilisez pas .
OUTPUT_ATTRIBUTE_VALUE
Renvoie 1 en tant que valeur statique codée en dur.
PID
Identifiant de partenaire (PID). Le PID apparaît sous l’onglet Profil dans l’interface utilisateur d’administration.
REMOVED_SEGMENT_LIST
Renvoie une liste de segments, le cas échéant, qui ont été supprimés.
SEGMENT_LIST

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

  • segmentId: Identifiant hérité. Obsolète. Utilisez sid (en minuscules uniquement).
  • csegid: Identifiant hérité. Obsolète. Utilisez sid (en 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 (en minuscules uniquement).
  • lastUpdateTime: Horodatage Unix indiquant la dernière fois où un segment a été réalisé.

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

SET_ATTRIBUTES
Renvoie 1 en tant que valeur statique codée en dur.
TAB
Insère un séparateur d’onglet.
TRAIT_LIST

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

  • type: Types de caractéristiques identifiés 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é via le serveur de collecte de données ).
  • traitId: ID de caractéristique.

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

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

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