登録ステップ

1. Singular プラットフォームのDeveloper Tools → Testing Consoleに移動します。
2. Add Deviceボタンをクリックします。
3. ドロップダウンからデバイスタイプを選択
   • Androidを選択します：Google Advertising ID (GAID/aifa)、AppSetID (asid)、AndroidID (andi)の順に選択してください。
   • iOS：利用可能な場合はIDFAを使用（ATTの同意が必要）、そうでない場合はIDFVを使用
4. デバイスから取得したデバイスIDを入力
5. 識別しやすいように特徴的なデバイス名を入力
6. デバイスを保存]をクリックして登録を完了します。

Androidデバイス識別子

推奨される方法Singular Device Assistアプリ（Android）を使用してGAID/aifaを取得する。

別の方法Singular SDKのロギングを有効にし、Android LogCatから識別子を取得する：

SingularConfig config = new SingularConfig(SdkKey, SdkSecret)
    .withLoggingEnabled()
    .withLogLevel(1);

LogCatのサンプル出力：

2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - andi : 8868adc2f7ffffff
2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - asid : 12dc3652-5e46-f2bb-a93a-b3c092ffffff
2023-06-01 15:48:32.224 27442-27560/com.singular.test D/Singular: DeviceInfo [worker] - aifa : 3bbc76b0-cebb-4a9f-b6ec-10ca1affffff

iOSデバイス識別子

IDFAの取得：ATTフレームワークが実装され、トラッキングが許可されている場合に使用します。

方法1：Singular Device Assistアプリ（iOS）-プロンプトが表示されたらトラッキング許可を与える。

方法 2:Xcode のデバッグコンソールに IDFA を記録する：

// Example in Swift
print("IDFA", ASIdentifierManager.shared().advertisingIdentifier.uuidString)

// Example in Objective-C
NSString *IDFA = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"IDFA: %@", IDFA);

IDFV キャプチャ：ATTが実装されていないか、トラッキングが許可されていない場合に使用する。

// Example in Swift
print("IDFV", UIDevice.current.identifierForVendor!.uuidString)

// Example in Objective-C
NSString *IDFV = [[[UIDevice currentDevice] identifierForVendor] UUIDString];
NSLog(@"IDFV: %@", IDFV);

目的

クロスデバイスのユーザートラッキングとアナリティクスのために、カスタムユーザーIDがSingularに正しく送信されることを検証します。

テスト手順

1. テストコンソールにデバイスを登録
2. テストデバイスでアプリを開く
3. 自動的に送信されない場合は、ユーザーID（ログインなど）を送信するアクションをトリガーする
4. テストコンソールでイベントの詳細を展開し、custom_user_idフィールドに期待される値が含まれていることを確認する。

トラブルシューティング

カスタムユーザーIDが表示されない場合：

• ユーザーIDを設定するメソッドが、アプリフローの適切なタイミングで実際に呼び出されることを確認する。
• テスティングコンソールで見えるように、"setting_custom_user_id "という名前の Singular SDK イベントを追加する。
• ユーザーIDの割り当てを確認するためにSDKのログをチェックする

目的

イベントトラッキングの実装が正しい名前と属性のイベントを Singular に送信することを確認する。

テスト手順

SDKインテグレーションで実装された各イベントについて

1. アプリでイベントをトリガーし、テストコンソールに正しい名前でイベントが表示されることを確認します。
2. イベント行をクリックして詳細を展開し、イベントデータセクションに期待される属性が含まれていることを確認します。

トラブルシューティング

イベントが表示されない場合

• デバイスがテストコンソールに完全に登録された後にアプリが開いたことを確認する。
• イベントのエクスポートログを確認する（～3時間の遅延の後に利用可能
• イベントをトリガーするコードがアプリ内で適切に実行されたことを確認する。

その他のリソース

• イベント測定を理解する
• Singularな標準イベントのリファレンス

目的

収益トラッキングの実装が、購入金額、通貨、追加の収益詳細を正しくレポートすることを検証する。

テスト手順

実装された各収益イベントタイプについて

1. アプリで収益イベントをトリガーし、テストコンソールにイベントが表示されることを確認します。
2. イベント行を展開し、以下のフィールドが存在することを確認します：
   • pcc - 通貨コード（例：USD、EUR
   • r - 収益金額
   • 追加収益イベント属性（実装されている場合

その他のリソース

• アプリ内課金検証FAQ

目的

ディープリンクの実装がシングラーリンクを正しく処理し、ユーザーを意図したアプリ内目的地に誘導することを確認します。

1.テスト先の設定

1. Settings（設定） →SingularプラットフォームのApps（アプリ）に移動する。
2. アプリを見つけ、クリックして設定を開きます。
3. SDK統合で認識されたデスティネーションハンドラコードに一致するディープリンクデスティネーションを追加します。

2.テストリンクを作成する

