単品商品のタグ実装(固定商品ID向け)

各タグに入れる商品IDが固定の一商品である場合は、動的に値を取得する必要がないため、このページで簡易的なタグを生成し、コピー&ペーストするだけで実装できます。

以下のいずれかに該当する場合にご利用ください。

  1. カタログフィードに登録されている商品が1つのみの場合
  2. カタログフィードには複数の商品を登録しているが、各タグには固定で代表の商品ID 1点のみを設定する場合

Criteo タグのコンセプト

Criteoタグは、以下の2つの要素で構成されています:

  1. ローダースクリプト - すべてのタグを動作させるためのベースとなるJavaScript
  2. タグ(トラッカー) - ページの種類に応じて、ユーザーの行動情報を送るJavaScript

特徴:

  • ページの種類(トップページ、商品詳細など)に応じて、実装するタグが異なります。
  • サイトのレイアウトを変更したり、閲覧者の目に見える形でバナー等を表示することはありません。
  • 非同期で読み込まれるため、基本的にはサイトの表示速度に影響を与えることはありません。

このページの使い方

このページのURLパラメータにアカウントIDと商品IDを設定すると、以下のタグに値が自動的に代入されます。 そのままコピー&ペーストして実装してください。URLパラメータが設定されていない場合は、以下のパラメータを追加してください。

  • アカウントIDパラメータ(accountid=) → 例:12345
  • 商品IDパラメータ(productid=) → 例:product01
  • 接続URL: https://guides.criteotilt.com/onetag/single_simple/?accountid=12345&productid=product01

ローダースクリプト

ローダースクリプトとは

  • すべてのCriteoタグを動作させるための土台となるスクリプトです。
  • 各タグで取得した情報を、Criteoのサーバへ送信する役割を担っています。

ローダースクリプトの実装方法

  • サイトのヘッダー部分などに実装し、全ページで読み込まれるようにしてください。
  • 下記のスクリプトを利用します:
<script type="text/javascript" src="//dynamic.criteo.com/js/ld/ld.js?a={{accountid}}" async="true"></script>

ページ固有のタグ(トラッカー)概要

Criteoのパーソナライズ広告(バナー等)は、各タグから送られるデータ(閲覧履歴やカート追加など)をもとに生成されます。 広告のレコメンド精度を最大化するため、全種類のタグを適切なページへ漏れなく実装してください。

5つのタグと役割

  • ホームページタグ: トップページへの訪問を記録
  • 一覧ページタグ: 検索結果やカテゴリページで表示された複数の商品IDを記録
  • 商品タグ: 詳細ページで閲覧された単一の商品IDを記録
  • カート・申込みページタグ: 買い物カゴへの追加、および申込み・確認ページへのアクセスを記録
  • コンバージョンタグ: 購入・申込み完了した商品ID、単価、個数を記録・送信

全タグ共通で設定される項目

  • SiteType(自動判定) ユーザーの利用デバイス(PC:"d", スマホ:"m", タブレット:"t")をタグ内のJavaScriptが自動で判定・代入します。

  • Email(推奨) クロスデバイスでの識別精度向上のため利用します。SHA-256でハッシュ化した値を email に、"sha256"hash_method に代入してください(メールアドレスの設定方法の詳細はこちら(補足3)をご参照ください)。

※すべてのタグで代入する必要はありません。ユーザーがログインしているなど、メールアドレスが取得可能な状態でのみタグに代入してください。取得できない場合はパラメータを省略、または空文字を指定して実装してください。

ホームページタグ (トップページタグ)

  • ホームページタグ (トップページタグ)はウェブサイトのトップページに実装してください。
  • サイトに商品ページしかない場合は実装不要です。
<!-- Criteo Homepage Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
    window.criteo_q.push(
            { event: "setAccount", account: {{accountid}} },
            { event: "setSiteType", type: deviceType },
            { event: "setEmail", email: "ハッシュ化されたメールアドレス", hash_method: "sha256" },
            { event: "viewHome" }
    );
</script>
<!-- END Criteo Homepage Tag -->

一覧ページタグ

  • 一覧ページタグは、商品のカテゴリページや検索結果の一覧ページに実装してください。
  • サイトに商品ページしかない場合や、一覧ページで商品IDを計測する必要がない場合は実装不要です。
<!-- Criteo Search Results Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
    window.criteo_q.push(
            { event: "setAccount", account: {{accountid}} },
            { event: "setSiteType", type: deviceType },
            { event: "setEmail", email: "ハッシュ化されたメールアドレス", hash_method: "sha256" },
            { event: "viewList", item: ["{{productid}}"] }
    );
</script>
<!-- END Criteo Search Results Tag -->

商品タグ

  • 商品タグはサイト内のすべての商品詳細ページに実装してください。
  • タグ内の商品IDは、カタログフィードに登録している商品IDと一致させてください。
<!-- Criteo Product Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
    window.criteo_q.push(
            { event: "setAccount", account: {{accountid}} },
            { event: "setSiteType", type: deviceType },
            { event: "setEmail", email: "ハッシュ化されたメールアドレス", hash_method: "sha256" },
            { event: "viewItem", item: "{{productid}}" }
    );
</script>
<!-- END Criteo Product Tag -->

