title: analytics/mediawiki/structured_task/article/link_suggestion_interaction description: Analytics events for interactions with link suggestion structured task $id: /analytics/mediawiki/structured_task/article/link_suggestion_interaction/1.8.1 $schema: https://json-schema.org/draft-07/schema# type: object allOf: - $ref: /fragment/analytics/structured_task_article/1.0.0# - required: - active_interface - action - action_data properties: active_interface: type: string description: Name of the currently open interface enum: - onboarding_step_1_dialog - onboarding_step_2_dialog - onboarding_step_3_dialog - nosuggestions_dialog - rejection_dialog - skipall_dialog - editsummary_dialog - recommendedlinktoolbar_dialog - machinesuggestions_mode - editmode_confirmation_dialog - outdatedsuggestions_dialog - qualitygate_dialog - abandonedit_dialog - readmode_article_page - readmode_suggestion_dialog action: type: string description: >- Action the user took link_click: - The user clicked on the "Learn more" link in onboarding_step_1_dialog - The user clicked on the link target in the recommendedlinktoolbar_dialog enum: - impression # Used to indicate that an interface is seen. Used with all active_interface items. - skip_all # Button for skipping all screens in onboarding_step_{1/2}_dialog - get_started # Final button on the onboarding_step_3_dialog - back # Used in onboarding_step_{2/3}_dialog and in recommendedlinktoolbar_dialog - next # Used in onboarding_step_{1/2}_dialog and in recommendedlinktoolbar_dialog - link_click # Used in onboarding_step_2_dialog and in recommendedlinktoolbar_dialog - close # Used with rejection_dialog, editsummary_dialog and onboarding_step_{1/2/3}_dialog - confirm_skip_all_suggestions # Used with skipall_dialog - review_again # Used with skipall_dialog - suggestion_focus # A suggestion has the focus of the recommendedlinktoolbar_dialog, either by tap/click, via auto-advance, or through back/next. - view_help # Only appears for mobile recommendedlinktoolbar_dialog interface. Used with recommendedlinktoolbar_dialog - suggestion_view_rejection_reasons # The user tapped/click the ellipses "View rejection reasons" button to get to the rejection dialog - suggestion_accept # The user accepted a suggestion - suggestion_reject # The user rejected a suggestion - suggestion_skip # The user skipped a suggestion - suggestion_mark_undecided # The user toggled "Yes" or "No" to undecided - editsummary_review # The user pressed the "Review changes" button in the editsummary_dialog - editsummary_approve # The user pressed the back button in the "Review changes" button in the editsummary_dialog - editsummary_report # The user pressed the "report" button in review panel of the editsummary_dialog - editsummary_save # The user pressed the save button in the editsummary_dialog - editmode_click # The user opened the edit mode dropdown - editmode_select # The user selected an editing mode - editmode_confirm_switch # The user clicked on confirm button in editmode_confirmation_dialog - editmode_cancel_switch # The user clicked on cancel button in editmode_confirmation_dialog - reopen_dialog_click # The user clicked on the robot button (for re-opening recommendedlinktoolbar_dialog) - expand # Used with recommendedlinktoolbar_dialog - collapse # Used with recommendedlinktoolbar_dialog - keep # The user pressed "Continue editing" button in the abandonedit_dialog - discard # The user pressed "Discard edits" in the abandonedit_dialog - viewport_impression # A link suggestion highlight was displayed in the user's viewport in the readmode_article_page - suggestion_accept_yes # The user pressed "Yes" in the readmode_suggestion_dialog action_data: type: string description: >- Additional data for certain actions For action=skip_all: - dont_show_again is true or false For action=get_started: - dont_show_again is true or false For action=next in onboarding_step_{1/2/3}_dialog: - dont_show_again is true or false For action=back in onboarding_step_{1/2/3}_dialog: - dont_show_again is true or false For action=link_click in the onboarding_step_1_dialog: - dont_show_again checkbox is true or false For action=impression on machinesuggestions_mode: - number_phrases_found An integer value for the number of phrases found in the VisualEditor document - number_phrases_expected An integer value for the number of phrases expected to be found in the VisualEditor document - number_phrases_shown An integer value for the number of phrases shown to the user after applying the limit set by maximumLinksToShowPerTask configuration value from MediaWiki:NewcomerTasks.json For action=close on rejection_dialog: - rejection_reason A list of strings for the IDs of the reasons for rejecting the recommendation. Can be empty string if the user pressed escape without selecting a reason. For action=impression on editsummary_dialog: - accepted_count - rejected_count - skipped_count For actions suggestion_focus, suggestion_accept, suggestion_reject, suggestion_skip, suggestion_view_rejection_reasons, link_click, view_help on recommendedlinktoolbar_dialog: - link_target The link target highlighted by the inspector - link_text The anchor text for the link suggestion - probability_score The probability score for the link suggestion - series_number Which suggestion in the series the user is on - rejection_reason The rejection reason, if any - acceptance_state The acceptance state of the suggestion. One of "accepted", "rejected" or "undecided" For actions suggestion_accept, suggestion_reject, suggestion_mark_undecided, the above data, plus: - previous_acceptance_state The previous acceptance state of the suggestion. One of "accepted", "rejected" or "undecided" For action=suggestion_focus on recommendedlinktoolbar_dialog, the above data, plus: - manual_focus true if the user tapped/clicked on the link, false if the user used back/next button or if the suggestion was auto-advanced For actions editmode_select and editmode_confirm_switch: - selected_mode is one of "visual", "machinesuggestions" or "source" For actions back, next on recommendedlinktoolbar_dialog and onboarding_step_{1/2/3}_dialog: - navigation_type is swipe or click For action=impression on qualitygate_dialog: - dailyLimit examples: - $schema: $ref: '#/$id' meta: stream: mediawiki.structured_task.article.link_suggestion_interaction domain: es.wikipedia.org dt: '2020-12-12T00:20:00.649Z' dt: '2020-12-12T00:20:00.649Z' active_interface: onboarding_step_1_dialog action: skip_all action_data: dont_show_again=true newcomer_task_token: example homepage_pageview_token: example is_mobile: false page_id: 0 page_title: example