メインコンテンツまでスキップ

トラッキング（Android）

ユーザーが新しい会話を開始する際のイベントとユーザーアクションを追跡します。 SDKを介して開始されたすべての会話に、カスタムメタデータを添付します。

注意

SDKに含まれているすべてのパブリックAPIは、HelpshiftSdk.install() APIを介してSDKを初期化した後に呼び出す必要があります

会話にタグを追加する​

ShowConversationを呼び出す際にconfigMapオブジェクトにタグを渡すことにより、問題を報告する際にタグを添付できるようになります。キー"tags"を持つ文字列の配列を渡すことができるようになり、問題の作成時にタグとして追加されます。

例:

using Helpshift;

private HelpshiftSdk help;

void Awake(){
    // install call here
}

// configuration map
void openHelpshift(){

    Dictionary<string, object> configMap = new Dictionary<string, object>();
    // other configurations
    // ..
    configMap.Add("tags", new String[] { "tag1", "tag2" })

    // open the support chat screen
    help.ShowConversation(configMap);
}
注意

タグの名前と互換性について

  • タグについては、Helpshiftダッシュボード（設定、タグの順に移動）で事前に作成しておく必要があります。作成していない場合には、これらは無視されます。
  • 添付されているタグは、ダッシュボードに表示されているタグと完全に一致している必要があります。

会話にカスタムメタデータを追加する​

問題の作成時にカスタムメタデータを追加する場合には、以下の手順に従ってください。

  1. トップレベルのカスタムメタデータDictionaryを初期化します
  2. カスタムメタデータDictionaryを定義します
  3. カスタムメタデータDictionaryにキーと値のペアを追加します
  4. カスタムメタデータマップをトップレベルマップに追加します
  5. キー"customMetadata"を持つconfigMapへのマップを、SDK X APIのいずれか（ShowConversation(configMap)のように）に渡します。

以下のコードを使用します。

using Helpshift;

private HelpshiftSdk help;

void Awake(){
    // install call here
}

void openHelpshift(){
    Dictionary<string, string> customMetadataDictionary = new Dictionary<string, string>();
    customMetadataDictionary.Add("Level", "9");
    customMetadataDictionary.Add("Spend", "46.55 USD");
    customMetadataDictionary.Add("Device Timestamp", DateTime.UtcNow.ToLongTimeString());


    Dictionary<string, object> config = new Dictionary<string, object>();
    // other configs...
    //..
    config.Add("customMetadata", customMetadataDictionary);

    help.ShowConversation(configMap);
}
注意

メタデータは、文字列型のキーと値のペアとしてのみ送信してください。

カスタム問題フィールドを設定する​

問題の作成時にカスタム問題フィールドを設定する場合には、以下の手順に従ってください。

  1. トップレベルのカスタム問題フィールドDictionaryを初期化します
  2. カスタム問題フィールドDictionaryを定義します
  3. そのカスタム問題フィールドのために"type"と"value"を追加します
  4. カスタム問題フィールドマップをトップレベルのマップに追加します（keyに構成したキーを、valueにカスタム問題フィールドマップを設定します）
  5. マップをShowConversation(configMap)のキー"cifs"とともにconfigMapに渡します。
using Helpshift;

private HelpshiftSdk help;

void Awake(){
    // install call here
}

void openHelpshift(){

    Dictionary<string, object> joiningDate = new Dictionary<string, object>();
    joiningDate.Add("type", "date");
    joiningDate.Add("value", DateTimeOffset.UtcNow.ToUnixTimeMilliseconds());

    Dictionary<string, string> stockLevel = new Dictionary<string, string>();
    stockLevel.Add("type", "number");
    stockLevel.Add("value", "1505");

    Dictionary<string, string> employeeName = new Dictionary<string, string>();
    employeeName.Add("type", "singleline");
    employeeName.Add("value", "Bugs helpshift");

    Dictionary<string, string> isPro = new Dictionary<string, string>();
    isPro.Add("type", "checkbox");
    isPro.Add("value", "true");

    Dictionary<string, object> cifDictionary = new Dictionary<string, object>();
    cifDictionary.Add("joining_date", joiningDate);
    cifDictionary.Add("stock_level", stockLevel);
    cifDictionary.Add("employee_name", employeeName);
    cifDictionary.Add("is_pro", isPro);


    Dictionary<string, object> config = new Dictionary<string, object>();
    // other configs...
    //..
    config.Add("cifs", cifDictionary);

    help.ShowConversation(configMap);
}
注意
"customIssueFields"キーの使用は非推奨になりました。カスタム問題フィールドを渡す方法 として、"cifs"キーの使用を 強く推奨します。

