Tracking & Attribution

トラッキングURLの構成方法

応答は、組み合わせるべき3つのソースを提示します。

• Page-level trackers.impression: for example, a page impression uses type: "impression" and params including ts and iabConsentString.
• Shared trackingTemplates: one set of client(relative) and server (absolute) URL templates, already containing session and placement query parameters.
• Per-node trackers.click and/or trackers.addToCart on a module, row, or gallery item: type+ params for that specific event (for example, modId, rurl, productCode).

使用するテンプレート

Use the node’s tracking.type to look up trackingTypes.<type>. This defines the valid client.* and server.* keys for that interaction (for example, for link: client.clickRedirect, client.clickEvent, server.clickEvent).

クライアント対サーバー

• Client (trackingTemplates.client.*): Values are relative paths (including query strings). Prepend your reverse‑proxy base URL (BASEURL).
• Server (trackingTemplates.server.): Values are absolute URL templates on the Epsilon tracking host. Compose the final URL the same way as C2S: template + "&" + queryString(trackers.<slot>params).

使用例（擬似コード）

C2S click for a HERO CTA

url = BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params)

S2S page impression

url = trackingTemplates.server.impressionEvent + "&" + queryString(trackers.impression.params)

S2S add-to-cart for a product row

url = trackingTemplates.server.addToCartEvent + "&" + queryString(trackers.addToCart.params)

Macro substitution

• Replace {TS} with the current millisecond timestamp, {RURL} with the URL-encoded destination, and {TCF} with the current TCF v2 string from your CMP before firing.
• For add-to-cart, also substitute {QTY} with the absolute quantity of that SKU in the cart at fire time (not a delta), and {CONVERSION_VALUE} with the absolute monetary value of those items (quantity × unit price, minus any applied discounts).

トラッキング – クライアントからサーバーへ（C2S）

C2S tracking is implemented in the browser using composed URLs. Prepend BASEURL to the paths in trackingTemplates.client and append the appropriate trackers.<slot>params (see How to Compose a Tracking URL).

Only client.impressionPixelUrls are pixels (1×1 GIF). The other client templates are not pixels:

• client.clickRedirect: 302 redirect endpoint. Epsilon logs the click and redirects the browser to the decoded rurl. Use this as a browser navigation target.

• client.clickEvent: Event beacon returns 204 No Content). Fire using navigator.sendBeacon or fetch({ keepalive: true }). Do not render as <img>.

• client.addToCartEvent: Event beacon (returns 204). Uses the same firing pattern as clickEvent.

実装手順

1. APIが返すブランドページのコンテンツをレンダリングします。

2. レンダリング後、ブラウザでインプレッションピクセルを起動します（trackingTemplates.client.impressionPixelUrls内のすべてのエントリを1x1画像として）。

3. When a user clicks a trackable node, either:
   (a) redirect through the composed client.clickRedirect URL, or
   (b) fire the composed client.clickEvent URL as an event beacon and navigate to the destination yourself.
   Use one or the other per click, not both.

インプレッションピクセル

After the brand page renders, fire each path in trackingTemplates.client.impressionPixelUrls as a 1×1 image, (see How to Compose a Tracking URL).

<img src="https://www.retailer.com/epsilon/tracking/v3/impression/pixel/brandpage_djog...?...&ts=1737485823910"
     width="1" height="1" style="display:none" />

手順：

1. trackingTemplates.client.impressionPixelUrlsの各文字列に対して、BASEURL を前に付けます（例：https://www.retailer.com/epsilon）。
2. Append & + queryString(trackers.impression.params), substituting {TS} with the current millisecond timestamp and {TCF} with the current consent string from your CMP.
3. ブラウザで1×1の< img src="...">として表示（または同等のもの）されます。

クリックトラッキング

オプションA：リダイレクトをクリックします(client.clickRedirect)

Navigate the user through the composed URL. Epsilon logs the click and responds with HTTP 302 to the decoded rurl. This endpoint is GET only, and rurl is required;