カート・申込みページタグ

  • カート・申込みページタグはサイトの買い物カゴ・申込みページに実装してください。
  • 商品が複数存在する場合でも、固定の商品ID 1点のみで実装する場合はそのまま利用してください。
<!-- Criteo Basket/Cart Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
    window.criteo_q.push(
            { event: "setAccount", account: {{accountid}} },
            { event: "setSiteType", type: deviceType },
            { event: "setEmail", email: "ハッシュ化されたメールアドレス", hash_method: "sha256" },
            { event: "viewBasket", item: [
                { id: "{{productid}}", price: 1, quantity: 1 }
            ]}
    );
</script>
<!-- END Criteo Basket/Cart Tag -->

コンバージョンタグ

  • コンバージョンタグは購入完了(サンクス)ページに実装してください。
  • このサンプルではTransaction IDにJavaScriptでランダム値を生成して代入しています。サイト側で発行する一意の注文番号等を利用する場合は、該当箇所を置き換えてください。
<!-- Criteo Sales Tag -->
<script type="text/javascript">
    window.criteo_q = window.criteo_q || [];
    var deviceType = /iPad/.test(navigator.userAgent) ? "t" : /Mobile|iP(hone|od)|Android|BlackBerry|IEMobile|Silk/.test(navigator.userAgent) ? "m" : "d";
    window.criteo_q.push(
            { event: "setAccount", account: {{accountid}} },
            { event: "setSiteType", type: deviceType },
            { event: "setEmail", email: "ハッシュ化されたメールアドレス", hash_method: "sha256" },
            { event: "trackTransaction", id: Math.floor(Math.random()*99999999999), item: [
                { id: "{{productid}}", price: 1, quantity: 1 }
            ]}
    );
</script>
<!-- END Criteo Sales Tag -->

タグ補足説明

タグ補足1 - Transaction ID

  • コンバージョンタグで取得するTransaction IDは、トランザクションごとに一意の値を代入する必要があります。通常は注文完了番号などをセットしてください。
  • 一意のIDの取得が困難な場合は、コード側でランダムな値を生成して代入できます。このページのサンプルでは Math.floor(Math.random()*99999999999) を使用しています。サイト側で一意の注文番号を発行できる場合は、そちらに置き換えてください。

タグ補足2 - タグパラメータ一覧

パラメータキー名 (対象イベント) 値の指定ルール 代入例 注意事項 使用タグ
email
(setEmail内)
半角英数のみ(スペース不可) 973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b SHA-256でハッシュ化された小文字を代入してください。
ハッシュ化をする前の原本のメールアドレスでは、前後等のスペースが無いこと・UTF-8でエンコードされているかを確認してください。
全タグ共通
hash_method 半角英数のみ sha256 全タグ共通
type
(setSiteType内)
自動判定(JS利用) (基本的には自動代入) サンプルのタグ内に含まれるJSでnavigator.userAgentを判定し、PC("d") / モバイル("m") / タブレット("t") を自動で代入します。 全タグ共通
item
(viewItem等)
半角英数のみ
(ハイフン可能)
["pid111", "pid112"]
または
"pid111"
カタログフィードのIDと完全に一致させてください。複数ある場合は配列を用います。 商品タグ
一覧ページタグ
id
(item配列内)
半角英数のみ
(ハイフン可能)
pid1111 カタログフィードのIDと完全に一致させてください。 カート・申込みページタグ
コンバージョンタグ
price
(item配列内)
半角英数のみ
(記号、カンマ不可)
1000 合計の値段ではなく、商品単価を代入してください。 カート・申込みページタグ
コンバージョンタグ
quantity
(item配列内)
半角英数のみ
(記号、カンマ不可)
3 購入した個数を代入してください。
(3個購入の場合は"3"にします)
カート・申込みページタグ
コンバージョンタグ
id
(trackTransaction内)
半角英数のみ
(ハイフン使用可能)
tid12345 注文番号など、各トランザクションにおいて重複しない値を代入してください コンバージョンタグ

タグ補足3 - タグにsetEmailを代入する場合

メールアドレスをタグに代入することで、複数端末を跨いだユーザー識別(クロスデバイス機能)の精度が向上します。

⚠️ 重要:メールアドレスの取り扱いに関する注意事項

平文のメールアドレス(ハッシュ化前の状態)はタグへ代入しないでください。
(NG例: { event: "setEmail", email: "john@company.com" }

事前に必ず以下のルールでハッシュ化をおこなった値を代入してください。

  • 小文字のみ使用(大文字は小文字に変換)
  • 前後のスペースを削除
  • UTF-8でエンコード
  • SHA-256でハッシュ化

代入パターンの例

  1. ハッシュ化して代入する場合
    { event: "setEmail", email: "973dfe463ec85785f5f95af5ba3906eedb2d931c24e69824a89ea65dba4e813b", hash_method: "sha256" }
  2. メールアドレスが取得できないページの場合(空文字を指定)
    { event: "setEmail", email: "" }

【JavaScriptでのハッシュ化 実装サンプル】

JavaScriptを利用して動的にハッシュ化をおこなう場合の実装コードサンプルは、以下のCriteo公式ヘルプページ内でご確認いただけます。
- Criteo OneTag Advanced Settings - Email Hashing


実装についてご不明な点がございましたら、担当営業までお問い合わせください。