概要

WalkMe Mobile SDKバージョン1.7.0以降、アプリのエレメント精度設定を調整して、アプリ内の特定のエレメントを識別するWalkMeの機能を改善できます。 利用可能な調整は、アルゴリズムの違いのためにOS、ネイティブアプリとハイブリッドアプリ間で異なります。

ベストプラクティスとして、エンドユーザーのタップ領域を最大限にするために、エレメント選択を可能な限り最大の領域に展開することをお勧めします。 このように、エレメントにはキャプチャに最も考えられる詳細が含まれています。

精度設定を追加するための手順

1. Mobileコンソールで、設定 アプリの設定> エレメント>に移動します。
2. エレメントにカーソルを合わせ、精度設定アイコンをクリックします：
   
3. 目的の精度設定を選択します。
4. 保存をクリックします。

以下のすべての情報は、スマートウォークスルーステップにも適用されます：

精度設定マトリックス

精度変更 - タイミング

精度へのすべてのアップデートが即時に行われるわけではありません。 これは、変更がサーバーサイドのキャンペーン自体に移行されるやり方が原因です。 精度を更新する2つの方法に対してコンテンツを再生する4つの方法の簡単なビジュアルを以下に示します：

精度設定定義

デフォルト

WalkMeアルゴリズムでは、エレメントの存在を評価するために多くの側面を要因に合わせます。 詳しいエレメント説明については、コンソールでキャプチャされたエレメントをクリックすると表示されます。

テキストを無視

テキスト、ダイナミックテキスト、または頻繁に変化するテキストでエレメントをキャプチャするのに便利です。 この設定は、エレメントを検索する際に、キャプチャされたテキストを無視するようにアルゴリズムに指示します。 しかし、キャプチャされたコードにテキスト値がない場合、この設定には意味がありません：“text”:”[here]”

テキストを一致

キャプチャされたテキスト（上記の画像を参照）がある場合、「テキストを一致」はアルゴリズムを絞り込んでテキストにフォーカスすることができます。 Regexを使用できますが、必要ではありません。

• 注：これはネイティブエレメント（ハイブリッドではない）にのみ適用されます。

テキストで識別

ハイブリッドエレメントでキャプチャされたテキストにフォーカスできるようにします。

• 注：キャプチャされたテキストが複数の文字列に区切られている場合、WalkMeは最初の文字列でのみ識別します。

画面を無視

一部の画面値は動的か、あるいは説明が不十分のいずれかです。 この設定により、これらの場合の画面値を無視することができます。

• 注：ウォークスルーの場合、最初のステップのみ画面を考慮に入れるため、最初のステップの画面値が動的である場合、画面を無視する必要があります。 以降のすべての手順では、画面値を考慮しません。

クラス名を無視

Androidでは、エレメントにクラス名を付けることができます。 これは、キャプチャで「class_name」と書かれています。 選択しようとしているエレメントに動的クラスがある場合は、クラス名を無視することが重要です。

• 注：これはAndroidにのみ適用されます

IDを無視

class_nameと同様に、IDはAndroidに固有です。 すべてのエレメントキャプチャにIDがあるわけではありませんが、IDが一意でない場合は、トラブルシューティング中に無視するのに便利です

アクセシビリティIDを無視

WalkMeは、この記事で説明されているさまざまな要因に基づいてエレメントをフォーカスして識別できます。 一部のアプリ開発者は、アクセシビリティID（画像、テキスト、言語などの他のすべての動的特性に関係なく、固有の識別子）を使用してエレメントをコードします。 エレメントにアクセシビリティIDがある場合、WalkMeはそれにフォーカスします。 この設定は、必要が生じた場合、アクセシビリティIDを無視するのに使用できます。

階層（xpath）で検索

デフォルトでは、WalkMeはアルゴリズム内の階層に主にフォーカスします。 階層では、選択されたエレメントの「パス」を調べます。 たとえば、ページ>リスト>行1>セル1などです。 コンソールでは、これが[x-path]です。 iOS 13以降と12以降の間に階層が異なる可能性がある既知の問題があります。 可能であれば、iOS 13のデバイスとiOS 12のデバイスをテストします。 iOS 13+に移行する人が増えているため、これはますます一般的ではなくなります。

タイプで検索

ウェブと比較すると、これは「エレメントのクラス」です。 たとえば、画面上の各リストアイテムまたは各保存ボタンには、おそらく同じクラスがあります。 これはコンソール内の[タイプ]です。 タイプを使用するための最も一般的なユースケースは、上述したiOS12/iOS13階層問題を排除するためです。

可視性をチェック（iOS SWTステップにのみ適用されます）

アプリ画面はレイヤーといくつかのエレメントで開発され、最上層の下に隠されていますが、技術的にはまだ存在します。 WalkMeでは、隠しエレメントを指す手順につながるこれらのエレメントを見つけることができます。 解決するには、WalkMeがこれらのエレメントを本当に表示しているときにのみ検索できるよう、この設定を有効にします。