オプションB：クリックイベントビーコン((client.clickEvent)

Fire as a beacon and navigate yourself. Accepts GET or POST, returns 204 No Content. Not an image; do not render as<img>.

カートに追加(C2S)

Fire trackingTemplates.client.addToCartEvent as an event beacon (not a pixel) when the user adds a product to cart. Accepts GET or POST, returns 204 No Content.

トラッキング – サーバー間（S2S）

S2S tracking is implemented on your backend. Compose URLs the same way as C2S: start from the appropriate trackingTemplates.server string, then append trackers.<slot>params. Server templates are already absolute — there is no BASEURLto prepend. (see How to Compose a Tracking URL).

S2Sトラッキングを使用するタイミング

• アーキテクチャにはサーバー側イベントの発生が必要です。
• クライアント側のピクセルが信頼できない環境では、トラッキングが必要です。
• You want to mix strategies - e.g. C2S impressions + S2S add-to-cart. This is supported but never fire both C2S and S2S for the same event.

S2Sインプレッション通知

After the brand page is rendered, your server issues a GET or POST to the composed impression URL: trackingTemplates.server.impressionEvent + trackers.impression.params (substitute {TS} and {TCF} before sending).

S2Sクリック通知

Compose: trackingTemplates.server.clickEvent + trackers.click.params (substitute {TS}, {RURL}, and {TCF}), then issue GET or POST.

S2Sカートへの追加通知

Compose: trackingTemplates.server.addToCartEvent + trackers.addToCart.params (substitute {TS}, {QTY}, {CONVERSION_VALUE}, and {TCF}), then issue GET or POST.

S2Sパラメーター

マクロリファレンス

URLエンコーディングリファレンス

{RURL}をエンコードする際は、標準パーセントエンコードを使用します：

redirectParams and Redirect Signing

When platform redirect signing is enabled, trackers.click may include a redirectParamsobject alongside params. The keys in 7are merged only into client.clickRedirect URLs — not into clickEventor any server URL.

Two cases:

Embedded link destinations (URL baked into params.rurl): the platform signs the redirect at serve time and emits literal rurlKidand rurlSigvalues in redirectParams. Append these as-is to the clickRedirect URL.

Retailer-controlled redirects (params.rurl is {RURL}): redirectParams contains the macros {RURL_KID} and {RURL_SIG}. Call the batch sign endpoint (redirectSigning.url from the response) to obtain the key id and signature for your destination URL, then substitute before appending.

The top-level redirectSigningobject, when present, provides the batch POST /ads/v3/redirect/sign endpoint URL and the maxUrlsbatch limit. Contact Epsilon to confirm whether redirect signing is enabled for your integration.

clickRedirect composition with redirectParams:

BASEURL + trackingTemplates.client.clickRedirect + "&" + queryString(trackers.click.params) + "&" + queryString(trackers.click.redirectParams)

スタイルガイド

Before enabling Brand Pages on your site, we need to capture your site's visual identity. Fill in the table below with your design values. Our team will use this to configure the brand page preview experience.

ロゴ

色

タイポグラフィ

ボタン

モジュールコンテンツの要件

ブランドページはコンテンツモジュールで構成されています。各モジュールタイプについて、サイトに必要なコンテンツ制約をご記入ください。私たちのチームはこれらを使用して、テンプレートの検証ルールを設定します。

IMAGE Modules

TEXT Modules

PRODUCT_GRID Modules

IMAGE_GALLERY Modules

画像ギャラリーモジュールは、IMAGEモジュールと同じ構成プロパティを継承します。さらに、次のギャラリー固有のプロパティも承認します。

SPLIT_LAYOUT Modules

分割レイアウトモジュールを使用すると、2つのモジュールを横に並べて表示できます。現在、テキストモジュールと画像モジュールのみに対応しています。テキストモジュールと画像モジュールの個別の構成設定（上記のセクションで説明したとおり）に加えて、以下の追加プロパティが必要です。

アイデンティティーとプライバシー

受け入れ可能な識別子

• Session ID - anonymous session identifier (non-PII)
• Customer ID - retailer customer identifier (non-PII, e.g. loyalty ID hash)

プライバシー要件

小売業者は以下を行う必要があります。

• プライバシーポリシーで測定トラッキングに関する開示を行う
• 以下のオプトアウトリンクを提供する
  • NAI: https://optout.networkadvertising.org/
  • DAA: https://optout.aboutads.info/

GDPR /同意

オブジェクトregsをPOST /ads/v3/brand-pagesで渡します。

• regs.gdpr: 1 when the request is subject to GDPR (EU/EEA/UK treatment per your policy); 0otherwise.
• regs.consent: When gdpr is 1, pass the current TCF v2 consent string from your CMP (the same value you would surface to other ad partners). Do not invent or hardcode a string—use what the user’s browser / app has consented to.
• iabConsentString: This appears in every tracker slot's params, not in trackingTemplates. When regs.consent was provided, the value is the literal TC string and no further action is needed.
• When regs.consent was omitted, the value is the {TCF}macro — substitute the current TCF v2 string from your CMP at fire time before sending any tracking request.