ユーザーマスタを利用すると、各広告媒体への連携に必要な個人情報を簡単に取得できます。

ユーザーマスタとは?

ユーザーマスタとは、KARTEに送信されたidentifyイベント・attributeイベント・セグメント・ディメンションについて、ユーザーごとに各フィールドの最新値を保持するマスタテーブルです。
従来であれば、KARTEイベントを全期間分取得し、ユーザーごとの最新値を取得するクエリを書く必要がありました。ユーザーマスタを利用することでその必要がなくなり、個人情報取得のために大量のクエリリソースを消費せずに済みます。

ユーザーマスタの利用

コネクタ作成画面の利用するデータで「KARTEデータ/ユーザーマスタ」を選択すると、ユーザーマスタを利用できます。
下記のスキーマ情報を参考に、カラムマッピングを設定してください。
identify、attributeのフィールドを利用したい場合は、下記のように $.フィールド名の形で指定してください。
スクリーンショット 2023-12-19 19.35.18

スキーマ情報

設定項目説明
api_keyapi_key
user_iduser_id
sync_date最後にイベントが発生した時間
is_memberメンバーか否か
name氏名
emailidentify.emailで送った場合のemail
email_subscriptionidentify.subscriptionで送った場合のsubscription
line_idplugin_line_identify.line_user_idで送った場合のline_user_id
line_subscriptionplugin_line_identify.subscribeで送った場合のsubscribe
fcm_tokenplugin_native_app_identify.fcm_tokenで送った場合のfcm_token
fcm_token_subscriptionplugin_native_app_identify.subscribeで送った場合のsubscribe
phoneidentify.phoneで送った場合のphone
phone_subscriptionidentify.phone_subscribeで送った場合のphone_subscribe
dimensionsKARTE共通のディメンション
dimensions.os_nameOS名
dimensions.pvセッション内のPV数
dimensions.visit_count来訪回数
dimensions.seconds_from_last_session前回来訪からの期間
dimensions.spend_time滞在時間
dimensions.buy_count購入回数
dimensions.total_revenue総購入金額
dimensions.context_mode行動モード (Web)
dimensions.visit_count_in_last_week直近7日間の来訪回数
dimensions.visit_count_in_last_month直近4週間の来訪回数
dimensions.first_view_date初回閲覧日
dimensions.goal_countゴール(購入等)の総回数
dimensions.goal_count_in_last_week直近7日間のゴール回数
dimensions.goal_count_in_last_month直近4週間のゴール回数
dimensions.before_goal_date前回の購入日
dimensions.referrer_urlリファラーURL
dimensions.seconds_from_pv前回PVからの経過秒数
dimensions.utm_medium流入元(メディア)
dimensions.utm_source流入元(ソース)
dimensions.visit_count_in_today今日1日での来訪回数
dimensions.languageアクセス時の言語
dimensions.buy_span購入頻度
dimensions.average_buy_revenue平均購入金額
dimensions.gender性別
dimensions.age年代
dimensions.pref_cd都道府県
dimensions.cart_priceカート金額
dimensions.cart_quantityカート商品数
dimensions.cart_countカート回数
dimensions.favorite_countお気に入り回数
dimensions.favorite_quantityお気に入り商品数
dimensions.favorite_total_amountお気に入りの商品合計金額
dimensions.view_item_count閲覧商品数(累計)
dimensions.view_item_count_in_sessionセッション内の閲覧商品数
dimensions.apply_count申し込み回数
dimensions.request_count資料請求回数
dimensions.contact_countお問い合わせ回数
dimensions.reserve_count予約回数
dimensions.view_date最終閲覧日
dimensions.buy_date最終購入日
dimensions.cart_date最終カート追加日
dimensions.cart_statusカートステータス
dimensions.cart_item_idsカート内の商品ID
dimensions.facebook_cookie_fbpFacebook Cookie(fbp)
dimensions.google_analytics_cookie_idGoogle Analytics Cookie ID
dimensions.yahoo_cookie_yjr_yjadYahoo Cookie(yjr_yjad)
dimensions.user_agentユーザーエージェント
dimensions.ip_addressIPアドレス
dimensions.idfaIDFA(iOS広告識別子)
dimensions.aaidAAID(Android広告識別子)
dimensions.line_cookie_lt_cidLINE Cookie(lt_cid)
identifyidentifyイベントの全フィールドの最新の値
attributeattributeイベントの全フィールドの最新の値(紐付けテーブルのデータは含まれません)
user_fieldsカスタムで作成されたディメンション
identify_dateidentifyイベントの最新の送信日時
attribute_dateattributesイベントの最新の送信日時
shorten_segmentsイベント発生時に計算した最新のセグメント

ユーザーマスタのデータの確認

カラムマッピング設定後、保存ボタンを押すと、ユーザーマスタのデータを確認できます。
ここで、正しく抽出されているかご確認ください。

ターゲティングでの活用例/設定方法

オーディエンスリスト作成時にも、ユーザーマスタを活用することができます。

過去1年間に購入したユーザーを抽出したい

  • 「データを絞り込み」で、dimensions.before_goal_date / 次の値以上を選択し、相対時間で**-365日**を設定してください。
    スクリーンショット 2024-04-04 17.52.31

特定のセグメントに属したユーザーを抽出したい

  • 「データを絞り込み」で、shorten_segments / 次のいずれかを含むを選択し、抽出したいセグメントを選択してください。
    スクリーンショット 2024-04-04 17.59.20
ご注意ください

・ セグメントの「期間」で「直近7日間」もしくは「直近4週間」が設定されているセグメントには対応しておりません。 ・以下画像の「期間」が設定されているセグメントを設定してもリストは抽出されないためご注意ください。

segment last 7days and last 4 weeks

KARTEユーザーの一覧を抽出したい

  • 「データを絞り込み」で、is_member / 次に等しいを選択し、trueを選択してください。
    スクリーンショット 2024-04-04 18.03.12

identifyイベントのデータを利用して抽出したい

  • 「データを絞り込み」で、identify (JSON) / 次に等しいを選択し、抽出したいデータを設定してください。
    スクリーンショット 2026-02-13 17.06.27

注意点

イベントの情報がユーザーマスタへ反映されるまでに、最大50分ほどかかる場合があります。
コンバージョン補完でユーザーマスタを利用する場合は、各媒体に連携するコネクタの送信スケジュールに「50分」を指定してください。
スクリーンショット 2024-05-22 14.58.22
例えば、送信スケジュールを8時50分に設定した場合、8時までに発生したイベントがユーザーマスタに反映された状態となるため、7時00分〜8時00分のコンバージョンデータに最新の個人情報が反映された状態で各媒体に連携できます。