どのようにお手伝いできますか?

PBA Web SDKの実装テスト

  • 更新

概要:Web SDKのPBAプラグインが正しく実装されているかをテストします。

PBA Webイベントのテスト

テストページの仕組み

Web SDKがPBAに送信したWebイベントは、日次処理後にPBAダッシュボードとローデータレポートで利用できるようになります。テストでは、日次処理を待たずにテストイベントを送信して確認できるため、効率的に検証できます。テストイベントは、以下のように処理されます。

  • 受信時に解析と検証が行われます。 
  • ユーザーインターフェースで確認できます。処理エラーがある場合は、その内容も表示されます。エラーがある場合は、イベントを修正して再送信し、正しく処理されることを確認してください。 
  • 日次処理では、他のイベントと同様に処理されます。そのため、ダッシュボードとローデータにも追加されます。 

Web SDK実装テストページ

ページのメイン画面

TestScreen_us-en.jpg

  • 新しいイベントから順に表示されます。
  • イベントキャッシュ:
    • 最大100件のイベントを保持します。
    • 新しいイベントを保持するため、古いイベントから削除されます。
    • キャッシュされたイベントは、24時間後に削除されます。
  • ページの操作:
    • 更新間隔の表示:ページは5秒ごとに自動更新されます。
    • すべてクリア:キャッシュからイベントを完全に削除します。注意:同じWeb Devキーを使用するWebサイト間で、キャッシュは共有されます。そのため、別の開発者がテストページを利用している場合、その開発者の画面でもキャッシュがクリアされます。 
    • 一時停止 / 開始:自動更新を一時停止します。開始をクリックするまで、新しいイベントは表示されません。 

イベントテーブルの列

フィールド 説明
時刻(UTC) イベント発生時刻
イベントタイプ

イベントタイプは以下のとおりです。

  • ユーザーが送信するイベント:
    • EVENT
    • setCustomerUserId
    • pageLoad:Webサイトのページが読み込まれる、または再読み込みされるたびに、Web SDKが送信します。
イベント内容

PBAに記録されたイベントのペイロードです。

コメント
  • 有効:PBAがイベントを受信し、記録しました。追加の対応は不要です。
  • 無効:修正が必要なエラーの一覧です。エラーメッセージは以下の形式で表示されます。
    イベントのフィールド名:エラーの説明 
  • エラーメッセージにカーソルを合わせると、詳細を確認できます。

    PBAWebSDKTestingErrorMessagesPopup_en-us.png

 

詳細表示

mceclip0.png

イベントの行をクリックすると、処理後の内容が表示されます。詳細は、Web SDKのイベントパラメータを参照してください。

操作手順

以下の手順を実施してください。

テストモードの有効化

前提条件

テストの前に、対象のWebサイトまたはテスト用WebサイトにWeb SDKを実装してください。

ブラウザの制限

ブラウザでテストモードを有効にすると、どのタブを使用する場合でも、そのブラウザからは指定したWebサイトにのみ接続でき、他のWebサイトには接続できません。同じパソコンから別のWebサイトに接続するには、Chromeの代わりにSafariを使うなど、別のブラウザを使用してください。

テストモードを有効にするには:

  1. SDKが読み込まれていることを確認します。
    1. AppsFlyerの上部メニューで、マイアプリ > [ブランドバンドルを表示]を選択します。
    2. 対象のWeb SDK実装テスト
      を選択します。
      実装テストページが開きます。 Web Devキーが表示されます。

      pba_web_sdk_integration_test_web_dev_key_en-us.png

    3. ブラウザの新しいタブで、Web SDKを実装したWebサイトを開きます。
    4. 右クリックして「検証」を選択し、ブラウザの開発者ツールを開きます。 
    5. Consoleタブを開きます。
    6. コンソールに以下を入力します。
      window.AF_SDK.initPluginsConfig.pba.webAppId

      webAppIDが表示されます。

      testing_pba_integration_webappid_check_en-us.png

    7. webAppIDが、Web SDK実装テストページのWeb Devキーと一致していることを確認します。
  2. テストモードを有効にします。
    1. Webサイトを開いているタブで、Consoleタブを開きます。
    2. 以下を入力します。
      window.AF_SDK.PLUGINS.PBA.turnOnDevMode()
      関数からundefinedが返されます。

      testing_pba_integration_turnondevmode.png

  3. テストモードが有効なことを確認します。
    • Consoleタブに以下を入力します。
      window.AF_SDK.PLUGINS.PBA.isDevModeOn()

      戻り値はtrueです。これは、テストモードが有効であることを示します。 
      PBATestingWebSDKIntegrationIsDevModeOn_en-us.png

テストイベントの送信

  • テストモードで送信したイベントは、実装テストページに表示されます。
  • 注意:テストイベントも処理され、その後PBAレポートに含まれます。レポートへの影響を抑えるため、eventRevenueには小さい値を設定してください。値を送信しない場合、PBAは0を設定します。 

以下で説明する各タイプのサンプルイベントを送信してください。 

手順

操作

(入力するコマンド)

Web SDK実装テストページ

(想定される結果) 

1

ブラウザで新しいタブを開き、Webサイトの任意のページにアクセスします。

Webサイトが開かれる、または再読み込みされるたびに、PBAは'pageLoad'イベントを記録します。

PBATestingWebSDKPageLoadEvent_en-us.png

2

ユーザーとしてWebサイトにログインまたは会員登録し、setCustomerUserIdイベントを発生させます。

mceclip3.png

3

Webイベントの送信を開始し、PBAが正しく処理することを確認します。

注意:

eventRevenueとeventRevenueCurrencyを指定しない場合、以下のデフォルト値が設定されます。

  • eventRevenueCurrency: "USD"
  • eventRevenue: 0

PBAWebSDKTestEventEVENT_en-us.png

詳細は、Web SDKのイベントパラメータを参照してください。

mceclip5.png

トラブルシューティング

テストページにイベントが表示されない

  1. ブラウザの開発者ツールで、Networkタブを開きます。
  2. フィルター欄に「websdk.」と入力します。
  3. HTTPレスポンスコードに応じて、以下のように対応してください。
    • 200:AppsFlyerのテクニカルサポートにお問い合わせください。
    • 400:すべてのパラメータが" "で囲まれていることを確認してください。