ファイル形式マクロ file-format-macros

FTP ベースのデータファイルの作成に使用できるマクロのリストを表示します。一部のマクロは、データファイルのすべてのフィールドと行に使用できます。その他のマクロは、ヘッダーとデータ行にしか使用できません。

一般的なマクロ common-macros

これらのマクロはどの形式フィールドでも使用できます。例については、 File Format Macro Examplesを参照してください

マクロ
説明
ASCII_SOH
非表示の ASCII 文字。コンテンツの行またはセクションの開始を表します。ファイル内のデータ列を区切る場合にも使用できます。
DPID
ターゲットデータプロバイダー ID。
MASTER_DPID
ユーザー ID キーデータプロバイダー ID。
ORDER_ID
オーダー/宛先 ID。
PIDALIAS

オーダー/宛先 ID のエイリアス。

このエイリアスの値は、宛先の「Foreign Account ID」フィールド(「Basic Settings」セクション内)で設定します。

SYNC_MODE

同期タイプを表します。次のオプションの変数を使用できます。

  • full:完全同期。
  • iter:増分同期。
SYNC_TYPE

データ転送方式を表します。次のオプションの変数を使用できます。

  • ftp
  • http
  • s3
TIMESTAMP

10 桁の UTC を示す Unix タイムスタンプ。

Java の日付/タイムスタンプ形式ルールに従って YYYYMMDDhhmmss という形式にすることもできます。

ヘッダーフィールドマクロ header-field-macros

ヘッダーフィールドのみで使用されるマクロ。例については、 File Format Macro Examplesを参照してください

マクロ
説明
TAB
このマクロはフィールド間の区切り記号としてタブを挿入します。

データ行マクロ data-row-macros

データ行でのみ使用するマクロ。例については、 File Format Macro Examplesを参照してください

マクロ
説明
CLOSE_CURLY_BRACKET
閉じ中括弧(})を挿入します。
COMMA
コンマを挿入します。
DP_UUID

データパートナー一意のユーザー ID。ユーザー/サイト訪問者に割り当てた ID が Audience Manager デバイス ID と既に同期されている場合、その ID を返します。

DPID が 0 の場合、このマクロはユーザーの ID ではなく Audience Manager ID を返します。

DP_UUID_LIST
1 件のデータパートナーに対する複数の ID が含まれるリストを返します。複数の下位部門や、その他の組織グループがある大規模な組織でデータ共有が可能な場合に便利です。このマクロは、これらの下位グループの ID のリストを返します。
DPUUIDS

このマクロの出力では、データプロバイダー ID(DPID)が関連する一意のユーザー ID(DPUUID)にマッピングされます。このマクロには、出力を制御するための書式設定文字列が必要です。出力例として次のようなものが挙げられます。

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

maxMappings 設定により、マクロが返すマッピングの数が決定されます。maxMappings=0 の場合、このマクロは指定された各 DPID のすべてのマッピングを返します。データはタイムスタンプを基準に並べ替えられ(最新のものが最初となります)、最も値が大きいタイムスタンプの結果が最初に返されます。

endif
条件付き ifSEGMENT_LIST および REMOVED_SEGMENT_LIST マクロを使用する場合に必要です。
if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif
マクロを組み合わせると、ユーザーが属し、かつ ユーザーが削除されたセグメントのリストを表示する条件文が作成されます。いずれかの条件が満たされない場合、またはデータがない場合、空の文字列が返されます。
MCID
Adobe Experience Cloud ID。
OPEN_CURLY_BRACKET
開き波括弧({)を挿入します。
OPT_OUT
廃止されました。使用しないでください。
OUTPUT_ATTRIBUTE_TYPE
廃止されました。使用しないでください。
OUTPUT_ATTRIBUTE_VALUE
1 を静的な、ハードコーディングされた値として返します。
PID
パートナー ID(PID)。PID は Admin UI の「Profile」タブに表示されます。
REMOVED_SEGMENT_LIST
削除されたセグメントがあれば、そのリストを返します。
SEGMENT_LIST

セグメントのリストを返します。次のオプションの変数を使用できます。

  • segmentId:レガシー ID。廃止されました。sid(小文字のみ)を使用します。
  • csegid:レガシー ID。廃止されました。sid(小文字のみ)を使用します。
  • sid:セグメント ID。
  • type5 を静的なハードコーディングされた値として返します。これはデータをセグメントデータとして識別する値です。
  • alias:セグメントのマッピング。廃止されました。sid(小文字のみ)を使用します。
  • lastUpdateTime:セグメントが最後に認識された時点を示す Unix タイムスタンプ。

この変数は、マクロの後に配置して波括弧で囲みます。例えば、<SEGMENT_LIST:{seg|<seg.type>,<seg.sid>}; separator="|"> のように、このコードは結果をパイプ( | )で区切ります。

SET_ATTRIBUTES
1 を静的な、ハードコーディングされた値として返します。
TAB
区切り記号としてタブを挿入します。
TRAIT_LIST

特性のリストを返します。次のオプションの引数を使用できます。

  • type:数値 ID で識別される特性タイプ。この変数は次の値を返します。

    • 10:DPM 特性(オフライン、インバウンドジョブで転送されたジョブ)を表します。
    • 3:ルールベースの特性(リアルタイム、DCS から転送)を表します。
  • traitId:特性 ID。

  • lastRealized:特性が最後に認識された時点。Unix タイムスタンプ。

この変数は、マクロの後に配置して波括弧で囲みます。例えば、TRAIT_LIST{type|traitId};separator="|" のように、このコードは結果をパイプ( | )で区切ります。

UUID
Audience Manager ユーザー ID。
recommendation-more-help
3d9f8cff-f6d8-4dcd-966c-cf2ea03db934