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.
ASCII_SOH
DPID
MASTER_DPID
ORDER_ID
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.
TAB
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.
CLOSE_CURLY_BRACKET
}
.COMMA
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
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
if
conditionnelles et SEGMENT_LIST
et REMOVED_SEGMENT_LIST
.if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
MCID
OPEN_CURLY_BRACKET
{
.OPT_OUT
OUTPUT_ATTRIBUTE_TYPE
OUTPUT_ATTRIBUTE_VALUE
1
en tant que valeur statique codée en dur.PID
REMOVED_SEGMENT_LIST
SEGMENT_LIST
Renvoie une liste de segments dans une liste. Accepte les variables facultatives suivantes :
segmentId
: Identifiant hérité. Obsolète. Utilisezsid
(en minuscules uniquement).csegid
: Identifiant hérité. Obsolète. Utilisezsid
(en minuscules uniquement).sid
: Identifiant du segment.type
: Renvoie5
, 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. Utilisezsid
(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
1
en tant que valeur statique codée en dur.TAB
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