カテゴリー
Introduction
Welcome to Channel
チャネルトーク開発ドキュメントへようこそ。 チャネルトークを初めてご利用になる場合は、Webサイトでさらに詳しい情報をご覧ください。 開発ドキュメントには、チャネルトークを有効活用するための情報がまとめられています。 - Open APIとSDKの利用方法をご確認いただけます。 - 各プラットフォーム（Web、iOS、Android）向けのインストールガイドをご覧いただけます。 - Open APIとSDKの仕様（スペック）を確認できます。 チャネルトークに関するご質問がありましたら、お気軽にチャットでお問い合わせください 😊
Channel SDK
チャネルトークは、WebサイトやモバイルアプリにインストールできるSDKを通じて、顧客とコミュニケーションを取るための多様な体験を提供します。注目すべき機能は以下の通りです。 - リアルタイムでのチャット問い合わせ - 顧客が求めるものを見つけられるようサポートするマーケティング機能 - 顧客のニーズを分析できるイベントトラッキング チャネルトークにまだ登録されていない方は、今すぐホームページまたはチャネルトークアプリからぜひご登録ください！ 各プラットフォーム向けSDK - JavaScript SDK - iOS SDK - Android SDK プラグインキーの取得 プラグインキーは、チャネルトークSDKを特定のチャネルと接続するための文字列であり、チャネルトークSDKを使用するにはプラグインキーが必要です。 プラグインキーを取得する方法は以下の通りです： 1. チャネルトークホームページ または チャネルトーク管理画面から登録します。 2. チャネルを作成します。 3. Web管理画面の [チャネル設定] - [基本設定 ] - [ボタンの設置・設定] - [チャットボタンの
Event
このドキュメントでは、チャネルトークSDK（以下 SDK）のイベントについて説明します。 イベントとは？ イベント（Event）とは、Webサイトやアプリケーション内で発生するユーザーの行動を指し、ビジネスに関連するあらゆるイベントを定義できます。 デフォルトで提供されるイベント SDKはデフォルトで以下のイベントを提供します。 - PageView : 顧客が特定のページを閲覧した際のイベント - UserChatOpen : 顧客が接客チャットを新規に開いた際のイベント - MarketingView : 顧客がマーケティングメッセージを閲覧した際のイベント - MarketingClick : 顧客がマーケティングメッセージ内に含まれるURLリンクをクリックした際に発生するイベント - MarketingGoal : マーケティングメッセージにおいて目標として設定したイベント値が発生した際のイベント プロパティとは？ プロパティ（Property）は、イベントを説明する詳細情報です。プロパティデータに基づいて、イベントをより詳細に把握し、適切な意思決定を行うのに役立ちます。 va
Member Hash
このドキュメントでは、Member Hash（以下、メンバーハッシュ）について解説します。 メンバーハッシュ機能（セキュリティ強化設定）とは？ メンバーハッシュ（Member Hash）は、顧客のmemberIdをHMAC-SHA256を用いて暗号化し、適切なユーザーのブートリクエストのみを許可する機能です。セキュリティ強化のため、メンバーハッシュ機能の使用を強く推奨します。 bootに使用するmemberIdは各顧客を識別でき、固有の値である必要があるため、多くの顧客企業ではサービスのIDやメールアドレスなどの情報を使用しています。しかし、このように推測されやすい情報をmemberIdとして使用すると、第三者も容易に他の顧客のmemberIdを推測できるようになります。この場合、第三者が他の顧客の情報を利用してブートし、顧客の電話番号やチャット記録などの機密情報を奪取する可能性があります。 メンバーハッシュ機能は、SDKを直接インストールした自社開発サイトと、一部のビルダープロバイダー（Cafe24、WordPress）で利用できます。一般的にビルダープロバイダーは連携方式に差異があ
Page
このドキュメントではページ（Page）について解説します。 ページとは？ ページは現在表示されている画面に関する情報を表す値です。ページは特定のEventを送信したり、特定のワークフローを表示するために活用できます。 URLの代わりにページを使用する理由 URLには2つの限界点があります。 1. SPA(Single Page Application) 環境ではURLは変更されません。 2. モバイルアプリケーションはURLを持ちません。 URLの代わりにページを使用することで、現在表示されている画面に関する情報を円滑に活用できます。 ページがデフォルトで持っている情報 プラットフォームによって異なります。 - Web：canonical URLを参照 - iOS：ViewControllerクラスの名前 - Android：Activityクラスの名前 ページ値を変更できますか？ setPageとresetPage メソッドを使用できます。 詳細な情報は以下のリンクをご参照ください。 - Web：setPage / resetPage - iOS：setPage / resetPag
Canonical URL
このドキュメントでは標準URL（Canonical URL）について説明します。 標準URLとは？ 標準URLとは、重複または類似した複数のページの中で最も代表的とみなされるページのURLを指します。 例えば、同一ページのURLが複数存在するケース（例： https://channel.io/en/pricing, https://channel.io/en/pricing?show=true）では、そのうちの1つのURLが標準URLとなる可能性があります。 チャネルトークSDKは、以下の手順で標準URLを照会します。 1. relプロパティの値が "canonical"である link タグの href プロパティの値を照会します。 <link rel="canonical" href="{canonicalUrl}" /> 2. 上記の条件に該当するlinkタグがない場合、URLを照会します。 SDKが標準URLを正常に照会できるかどうかをテストできます。詳細についてはこちらを参照してください。 標準URLを使用すべき理由 標準URLは統計処理に役立ちます。 例えば、以下のような2
用語集
チャネルフロント チャネルトークSDKを通じて提供されるチャットボタン、ポップアップ、メッセンジャーなどのユーザーインターフェースをすべて含む概念です。 チャネルボタン メッセンジャーを開くボタンです。 メッセンジャー メッセンジャーは、ホーム、会話、設定などの機能をユーザーに提供する総合的なインターフェース要素です。 チャネルデスク チャネルトークが提供するAll-in-oneツールを指します。チームメンバーはチャネルフロントの全機能をチャネルデスクで管理します。 プッシュ通知 チャネルトークからウェブまたはアプリケーションに送信されるプッシュ通知です。 プッシュ通知の種類は以下の通りです。 アプリ内プッシュ通知 モバイル環境において、アプリまたはモバイルウェブを使用している場合に有効です。以下の2種類の画面を表示します。 - チームメンバーからユーザーへ送信されたメッセージ通知の場合 - 吹き出しタイプのマーケティングメッセージを受信する場合 リモートプッシュ通知 モバイル環境において、アプリまたはモバイルウェブを使用していない場合に有効です。以下のような画面を表示します。 - チ