1. Attribution → Manage Linksに移動し、アプリを選択します。
2. Create Linkをクリックします。
3. リンクタイプ]で[カスタムソース]を選択し、[ソース名]で[メール]を選択します。
4. リンク名を入力
5. リンク設定とリダイレクトセクションを展開する
6. ディープリンクのドロップダウンからテスト先を選択
7. 他のプラットフォームのフォールバック先フィールドにウェブサイトのURLを入力する。
8. 生成]をクリックし、[クリックスルー追跡リンク]フィールドからリンクをコピーします。

3.リンク機能のテスト

1. アプリがテストデバイスにインストールされていることを確認します。
2. コピーしたリンクをテスト端末にメールで送信
3. デバイスから電子メールを開き、リンクをクリックします。
4. テストコンソールで、セッション引数にディープリンクの値が表示されることを確認する。

Android テストの代替方法

コマンドライン検証用のADB（Android Debug Bridge）を使用して、Android のディープリンクをテストします。

前提条件

• ADBをインストールする（Android SDKプラットフォーム・ツールに含まれている）
• デバイスの開発者向けオプションとUSBデバッグを有効にする。
• デバイスをUSB経由でコンピューターに接続する

テスト・コマンド

adb shell am start -W -a android.intent.action.VIEW -d "https://yourdomain.sng.link/xxxxx?_dl=yourapp://deeplink"

トラブルシューティング

問題ディープリンクが既存のインスタンスに切り替わらず、新しいアプリインスタンスを開く。

解決方法AndroidManifest.xmlのアクティビティに以下を追加します：

android:launchMode="singleTask"

launchModeオプションについては、Googleの<activity>ドキュメントを参照してください。

目的

遅延ディープリンクがアプリのインストール前にクリックされたリンクを適切に処理し、初回起動時にユーザーを意図した目的地に誘導することを検証する。

テスト手順

1. テストコンソールでセッションイベントを確認し、遅延ディープリンクが有効になっていることを確認する。
2. 上記のディープリンクの手順に従って、テスト先とリンクを設定します。
3. テストデバイスからアプリをアンインストールする
4. デバイスの広告識別子をリセットする
5. テストコンソールに新しい識別子を追加する
6. ディープリンクをデバイスに電子メールで送信し、デバイスからリンクをクリックする
7. リンクはアプリストアにリダイレクトされるはずです - アプリをインストールしてください（ローカルビルドの場合、ストアバージョンの代わりにAndroid StudioまたはXcodeからサイドロードしてください）。
8. インストール後、アプリを開く - ディープリンクで指定された目的のページ/コンテンツが表示されるはずです。
9. テストコンソールで、延期されたディープリンクの値が最初のセッションイベントに表示されることを確認してください。

目的

アンインストール追跡の実装が、解約分析のためにアプリのアンインストールを正しく検出し、レポートすること を検証すること。

前提条件

テストの前に、以下を確認してください：

• Singularに送信されたFCM/APNSトークン（Android SDKを参照してください：アンインストールのトラッキングと iOS SDK を参照してください：アンインストールのトラッキング)
• アプリの設定ページに入力されたFCMサーバーキー（Android）またはiOSプッシュ証明書

テスト手順

1. アプリを実際のデバイス（エミュレータではない）にインストールする。
2. アプリを開き、Singularに登録されたアプリをインストールする
3. デバイスからアプリをアンインストールする
4. 以下のいずれかの方法でアンインストールイベントを確認する：
   • 属性ログをエクスポートし、アンインストールイベントを見つける（表示されるまでに数日かかる場合があります）。
   • 内部 BI システムにポストバックが設定されている場合、アンインストールに関するポストバックを受信する
   • 検証については、Singular サポートまたはカスタマーサクセスマネージャーにお問い合わせください。

よくある原因

デバイスが登録され、イベントがイベントログに表示されない場合、以下を確認してください：

• ライブモニタリングが必要です：テストコンソールは、デバイスが選択され、🟢ライブインジケータが表示されている場合にのみ、イベントをライブ表示します。過去のイベントを取得しない
• アプリが開いている：セッション・イベントを生成するためにテスト・デバイスでアプリが開かれていること。
• イベントのトリガー：特定のイベントをテストする場合は、アプリでトリガーアクションが実行されていることを確認する。
• デバイス ID の正確さ：テストコンソールに入力されたデバイスIDが正しいことを再確認する。
• デバイスIDタイプ：ATTプロンプトのないiOSでは、IDFAを使用できません。

SDKバージョン12.0.0以上

Singular SDK 12.0.0から、_InstallReferrerイベントをテストする必要がなくなりました。アプリがストアにプッシュされると、SDKは自動的に_InstallReferrerデータを最初のセッションに配置します。テストコンソールでセッションが表示されることを確認するだけです。

SDKバージョン <12.0.0>

