WidgetAnalyticsInfoReportedArgs.AnalyticsJson Propiedad

Definición

Espacio de nombres:: Microsoft.Windows.Widgets.Providers

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Editar

Obtiene una cadena JSON que describe la interacción del usuario que desencadenó el evento de análisis.

public:
 property Platform::String ^ AnalyticsJson { Platform::String ^ get(); };

winrt::hstring AnalyticsJson();

public string AnalyticsJson { get; }

var string = widgetAnalyticsInfoReportedArgs.analyticsJson;

Public ReadOnly Property AnalyticsJson As String

Valor de propiedad

String

Platform::String

winrt::hstring

Cadena JSON.

Comentarios

La cadena JSON devuelta por esta propiedad usa el siguiente formato:

{
 "host": "dashboard.microsoft.com",
 "version": "1.0",
 "eventKind": "interaction",
 "interactionKind": "titleLink",
 "url": "https://www.contoso.com"
}

Los datos de telemetría se proporcionan para tres tipos de eventos, interacción del usuario, personalización de salida y eventos de visibilidad. En las secciones siguientes se proporciona información detallada sobre el formato del formato de datos de telemetría JSON para cada tipo de evento.

EventKind: interacción

Los eventos de interacción se producen cuando un usuario interactúa con un widget o su contenedor. Cuando este tipo de evento desencadena datos de telemetría, el valor de eventKind es "interacción".

TitleBar

Este evento se genera cuando un usuario ha hecho clic en la barra de título del widget, el evento se desencadena mediante un simple clic en la barra de título o arrastrando un widget a una nueva posición en la aplicación host.

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"interacción"
interactionKind	"titleBar"

Carga JSON de ejemplo para un evento TitleBar.

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "titleBar"
}

Menú de contexto

Este evento se genera cuando un usuario hace clic en una de las acciones en los puntos suspensivos "..." botón del marco de un widget.

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	interacción"
interactionKind	"contextMenu"
clickedItem	Nombre del elemento de menú en el que se ha clic, por ejemplo: "personalizar", "desanclar", "atribución", "feedback", "additionalInfo"

Carga JSON de ejemplo para un evento ContextMenu.

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "contextMenu",
    "clickedItem": "feedback"
}

Hiperenlace

Este evento se genera cuando un usuario hace clic en un hipervínculo en un widget, por ejemplo, al hacer clic en un vínculo markdown en un TextBlock. No se espera que los proveedores naveguen por el hipervínculo.

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"interacción"
interactionKind	"hipervínculo"
url	Destino del vínculo.

Carga JSON de ejemplo para un evento Hyperlink.

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "hyperlink",
    "url": "https://www.contoso.com"
}

AdditionalInfoUri

Este evento se genera cuando un usuario inicia additionalInfoUri para un widget, por ejemplo, cuando el usuario hace clic en el título del widget en el panel que da como resultado una navegación externa.

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"interacción"
interactionKind	"additionalInfoUri"
URI	Uri registrado para la navegación cuando el usuario inicia AdditionalInfoUri para un widget. Por ejemplo, al hacer clic en el título del widget en el panel.

Carga JSON de ejemplo para un evento AdditionalInfoUri.

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "additionalInfoUri",
    "uri": "https://www.contoso.com"
}


#### Action.OpenUrl

This event is raised when a user clicks on an [Action.OpenUrl](https://adaptivecards.io/explorer/Action.OpenUrl.html) action.

| Property | Value |
|----------|-------|
| host | String that identifies the host sending the error info.|
| version | Version of the JSON payload schema.|
| eventKind | "interaction"|
| interactionKind | "action.openUrl"|
| actionId | Id of the AdaptiveCard action clicked.|
| actionTitle | Title of the AdaptiveCard action clicked.|
| Url | Value set in the Action.OpenUrl url property.|

Example JSON payload for a *Action.OpenUrl* event.
```json
{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "action.openUrl",
    "actionId": "ContosoAction",
    "actionTitle": "Go to home screen",
    "url": "https://www.contoso.com"
}

Action.ToggleVisibilty

Este evento se genera cuando un usuario hace clic en una acción Action.ToggleVisibility .

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"interacción"
interactionKind	"action.toggleVisibility"
actionId	Identificador de la acción AdaptiveCard en la que se hace clic.
actionTitle	Título de la acción AdaptiveCard en la que se hace clic.
elementIds	Lista de elementos destinados a Action.ToggleVisibility tal como se define en la propiedad targetElements.

Carga JSON de ejemplo para un evento Action.ToggleVisibilty .

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "action.toggleVisibility",
    "actionId": "ToggleAction",
    "actionTitle": "Show meat options",
    "elementIds": ["ImageChicken", "ImageSteak"]
}

Note

Debido a las limitaciones de la biblioteca AdaptiveCards, es posible que el valor elementIds no contenga la información completa. Por ejemplo, los elementos de un contenedor invisible no serán visibles a menos que el contenedor lo haga.

Action.ShowCard

Este evento se genera cuando un usuario hace clic en una acción Action.ShowCard .

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"interacción"
interactionKind	"action.showCard"
actionId	Identificador de la acción AdaptiveCard en la que se hace clic.
actionTitle	Título de la acción AdaptiveCard en la que se hace clic.

Carga JSON de ejemplo para un evento Action.ShowCard .

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "action.showCard",
    "actionId": "ShowAnotherCardAction",
    "actionTitle": "See more details"
}

Carrusel

Este evento se genera cuando un usuario interactúa con un elemento carrusel, por ejemplo, al hacer clic en una página específica del carrusel o al navegar por él con las flechas izquierda y derecha.

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"interacción"
interactionKind	"carrusel"
activePageId	Id. de página de AdaptiveCards Carousel.
activePageIndex	Índice de la página activa actualmente.
carouselId	Id. del carrusel AdaptiveCards.
carouselEventName	String, uno de los siguientes: "navigationNext", "navigationPrevious", "pagination" o "autoplay"
carouselEventKind	Valor numérico asignado a uno de los nombres de evento carrusel. Los valores se asignan de la siguiente manera: navigationNext - 0, navigationPrevious - 1, paginación - 2, reproducción automática - 3

Carga JSON de ejemplo para un evento Carousel.

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "carousel",
    "activePageId": "MainPage",
    "activePageIndex": 0,
    "carouselId": "FeaturesCarousel",
    "carouselEventName": "navigationPrevious",
    "carouselEventKind": 1
}

exitCustomization

Este evento se genera cuando el usuario deja el modo de personalización, después de haber escrito el modo de personalización haciendo clic en el elemento de menú "Personalizar" del menú contextual del marco del widget. Cuando este tipo de evento desencadena datos de telemetría, el valor de interactionKind es "exitCustomization".

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"interacción"
interactionKind	"exitCustomization"

Carga JSON de ejemplo para un evento exitCustomization .

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "interaction",
    "interactionKind": "exitCustomization"
}

EventKind: visibilidad

Los eventos de visibilidad se producen cuando el widget se mueve hacia o fuera de la ventanilla visible. Los eventos de visibilidad están vinculados a la impresión física y pueden diferir de la interfaz IWidgetProvider Activate and Deactivate API que los hosts pueden desencadenar en cualquier momento. Cuando este tipo de evento desencadena datos de telemetría, el valor de eventKind es "visibilidad".

Propiedad	Value
host	Cadena que identifica el host que envía la información de error.
version	Versión del esquema de carga JSON.
eventKind	"visibilidad"
visibilityKind	"visible" o "oculto"

Carga JSON de ejemplo para un evento de visibilidad .

{
    "host": "dashboard.microsoft.com",
    "version": "1.0",
    "eventKind": "visibility",
    "visibilityKind": "visible"
}

Se aplica a

Comentarios

¿Le ha resultado útil esta página?