ドキュメントAudience Manager管理ガイド

HTTP 形式マクロ http-format-macros

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

HTTP データファイルの作成に使用できるマクロのリストを表示します。HTTP はデータを JSON 形式で送信します。

HTTP 形式マクロの例で、一般的に使用されるマクロの組み合わせのリストと例を参照してください。

マクロ
メソッドのタイプ
説明
AAM_UUID
GET
Audience Manager ID。
DP_UUID
GET
データパートナーの一意のユーザー ID。このマクロは、ユーザーに割り当てた ID が Audience Manager デバイス ID と既に同期されている場合、その ID を返します。
DPID
GET
データプロバイダー ID。
ECID
GET
データプロバイダー ID。
GENERATION_TIME
GET, POST
Unix UTC タイムスタンプ。S2S 宛先をパートナーに公開するよう AAM が通知を受けた時間を表す内部タイムスタンプ。
IP
GET
ユーザーの IP アドレス。
MCID
GET
Experience Cloud ID.（MCID は、Experience Cloud のレガシー名である Marketing Cloud を表します）
NUM_REMOVED_SEGMENTS
GET
ユーザーが属していないセグメントの数（整数）。
NUM_SEGMENTS
GET
ユーザーが属しているセグメントの数。
ORDER_ID
GET, POST
オーダー／宛先 ID。
PID_ALIAS
GET, POST
パートナー ID のエイリアス。外部アカウント ID とも呼ばれます。
RANDOM
GET
乱数を生成します。
REGION_ID_LIST
GET
アクティビティが開始される Audience Manager DCS 領域。
REMOVED_SEGMENT_LIST
GET
ユーザーが認定されないセグメントがある場合、そのセグメントの ID のリストを返します。
REMOVED_SEGMENTS
GET

ユーザーが認定されないセグメントのリスト。以下のような特定のセグメントフィールドを返すこともできます。

  • traitAlias
  • legacySegmentId (formerly segmentId)
  • newSegmentId
  • status
  • dateTime

以下の例のように、これらのフィールドを配列で指定します。

[<REMOVED_SEGMENTS:{seg|<OPEN_BRACKET>"Mapping":<seg.traitAlias>,"Status:"<seg.status>, "Time":<seg.dateTime>,"LegacySegmentId":<seg.LegacySegmentId>, "NewSegmentId":<seg.NewSegmentId><CLOSE_BRACKET>}; "separator=",">]

HTTP 形式マクロの例も参照してください。

REMOVED_TIME_LIST
GET
ユーザーが認定されなくなったセグメントの最後の認識に関するリスト。
REMOVED_TRAITALIAS_LIST
GET
ユーザーが認定されなくなったセグメントのエイリアス名のリスト。
SEGMENT_LIST
GET
セグメント ID のリストを返します。
SEGMENTS
GET

ユーザーが認定されているセグメントのリスト。以下のような特定のセグメントフィールドを返すこともできます。

  • traitAlias
  • legacySegmentId (formerly segmentId)
  • newSegmentId
  • status
  • dateTime

以下の例のように、これらのフィールドを配列で指定します。

[<SEGMENTS:{seg|<OPEN_BRACKET>"Mapping":<seg.traitAlias>,"Status:"<seg.status>, "Time":<seg.dateTime>,"LegacySegmentId":<seg.LegacySegmentId>, "NewSegmentId":<seg.NewSegmentId><CLOSE_BRACKET>}; "separator=",">]

HTTP 形式マクロの例も参照してください。

TIME_LIST
GET
最後の認識のリスト。
TIMESTAMP
GET
UNIX の UTC タイムスタンプ。セグメントの最後の認識を表します。
TRAITALIAS_LIST
GET
特定のセグメントのエイリアス名のリスト。
USER_AGENT
GET
初期リクエストのユーザーエージェント。
USER_LIST
POST

Audience Manager ユーザー ID のリスト。以下のような特定のフィールドを返すこともできます。

  • user.aamUuid
  • user.dpUuid
  • user.segments
  • user.removedSegments
  • user.userAgent
  • user.ip
  • user.dpuuids
  • user.timestamp
  • user.random
  • user.regionIds

これらのフィールドは以下の例のように指定します。

"AAM_UUID": "<user.aamUuid>" "DataPartner_UUID": "<user.dpUuid>"

完全な例については、HTTP 形式マクロの例を参照してください。

recommendation-more-help
3d9f8cff-f6d8-4dcd-966c-cf2ea03db934