用語集
ユーザーID
ユーザーIDとは、jsライブラリを導入しているサイトにおけるブラウザ単位でユニークなユーザーのことです。
CODE Marketing cloudのSDKではユーザーIDをCookieに保持することでカスタマーを識別おり、Cookieは一部のブラウザを除いて2年間有効です。
なお、Cookieをリフレッシュすると、ユーザーIDは初期化され、別々のユーザーとして認識されます。
商品コンバージョン属性
コンバージョン(以下、CV)時のサイト上の商品の属性を商品コンバージョン属性と呼びます。
「商品」は、
アパレルショップにおける「洋服」
人材サイトにおける「求人」
旅行サイトにおける「旅行プラン」
というように特定の業態・商材に特化せずに汎用的に商品と呼んでいます。
CVの概念はサイトによって多種多様ですが、
本計測タグでは「予約(Reservation)」「閲覧(Browse)」「応募(Entry)」「購入(Purchase)」「お気に入り(Favorite)」「カート(Cart)」のコンバージョン種別の中から選択していただけます。
| 属性 | 計測時必須 | 概要 | 例 | データ型 |
|---|---|---|---|---|
| itemId | ○ | 商品ID | “0001” | 文字列型 |
| conversionType | ○ | コンバージョン種別 | “Purchase” | 列挙型(“Reservation”,”Browse”,”Entry”,”Purchase”,”Favorite”,”Cart”) |
| eventDateTime | 計測タグ: ✕ DataSync Import: ○ |
イベント日時 | “2020-10-01T10:00:00Z” | DateTime型 |
| itemCount | × | 商品数 | 3 | 数値型 |
| itemPrice | × | 商品価格 | 1000 | 数値型 |
| sku | × | SKU | “3個入り” | 文字列型 |
上記プリセット以外でもカスタム属性を指定して計測することが可能です。
計測タグまたは、DataSync Importのどちらかで計測が可能です。
どちらで計測するかは比較表を確認後、Webサイトの要求に応じて選択ください。
会員属性
| 属性 | 計測時必須 | 概要 | 例 | データ型 |
|---|---|---|---|---|
| eventDateTime | 計測タグ: ✕ DataSync Import: ○ |
イベント日時 | “2020-10-01T10:00:00Z” | DateTime型 |
| name.last | × | 名前 | “太郎” | 文字列型 |
| name.first | × | 名字 | “サンプル” | 文字列型 |
| name.middle | × | ミドルネーム | “ミドル” | 文字列型 |
| gender | × | 性別 | Male | 列挙型(“Male”, “Female”, “NotApplicable”) |
| birthdate.timezoneId | × | 生年月日のタイムゾーン | “Asia/Tokyo” | 文字列型 |
| birthdate.date | × | 生年月日の日付 | “1988-11-05” | Date型 |
| address.zip | × | 郵便番号 | “0000000” | 文字列型 |
| address.country | × | 国 | “日本” | 文字列型 |
| address.prefecture | × | 都道府県 | “東京都” | 文字列型 |
| address.city | × | 市区町村 | “新宿区” | 文字列型 |
| address.other | × | その他の住所(自由記述) | “千代田区サンプル住所” | 文字列型 |
| jobName | × | 職業 | “エンジニア” | 文字列型 |
| registeredAt | × | 会員登録日時 | “2019-08-28T08:13:29.225Z” | DateTime型 |
上記プリセット以外でもカスタム属性を指定して計測することが可能です。
計測タグまたは、DataSync Importのどちらかで計測が可能です。
どちらで計測するかは比較表を確認後、Webサイトの要求に応じて選択ください。
ターゲティング条件で利用できる属性
| 属性名 | 属性キー |
|---|---|
| 年齢 | birthdate.timezoneId / birthdate.date |
| 性別 | gender |
| 本日が誕生日 | birthdate.timezoneId / birthdate.date |
| 誕生:年 | birthdate.timezoneId / birthdate.date |
| 誕生:月 | birthdate.timezoneId / birthdate.date |
| 誕生:日 | birthdate.timezoneId / birthdate.date |
| 国 | address.country |
| 都道府県 | address.prefecture |
| 市区町村 | address.city |
| 職業 | jobName |
| 会員登録日 | registeredAt |
| 会員登録日経過日数 | registeredAt |
| 会員変更日 | - |
| 会員変更日経過日数 | - |
| カスタム属性 | - |
接客イベント
接客イベントはDataSync Exportで出力できるデータ種別の1種です。 会員別にどのような接客とアクションがあったかを分析するためのデータです。
| 属性 | 概要 | 例 | データ型 |
|---|---|---|---|
| memberId | 会員ID | “c01d3c11-0272-485a-9d0e-72a58f274af0” | 文字列型 |
| eventDateTime | イベント発生日時。タイムゾーン識別子はサイトのタイムゾーンを採用します | “2020-10-10T11:00:00+09:00” | DateTime型 |
| campaignId | キャンペーンID | “10” | 文字列型 |
| campaignName | キャンペーン名 | “詳細ページ購入促進” | 文字列型 |
| widgetId | クリエイティブID | “134” | 文字列型 |
| widgetName | クリエイティブ名 | “タイムセール” | 文字列型 |
| eventName | WidgetPrepare・WidgetOpen・WidgetClose・WidgetActionのいずれか (ターゲティング合致した・クリエイティブ表示・クリエイティブが閉じられた・クリエイティブをクリックした) |
“WidgetOpen” | 文字列 |
コンバージョンイベント
コンバージョンイベントはDataSync Exportで出力できるデータ種別の1種です。 会員別にどのコンバージョンをしたかを分析するためのデータです。
| 属性 | 概要 | 例 | データ型 |
|---|---|---|---|
| memberId | 会員ID | “c01d3c11-0272-485a-9d0e-72a58f274af0” | 文字列型 |
| eventDateTime | イベント発生日時 タイムゾーン識別子はサイトのタイムゾーンを採用します |
“2020-10-10T11:00:00+09:00” | DateTime型 |
| conversionId | コンバージョンのID | “1” | 文字列型 |
| campaignName | コンバージョン名 | “商品購入” | 文字列型 |
データ型
| 型 | 制約 | 例 |
|---|---|---|
| 文字列型 | 1文字以上、256文字以下 | “gold” |
| 数値型 | -(2の31乗) ~ 2の31乗 - 1 | 40 |
| Boolean型 | trueまたはfalse | ture,false,True,False |
| Date型 | ISO 8601拡張形式(※1)に準拠した日付フォーマット。 右記の例のような「YYYY‐MM‐DD」の形式。 |
“2019-03-12” |
| DateTime型 | ISO 8601拡張形式(※1)に準拠した日時フォーマット。 右記の例の用に時刻指示子(「T」)とタイムゾーン指定子(「Z」や「+09:00」など)は必須です。 |
“2019-03-12” |
| 列挙型 | 列挙型の括弧の中に記入されているうちの1つの値を選択します。 例えば、列挙型(“Purchase”,”Reserve”)であれば、”Purchase” または “Reserve” を選択します。 |
“Purchase” |
※ 列挙型はカスタム属性では利用できません。
カスタム属性
商品コンバージョン属性ないしは、会員属性の予約された属性以外にも任意の属性を指定して計測できます。 カスタム属性の計測を行うには、2点作業が必要になります。
- 計測タグの埋め込み、またはDataSync Importで指定する
- カスタム属性を登録する
現在カスタム属性の登録は、お客様のアカウントの権限では登録いただけません。 カスタム属性の登録は弊社カスタマーサクセスがサポート致します。
z-index
レイヤーを指定します。よりz-indexの値が小さければ下の層に表示されます。クリエイティブが他のバナー等の上に表示されてしまった場合、バナー等より小さいz-indexの値を設定することで、奥に表示できる場合があります。 基本的には数字を指定しますが、グローバル値を設定することができます。
グローバル値
| Value | 意味 | 振る舞い | 互換性 |
|---|---|---|---|
| inherit | 継承 | 親要素の値を継承します | safari,firefox,IE不可 |
| initial | 初期 | 元々の設定が反映されます | IE不可 |
| revert | 切り戻し | 設定が切り戻しされます。デフォルトの設定に戻ります | IE不可 |
| unset | 未設定 | 設定を解除します | IE不可 |