旧バージョンのAndroid SDKの場合、テストコンソールで_InstallReferrerイベントを確認し、適切なインストール属性を確認する必要があります。

検証ステップ

IDFA の精度を再確認する：

• トラッキング許可を付与した Singular Device Assist アプリ（iOS）を使用する。
• XcodeのデバッグコンソールでIDFAのログを取る
• App Tracking Transparency status "フィールドでエクスポートログ（1時間以上後）をチェック - 値0（Undetermined）は、ATTプロンプトが表示されないことを意味する。

設定のチェック

1. デバイスの設定：設定 → プライバシー → トラッキングで "Allow Apps to Request to Track "が有効になっていることを確認。
2. ATTプロンプト：テスト中にATTプロンプトが表示されたことを確認 - 表示されない場合、IDFAはトラッキングされていない
3. IDFAのリセット：デバイスが以前に使用されていた場合、設定 → プライバシー → トラッキングで広告識別子をリセットする。
4. SDKバージョン：最新のSingular SDKバージョンが正しく統合されていることを確認
5. SDKの初期化：SDKがドキュメントに従ってAppDelegateまたはSceneDelegateで初期化されていることを確認します。
6. エラーの確認：SDKの初期化やトラッキングエラーをXcodeコンソールで確認する。

以下の手順を行っても問題が解決しない場合は、Apple ATTのドキュメントを参照するか、Singularインテグレーションエンジニアに連絡してください。

削除プロセス

1. テストコンソールでデバイスの横にある編集アイコンをクリックします。
2. 表示されるサイドバーで、デバイスの削除をクリックします。
3. 削除すると、すべてのイベントログが消去され、Singular からデバイスのアトリビューションデータが削除されます。

参照：インストールアトリビューションテストのためにデバイスをリセットする方法

要件のリセット

同じデバイスでSDKインテグレーションを再テストするには、デバイスからローカルにキャッシュされたデータを削除し、Singularプラットフォームでデバイスのアトリビューションをクリアします。

Androidリセット手順

1. アプリを終了し、実行中でないことを確認します。
2. 設定メニューに移動します。
3. アプリ」に移動し、アプリを長押しして「アプリ情報」を選択します。
4. ストレージ]を選択し、[キャッシュの消去]と[データの消去]をクリックします。
5. Testing Consoleでデバイスを選択し、Editアイコンをクリックし、Delete Deviceをクリックして属性を削除します。

iOSリセットの手順

1. アプリを終了し、デバイスからアンインストールします。
2. テストコンソールで、デバイスを選択し、「Edit（編集）」アイコンをクリックし、「Delete Device（デバイスの削除）」をクリックして属性を削除します。

イベントログのインターフェース

デバイスを登録し、イベントを送信すると、テストコンソールのイベントログにイベントがリアルタイムで表示されます。

イベントの詳細

イベント行をクリックすると、アプリから送信されたイベントの詳細（すべてのパラメータと属性を含む）が表示されます。

解決優先度

本番リリース前に解決する必要があります- これらの問題はコア機能を妨げます。

一般的なエラーの問題

• セッションが受信されません：SDKが初期化されていないか、Singularにデータを送信していない
• 無効なSDKキー：SDKキーまたはシークレットが正しく設定されていない
• プラットフォームの不一致：アプリが誤ったプラットフォーム識別子を報告している

解決方法

1. 具体的なガイダンスについては、エラーの説明を確認してください。
2. 該当するプラットフォームのSDK統合ガイドを参照する
3. SDKの構成と初期化コードを確認する
4. 修正後、テスティングコンソールを使用して再テスト
5. 新しいSDK Auditを実行して解決を確認する

解決優先度

ベストプラクティスのために解決すべきである。

よくある警告の問題

• カスタムユーザIDがない：クロスデバイス追跡のためのカスタムユーザーIDが実装されていない
• 収益トラッキングの問題収益イベントがベストプラクティスに従っていない
• イベント属性の欠落：推奨属性なしでトラッキングされたイベント

解決方法

1. 欠落している機能がビジネスに与える影響を評価する
2. 機能の実装ドキュメントをレビューする
3. 要件に合致する機能があれば実装する
4. テストコンソールを使用して実装をテストする

解決優先度

レビューと決定- 特定のユースケースに適用されないかもしれないオプション機能。

よくある情報の問題

• ディファード・ディープ・リンクの無効：DDL がマーケティング戦略に関連しない可能性がある
• アンインストール追跡が設定されていない：アンインストールトラッキングが設定されていない： アンインストールトラッキングは、要件に基づくオプションです。
• オプションの SDK 機能：基本機能にとって重要でない追加機能

解決方法

1. 検証名をレビューしてオプション機能を特定する
2. ビジネス要件に関連する機能かどうかを判断する
3. 関連性がない場合、問題を無視する
4. 関連性がある場合、SDKドキュメントに従って実装する