この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

カスタムインタラクション

登録者がどの機能や UI コンポーネントを操作し、ユーザージャーニーがどのようなフローになるかを理解するには、Apex の列挙と IsvPartners.AppAnalytics.logCustomInteraction Apex メソッドを使用してカスタムインタラクションを作成します。

使用可能なインターフェース: Salesforce Classic および Lightning Experience の両方

使用可能なエディション: Enterprise Edition、Performance Edition、Unlimited Edition、および Developer Edition

標準データ	追加データ
`class_name` `method_name` line_number `interaction_id_token`	`api_version`

成功したカスタムインタラクション

パッケージ化されたコンポーネントとのカスタムインタラクションを分析するには、CustomInteraction の log_record_type と CustomInteractionLabel の custom_entity_type を探します。custom_entity には、作成したカスタムインタラクション表示ラベルや記録されたカスタムインタラクション表示ラベルが含まれます。

interaction_id_token は、関連付けられた IsvPartners.AppAnalytics.logCustomInteraction コールに interaction_id が指定されている場合にのみ含まれます。interaction_id_token は、指定された未加工のインタラクションのハッシュおよびトークン化されたバージョンです。

メモ

失敗したカスタムインタラクション

custom_entity_type が CustomInteractionFailure の場合、カスタムインタラクションを記録できません。記録に失敗した理由を特定するには、custom_entity 値で指定される理由コードを確認します。

custom_entity	メッセージ
`LABEL_NO_NAMESPACE`	App Analytics でカスタムインタラクションを記録できませんでした。`IsvPartners.AppAnalytics.logCustomInteraction` に指定されるインタラクション表示ラベルには名前空間が含まれている必要があります。
`LABEL_NOT_ENUM`	App Analytics でカスタムインタラクションを記録できませんでした。`IsvPartners.AppAnalytics.logCustomInteraction` に指定されるインタラクション表示ラベルは Apex 列挙である必要があります。
`LABEL_WRONG_NAMESPACE`	App Analytics でカスタムインタラクションを記録できませんでした。`IsvPartners.AppAnalytics.logCustomInteraction` に指定されるインタラクション表示ラベルには、メソッドをコールした Apex コードと同じ名前空間が含まれている必要があります。
`OVER_CALL_LIMIT`	1 つのユーザー要求でコールされた `IsvPartners.AppAnalytics.logCustomInteraction` の数が多すぎます。このユーザー要求のこのカスタムインタラクションと後続のインタラクションは App Analytics で記録されませんでした。

例

では、パッケージ利用状況ログレコードの例で、成功した Apex インタラクションを分析してみましょう。

1{
2    "timestamp_derived": "2023-09-20T06:17:39.167Z",
3    "log_record_type": "CustomInteraction",
4    "request_id": "TID:7635077000004b3035",
5    "organization_id": "00Dxx0000006H2l",
6    "organization_name": "MyCustomer Inc.",
7    "organization_status": "Demo",
8    "organization_edition": "Enterprise Edition",
9    "organization_country_code": "IN",
10    "organization_language_locale": "en_US",
11    "organization_time_zone": "Australia/Sydney",
12    "organization_instance": "GS0",
13    "organization_type": "Production",
14    "user_id_token": "005-9BwnBWYO5FMn4cZ1sLw7F3LmTpoe8M77GrZOZHL6xQk=",
15    "user_type": "Standard",
16    "package_id": "033xx0000004FqD",
17    "package_version_id": "04txx0000004Idi",
18    "managed_package_namespace": "Acme",
19    "custom_entity": "MyInteractionLabels.LoginButtonClicked",
20    "custom_entity_type": "CustomInteractionLabel",
21    "session_key": "2l4YtFB/RmsRKVsS",
22    "login_key": "fGV6RgVOH3ZCgl2v",
23    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/IP_ADDRESS_REMOVED Safari/537.36",
24    "user_country_code": "US",
25    "user_time_zone": "America/Los_Angeles",
26    "class_name": "Acme.MyController",
27    "method_name": "loginButtonCallback",
28    "line_number": 56,
29    "interaction_id_token": "7NDe8HM8ZgPdBL+jiOpTW3/xKTwwL30dyxmKNxtyzi8="
30}

登録者組織 MyCustomer Inc. からのユーザーアクションの結果として、MyInteractionLabels.LoginButtonClicked カスタムインタラクション表示ラベルが 2023 年 9 月 20 日午前 6 時 17 分に記録されました。具体的には、ユーザーインタラクションによって、Acme.MyController Apex クラスにある loginButtonCallback メソッドの行番号 56 からカスタムインタラクションが記録されます。InteractionLabels.LoginButtonClicked 表示ラベルに加えて、インタラクション ID がログコールに指定され、インタラクショントークン ID の値が 7NDe8HM8ZgPdBL+jiOpTW3/xKTwwL30dyxmKNxtyzi8= になります。

この分析の主要なデータは次のとおりです。

質問	項目	値
何を	`custom_entity` `custom_entity_type` `package_version_id` `managed_package_namespace` `class_name` `method_name` `line_number` `interaction_id_token`	`MyInteractionLabels.LoginButtonClicked` `CustomInteractionLabel` `04txx0000004Idi` `Acme` `loginButtonCallback` `56` `7NDe8HM8ZgPdBL+jiOpTW3/xKTwwL30dyxmKNxtyzi8=`
誰が	`organization_id` `user_id_token`	`00Dxx0000006H2l` `005-9BwnBWYO5FMn4cZ1sLw7F3LmTpoe8M77GrZOZHL6xQk=`
どうやって	`log_record_type`	`CustomInteraction`
いつ	`timestamp_derived`	`2023-09-20T06:17:39.167Z`

第二世代管理パッケージ開発者ガイド

カスタムインタラクション

成功したカスタムインタラクション

失敗したカスタムインタラクション

例

関連項目: