Ausgehende Vorlagenmakros

Letzte Aktualisierung: 2022-06-28

Listet die Makros auf, mit denen Sie ausgehende Vorlagen erstellen können. Dazu gehören Dateinamenmakros, Kopfzeilenmakros und Inhaltsmakros.

Dateiname und Dateikopfzeilen-Makros

In der Tabelle werden die Makros aufgelistet und beschrieben, die Sie im Dateinamen verwenden können, sowie zur Definition von Kopfzeilenfeldern. Codebeispiele finden Sie unter Beispiele für ausgehende Makros.

Makro Beschreibung

ASCII_SOH

Ein nicht druckbares ASCII-Zeichen. Er gibt den Anfang einer Zeile oder eines Inhaltsabschnitts an. Sie kann auch zum Trennen von Datenspalten in einer Datei verwendet werden.

DPID

Datenanbieter-ID.

MASTER_DPID

Benutzer-ID-Schlüssel Datenanbieter-ID.

NEW_LINE

Ermöglicht die Erstellung von mehrzeiligen Kopfzeilen für ausgehende Bestellungen.

ORDER_ID

Bestell-/Ziel-ID.

PID_ALIAS

Alias für eine Bestell-/Ziel-ID.

Der Alias wird in der Administrator-Benutzeroberfläche festgelegt.

SPLITNUM

Gibt die Aufteilung der ausgehenden Dateien in mehrere Teile an. Ersetzen Sie den Abschnitt SPLITNUM im Dateinamen durch die Teilenummer, der Nullen vorangestellt sind, sodass für den Abschnitt SPLITNUM mindestens drei Zeichen erforderlich sind.

Das SPLITNUM-Makro muss nicht von <> -Zeichen umgeben sein.

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

s3_123456_999_full_1566906141001.csv

s3_123456_999_full_1566906141002.csv

s3_123456_999_full_1566906141003.csv

Die letzten drei Ziffern (001.002.003) in den obigen Beispielen sind die SPLITNUM-Kennungen.

SYNC_MODE

Gibt den Synchronisierungstyp an und umfasst:

  • full : Vollständige Synchronisierung.
  • iter : Inkrementelle Synchronisation.

SYNC_TYPE

Gibt die Datenübertragungsmethode an und umfasst:

  • ftp
  • http
  • s3

TAB

Dieses Makro wird als Trennzeichen verwendet und fügt eine Registerkarte zwischen Feldern ein.

TIMESTAMP

Ein 10-stelliger UTC-, Unix-Zeitstempel.

Sie kann auch als <TIMESTAMP; format="YYYYMMDDhhmmss"> die Java-Formatierungsregeln für Datum/Zeitstempel befolgen.

Inhaltsmakros

Makros zum Formatieren des Inhalts einer Datendatei. Codebeispiele finden Sie unter Beispiele für ausgehende Makros.

Makro Beschreibung

CLOSE_CURLY_BRACKET

Fügt eine schließende geschweifte Klammer ein } Zeichen.

DP_UUID

Eindeutige Benutzerkennung für Datenanbieter .

Dies ist die ID für den Datenpartner, an den Sie Daten in einer ausgehenden Datei senden.

DP_UUID_LIST

Gibt eine Liste mit mehreren IDs für einen Datenpartner zurück. Dies ist nützlich, wenn Sie eine große Organisation mit mehreren Unterteilungen oder anderen Organisationsgruppen haben, für die Sie Daten freigeben können. Dieses Makro gibt eine Liste der IDs für diese Untergeordneten Gruppen zurück.

DPID

Datenanbieter-ID.

DPUUIDS

Die Ausgabe dieses Makros ordnet die Datenanbieter-ID (DPID) den zugehörigen eindeutigen Benutzer-IDs (DPUUID) zu. Dieses Makro muss über eine Formatierungszeichenfolge verfügen, um seine Ausgabe zu steuern. Die Beispielausgabe würde wie folgt aussehen:

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

Die maxMappings bestimmt, wie viele Zuordnungen das Makro zurückgeben soll. Wann maxMappings=0 , gibt dieses Makro alle Zuordnungen für jede angegebene DPID zurück. Die Daten werden nach Zeitstempel sortiert (neueste zuerst) und geben die Ergebnisse mit dem größten Zeitstempel zuerst zurück.

if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif

Diese Kombination von Makros erstellt eine bedingte Anweisung, in der die Segmente aufgelistet werden, zu denen die Benutzer gehören und aus denen sie entfernt wurden. Es wird eine leere Zeichenfolge zurückgegeben, wenn beide Bedingungen nicht erfüllt sind oder keine Daten vorliegen.

MCID

Adobe Experience Cloud ID.

OPEN_CURLY_BRACKET

Fügt eine geöffnete geschweifte Klammer ein { Zeichen.

OPT_OUT

Herabgestuft. Nicht verwenden.

ORDER_ID

Bestell- oder Ziel-ID.

OUTPUT_ATTRIBUTE_TYPE

Herabgestuft. Nicht verwenden.

OUTPUT_ATTRIBUTE_VALUE

Rückgabe 1 als statischen, fest codierten Wert.

PID

Partner-ID.

PIDALIAS

Alias für eine Bestell-/Ziel-ID.

Der Alias wird in der Administrator-Benutzeroberfläche festgelegt.

REMOVED_SEGMENT_LIST

Gibt eine Liste der entfernten Segmente zurück, falls vorhanden.

SEGMENT_LIST

Gibt eine Liste von Segmenten in einer Liste zurück. Akzeptiert die folgenden optionalen Argumente:

  • segmentId : Segment-ID. Herabgestuft. Verwenden Sie sid .
  • csegid : Kundensegment-ID. Herabgestuft. Verwenden Sie sid .
  • sid : Segment-ID
  • type : Rückgabe 5 : ein statischer, fest programmierter Wert, der Daten als Segmentdaten identifiziert.
  • alias : Nicht mehr verwendet. Nicht verwenden.
  • lastUpdateTime : Ein Unix-Zeitstempel, der angibt, wann das Segment zuletzt aktualisiert wurde.
  • lastRealizationTime : Ein Unix-Zeitstempel, der angibt, wann ein Segment zuletzt realisiert wurde.

Setzen Sie diese Variablen in geschweifte Klammern hinter das Makro. Dieser Code trennt beispielsweise Ergebnisse mit einem senkrechten Strich "|": <SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator=",">

SET_ATTRIBUTES

Rückgabe 1 als statischen, fest codierten Wert.

SYNC_MODE

Gibt den Synchronisierungstyp an und umfasst:

  • full : Vollständige Synchronisierung.
  • iter : Inkrementelle Synchronisation.

SYNC_TYPE

Gibt die Datenübertragungsmethode an und umfasst:

  • ftp
  • http
  • s3

TAB

Dieses Makro wird als Trennzeichen verwendet und fügt eine Registerkarte zwischen Feldern ein.

TRAIT_LIST

Gibt eine Liste von Eigenschaften zurück. Akzeptiert die folgenden optionalen Argumente:

  • type : Identifiziert Eigenschaftstypen anhand numerischer ID. Rückgabe:
    • 10 , das eine DPM-Eigenschaft identifiziert (offline, von einem eingehenden Auftrag integriert).
    • 3 , das eine regelbasierte Eigenschaft identifiziert (Echtzeit, über den DCS integriert).
  • traitId : Eigenschafts-ID.
  • lastRealized : Das letzte Mal, dass die Eigenschaft realisiert wurde. Unix-Zeitstempel.

Setzen Sie diese Variablen in geschweifte Klammern hinter das Makro. Dieser Code trennt beispielsweise die Ergebnisse mit dem senkrechten Strich "|": <TRAIT_LIST:{trait|<trait.Id>,<trait.lastRealized>};separator=","

UUID

Audience Manager Benutzer-ID.

Auf dieser Seite