ご注意ください
Yappli連携の詳細については、弊社営業担当にお問い合わせ下さい
ご利用開始までの流れ
KARTEとYappliの双方のサービスとの契約が必要です。利用にかかる費用は、それぞれの運営会社にお問い合わせくださいませ。
・KARTEとYappliの連携費用のお見積もり → Yappliのご契約者様より、株式会社ヤプリのご担当者様にお問い合わせください
・KARTE for Appの費用 → 株式会社プレイドの営業担当までお問い合わせください
Yappli連携概要
Yappliで作られたアプリ（以下、Yappliアプリ）に、KARTEのSDKを組み込むことでKARTE for Appを利用できるようになります。KARTEとYappliの双方のサービス利用が前提となります。
Yappliアプリに、KARTE SDKを組み込むことで以下の3つができるようになります。
- アプリ内の行動のトラッキング
- プッシュ通知の送信
- アプリ内メッセージの表示
ビジュアルトラッキングや、設定値配信はご利用頂けませんのでご注意ください。
また、その他の制約（イベント設計が固定である等）がございます。以下をご参照ください。
ユーザー行動の計測
イベント設計
Yappliアプリでは、KARTEに送信できるイベントがYappliの仕様により決まっているため、イベント設計をする必要はありません。Yappli側でKARTE SDKの組み込み、該当バージョンアプリのストアへのリリース作業が完了すると、トラッキングが開始されます。
NativeとWebViewのユーザー行動の紐付け
- WebViewのページにKARTEの計測タグが入っていない場合
- KARTE側における対応は不要です。
- WebViewを閲覧時に、アプリのviewイベントが送られます。その際、ページタイトルとURLがパラメータで紐づく形で送信されるので、URL単位でどのページを見たかという情報はKARTEでユーザーに紐づく形で解析されます。
- WebViewのページにWebにKARTEの計測タグが入っている場合（WebでもKARTEを利用している場合）
- KARTE側における対応は不要です。
- WebViewで発生したviewイベントには、ユーザーエージェントで
Yappliという文字列が含まれるので、セグメント作成時に指定していただくことが可能です。
アプリとWebのユーザーの紐付け
- WebView内にログイン機能がある場合は、Webview内でログインすることで、アプリとWebのユーザーが紐づきます（KARTEが同一のユーザーとして認識します）。
- WebView内にログイン機能がない場合（アプリのNative部分にのみログイン機能がある場合）は、現状アプリとWebのユーザーの紐付けができません。
プッシュ通知の配信
- KARTEで計測しているユーザーの属性データや行動データを元にユーザーをセグメントし、プッシュ通知を配信することができます。
- KARTEのPUSH通知の仕組みについては、SDKの実装をする - プッシュ通知の設定をするを参照ください
- YappliのPUSH通知配信機能も利用可能ですが、KARTE計測のデータとは連動していない点についてご留意下さい
ご注意ください
リンク先として指定したdeeplinkがYappliで構築されたアプリ上で遷移可能か否かはYappli側の仕様に依存します。施策実施時にご確認ください。
アプリ内メッセージの表示
- KARTEで計測しているユーザーの属性データや行動データを元にユーザーをセグメントし、アプリ内メッセージを配信することができます。
- アプリ内メッセージの配信は、通常のKARTE for Appと同じ仕様のため、KARTE for App -アプリ内メッセージ-をご確認ください。
ご注意ください
リンク先として指定したdeeplinkがYappliで構築されたアプリ上で遷移可能か否かはYappli側の仕様に依存します。施策実施時にご確認ください。
Yappli連携で送信されるイベント
Yappli連携を有効化した場合、以下のイベントが送信されます
※webviewから送信されるイベントは含まれません
標準的なイベント
SDKが標準で自動送信するイベントをご確認ください
viewイベント
| 送信タイミング | フィールド | 備考 |
|---|---|---|
| トップ画面閲覧 | view_name：top title：トップ |
viewはview_nameとtitleを記載ください |
| 商品詳細 | view_name：item_detail title：<商品名> |
※動的な値の場合には<◯◯>で表現ください |
| フリーレイアウト機能で作成された画面が表示されたとき | view_name：bio title： |
title : Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。 例）HOME |
| ニュース画面が表示されたとき | view_name：pr_master title： |
title : Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。例）ニュース |
| 電子書籍画面が表示されたとき | view_name：book_master title： |
title : Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。例）電子書籍 |
| 電子書籍Reader画面が表示されたとき | view_name：book_reader title： |
title : Yappli管理画面で作成した機能に設定した作品名が入ります。 |
| クーポン一覧画面が表示されたとき | view_name：coupon_master title： |
title : Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。例）クーポン一覧 |
| クーポン詳細画面が表示されたとき | view_name：coupon_detail_basic title： |
title : Yappli管理画面で作成した機能に設定したクーポンタイトルが入ります。 |
| 通知履歴画面が表示されたとき | view_name：notification title： |
title : Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。例）通知履歴 |
| ポイントカード画面が表示されたとき | view_name：point_card2 title： |
title : Yappli管理画面で作成した機能に設定したコンテンツ名+（online or offline）が入ります。例）ポイントカード（online） |
| スタンプカード画面が表示されたとき | view_name：stamp_card_detail title： |
title : Yappli管理画面で作成した機能に設定した管理用タイトルが入ります。 |
| コードリーダーを立ち上げたとき | view_name：code_reader_start title： |
title : code_reader_start |
| その他画面が表示されたとき | view_name：more title： |
title : Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。例）その他 |
identifyイベント
アプリ起動時にログインしていた場合にuser_idのみ送信されます。
その他のカスタムイベント
イベント名、送信タイミングが空の行は、直上の行のイベントで送信されるfieldを意味します
| イベント名 | 送信タイミング | フィールド | データ型 | 備考 |
|---|---|---|---|---|
| coupon_detail_swipe | クーポン画面で「使う」ボタンをスワイプしたとき | category | 文字列 | Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。 |
| action | 文字列 | 使うボタン | ||
| label | 文字列 | "クーポンのタイトルが入力：クーポンタイトルが表示されます。 クーポンのタイトルが未入力：クーポンIDが表示されます。 例）urn:yappli:0287f-241487ab-005-c222e127:12" |
||
| coupon_master_favorite | クーポン一覧画面で「お気に入り」ボタンが押されたとき | category | 文字列 | Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。 |
| action | 文字列 | お気に入りボタン | ||
| label | 文字列 | "クーポンのタイトルが入力：クーポンタイトルが表示されます。 クーポンのタイトルが未入力：クーポンIDが表示されます。 例）urn:yappli:0287f-241487ab-005-c222e127:12" |
||
| coupon_detail_favorite | クーポン詳細画面で「お気に入り」ボタンが押されたとき | category | 文字列 | Yappli管理画面で作成した機能に設定したコンテンツ名が入ります。 |
| action | 文字列 | お気に入りボタン | ||
| label | 文字列 | "クーポンのタイトルが入力：クーポンタイトルが表示されます。 クーポンのタイトルが未入力：クーポンIDが表示されます。 例）urn:yappli:0287f-241487ab-005-c222e127:12" |
||
| push_dialog | プッシュ通知のポップアップが表示されたとき | category | 文字列 | プッシュ通知 |
| action | 文字列 | 通知開封 | ||
| label | 文字列 | プッシュ通知のメッセージ内容 | ||
| push_dialog_close | プッシュ通知のポップアップを閉じたとき | category | 文字列 | プッシュ通知 |
| action | 文字列 | 通知閉じる | ||
| label | 文字列 | プッシュ通知のメッセージ内容 | ||
| push_tap_detail | プッシュ通知のポップアップをタップして詳細を表示をしたとき | category | 文字列 | プッシュ通知 |
| action | 文字列 | 通知詳細 | ||
| label | 文字列 | プッシュ通知のメッセージ内容 | ||
| notification | 通知履歴機能で詳細をタップしたとき | category | 文字列 | 通知履歴 |
| action | 文字列 | 履歴詳細 | ||
| label | 文字列 | プッシュ通知のメッセージ内容 | ||
| stamp_card_complete | スタンプカードをコンプリートしたとき | category | 文字列 | スタンプ |
| action | 文字列 | 完了 | ||
| label | 文字列 | スタンプカード名＋完了 例）スタンプカード完了 | ||
| stamp_card_incentive | スタンプカードで特典を表示したとき | category | 文字列 | スタンプ |
| action | 文字列 | 特典表示 | ||
| label | 文字列 | {n}個目の＋特典表示 例）12個目の特典表示 | ||
| stamp_card_receipt | スタンプカードで「特典を受領」ボタンを押したとき | category | 文字列 | スタンプ |
| action | 文字列 | 特典詳細 | ||
| label | 文字列 | {n}個目の＋特典詳細 例）12個目の特典詳細 |