カスタム問題フィールドのtypeキーの有効な値は、以下の通りです。

  • "singleline"
  • "multiline"
  • "number"
  • "checkbox"
  • "dropdown"
  • "date"

データ型と値の互換性については、以下の表をご覧ください。

データ型値コメント
singlelinestring255文字の文字数制限があります
multilinestring100.000文字の文字数制限があります
numberstring
dropdownstringドロップダウンオプションは特定のカスタム問題フィールドのために存在する必要があります
datenumberミリ秒単位のエポック時間です。例: DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()
checkboxstringブール値による文字列表現です。例: "true"または"false"。これは、ダッシュボードのチェックボックス型のカスタム問題フィールドに対応しています。
注意

カスタム問題フィールドのキーと互換性について

  • カスタム問題フィールドは、Helpshiftダッシュボード（「設定」、「カスタム問題フィールド」の順に移動します）で作成する必要があります。そうでない場合には、これらは無視されます。詳細については、こちらをご参照ください
注意

Breadcrumbsおよびデバッグログ APIでは、フォーマットされた文字列の受け渡しはサポートされていません。データの受け渡しについては、シンプルなString型のみが推奨されています。

例:

  • "{\"key\":\"value\"}" - JSON文字列、これはサポートされていません
  • "キー - 値" - シンプルな文字列、これはサポートされています
注意

SDK X v10.1.0以上に対応しています

Breadcrumbsは、イベントやエンドユーザーのアクションの追跡に使用されます。これは、お客様がHelpshiftのエージェントダッシュボードにあるすべての新しい会話と一緒に渡されるエンドユーザーのアクションに関するデバッグ情報を追加する際に役立ちます。 Breadcrumbsを残すには、LeaveBreadcrumb APIを使用します—

例:

help.LeaveBreadcrumb("<any-breadcrumb-string>");

Breadcrumbsは、設定されているBreadcrumbsの制限内で収集されます。制限は、Helpshiftのエージェントダッシュボードにある「アプリの設定」のSDKの構成セクションで設定します。Breadcrumbsは、FIFOキューに集められます。Breadcrumbsを消去する場合には、ClearBreadcrumbs APIを使用します—

例:

help.ClearBreadcrumbs();

デバッグログ​

注意

SDK X v10.1.0以上に対応しています

アプリケーション内の特定の場所にデバッグログを追加し、ユーザーによって提出された問題のデバッグに役立てたい場合には、さまざまなロギングを提供するHelpshiftLogクラスとそのメソッドをインスタンス化して使用することができます。たとえば、デバッグレベルのログを添付する場合には、以下のコードを追加してください

例:

HelpshiftLog.d("<debug-tag>", "<debug-message>");

デバッグログは、設定されているデバッグログの制限内で収集されます。制限は、Helpshiftのエージェントダッシュボードにある「アプリの設定」のSDKの構成セクションで設定します。デバッグログは、FIFOキューに集められます。

ユーザー固有のメタデータのトラッキング​

グローバルユーザーデータの更新​

このAPIは、新しいユーザーIDシステムとともに使用することを意図しています。ログインユーザーに関連するグローバル属性を更新するには、このAPIを使用してください。

using Helpshift;
// other imports

public class MyGameControl : MonoBehaviour
{
    private HelpshiftSdk helpshiftSdk;

    void Awake(){
    this.helpshiftSdk = HelpshiftSdk.GetInstance();

    Dictionary<string, object> masterAttributes = new Dictionary<string, object>();
    masterAttributes.Add("<master-attribute-key>", "<master-attribute-value>");

    helpshiftSdk.UpdateMasterAttributes(masterAttributes);
    }
}

アプリ固有のユーザーデータの更新​

このAPIは、新しいユーザーIDシステムとともに使用することを意図しています。ログインユーザーに関連するアプリ固有の属性を更新するには、このAPIを使用してください。

using Helpshift;
// other imports

public class MyGameControl : MonoBehaviour
{
    private HelpshiftSdk helpshiftSdk;

    void Awake(){
    this.helpshiftSdk = HelpshiftSdk.GetInstance();

    Dictionary<string, object> appAttributes = new Dictionary<string, object>();
    appAttributes.Add("<app-attribute-key>", "<app-attribute-value>");

    helpshiftSdk.UpdateAppAttributes(appAttributes);
    }
}