Macros de modèles sortants outbound-template-macros

Répertorie les macros que vous pouvez utiliser pour créer des modèles sortants. Il s’agit notamment des macros de nom de fichier, des macros d’en-tête et des macros de contenu.

Macros Nom de fichier et En-tête de fichier file-name-header-macros

Le tableau répertorie et décrit les macros que vous pouvez utiliser dans le nom du fichier et pour définir les champs d’en-tête. Pour des exemples de code, voir Exemples de macro sortante.

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.
MASTER_DPID
ID utilisateur Identifiant du fournisseur de données de clé.
NEW_LINE
Permet la création d’en-têtes multi-lignes pour les commandes sortantes.
ORDER_ID
ID de commande/destination.
PID_ALIAS

Un alias pour un identifiant de commande/destination.

L’alias est défini dans l’interface utilisateur d’administration.

SPLITNUM

Indique la division des fichiers sortants en plusieurs parties. Remplacez la section SPLITNUM du nom de fichier par le numéro de pièce précédé de zéros, garantissant un minimum de trois caractères pour la section SPLITNUM.

La macro SPLITNUM n’a pas besoin d’être entourée de caractères <>.

Exemple : <SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>SPLITNUM.csv

s3_123456_9999_full_1566906141001.csv

s3_123456_9999_full_1566906141002.csv

s3_123456_9999_full_1566906141003.csv

Les trois derniers chiffres (001 002 003) dans les exemples ci-dessus sont les identifiants SPLITNUM.

SYNC_MODE

Indique le type de synchronisation et inclut :

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

Indique la méthode de transfert des données et inclut :

  • ftp
  • http
  • s3
TAB
Utilisée comme séparateur, cette macro insère un onglet entre les champs.
TIMESTAMP

Horodatage à 10 chiffres, UTC, Unix.

Il peut également être formaté sous la forme <TIMESTAMP; format="YYYYMMDDhhmmss"> suivant les règles de formatage de date/horodatage Java.

Macros de contenu content-macros

Macros utilisées pour formater le contenu d’un fichier de données. Pour des exemples de code, voir Exemples de macro sortante.

Macro
Description
CLOSE_CURLY_BRACKET
Insère une accolade de fermeture } .
DP_UUID

Identifiant utilisateur unique du fournisseur de données .

Il s’agit de l’identifiant du partenaire de données auquel vous envoyez des données dans un fichier sortant.

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 subordonnés.
DPID
Identifiant du fournisseur de données.
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.

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
Cette combinaison de macros crée une instruction conditionnelle qui répertorie les segments auxquels les utilisateurs appartiennent et dont ils 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
Adobe Experience Cloud ID.
OPEN_CURLY_BRACKET
Insère un caractère d’accolade ouvert {.
OPT_OUT
Obsolète. N’utilisez pas .
ORDER_ID
ID de commande ou de destination.
OUTPUT_ATTRIBUTE_TYPE
Obsolète. N’utilisez pas .
OUTPUT_ATTRIBUTE_VALUE
Renvoie 1 en tant que valeur statique codée en dur.
PID
Identifiant du partenaire.
PIDALIAS

Un alias pour un identifiant de commande/destination.

L’alias est défini 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 arguments facultatifs suivants :

  • segmentId : identifiant du segment. Obsolète. Utilisez sid .
  • csegid : identifiant du segment client. Obsolète. Utilisez sid .
  • sid : identifiant de segment
  • type : renvoie 5 , une valeur statique codée en dur qui identifie les données comme des données de segment.
  • alias : obsolète. N’utilisez pas .
  • lastUpdateTime : horodatage Unix indiquant l’état de la dernière mise à jour de l’adhésion au segment.
  • lastRealizationTime : horodatage Unix indiquant la dernière fois qu’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 , sous forme de valeur statique codée en dur.
SYNC_MODE

Indique le type de synchronisation et inclut :

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

Indique la méthode de transfert des données et inclut :

  • ftp
  • http
  • s3
TAB
Utilisée comme séparateur, cette macro insère un onglet entre les champs.
TRAIT_LIST

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

  • type : identifie les types de caractéristiques par identifiant numérique. 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 via le serveur de collecte de données).
  • traitId : identifiant de la caractéristique.

  • lastRealized : 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:{trait|<trait.Id>,<trait.lastRealized>};separator=","

UUID
ID utilisateur de l’Audience Manager .
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695