Macros de création de modèles sortants (en anglais)

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

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

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 proche } .

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 Secondaires.

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

Identifiant Adobe Experience Cloud.

OPEN_CURLY_BRACKET

Insère une accolade ouverte { .

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 en tant que données de segment.
  • alias : Obsolète. N’utilisez pas .
  • 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 , sous la forme d’une 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. Retours:
    • 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 : 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:{trait|<trait.Id>,<trait.lastRealized>};separator=","

UUID

ID utilisateur de l’Audience Manager.

Sur cette page