WidgetAnalyticsInfoReportedArgs.AnalyticsJson Propriedade

Definição

Namespace:: Microsoft.Windows.Widgets.Providers

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Editar

Obtém uma cadeia de caracteres JSON que descreve a interação do usuário que disparou o evento de análise.

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 da propriedade

String

Platform::String

winrt::hstring

Uma cadeia de caracteres JSON.

Comentários

A cadeia de caracteres JSON retornada por essa propriedade usa o seguinte formato:

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

Os dados de telemetria são fornecidos para três tipos de eventos, interação do usuário, personalização de saída e eventos de visibilidade. As seções a seguir fornecem informações detalhadas sobre o formato do formato de dados de telemetria JSON para cada tipo de evento.

EventKind – Interação

Os eventos de interação ocorrem quando um usuário interage com um widget ou seu contêiner. Quando os dados de telemetria são disparados por esse tipo de evento, o valor de eventKind é "interação".

Barra de Título

Esse evento é gerado quando um usuário clica na barra de título do widget, o evento é disparado por um simples clique na barra de título ou arrastando um widget para uma nova posição no aplicativo host.

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"interação"
interactionKind	"titleBar"

Conteúdo JSON de exemplo para um evento TitleBar.

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

Menu de Contexto

Esse evento é gerado quando um usuário clica em uma das ações sob as reticências "..." botão do quadro de um widget.

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	interação"
interactionKind	"contextMenu"
clickedItem	Nome do item de menu clicado, por exemplo: "personalizar", "desafixar", "atribuição", "feedback", "additionalInfo"

Conteúdo JSON de exemplo para um evento ContextMenu.

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

Hiperlink

Esse evento é gerado quando um usuário clica em um hiperlink em um Widget, por exemplo, ao clicar em um link markdown em um TextBlock. A navegação de URL é tratada pelo Host do Widget, os provedores não devem navegar no hiperlink.

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"interação"
interactionKind	hiperlink
url	Destino do link.

Conteúdo JSON de exemplo para um evento de Hiperlink.

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

AdditionalInfoUri

Esse evento é gerado quando um usuário inicia o AdditionalInfoUri para um Widget, por exemplo, quando o usuário clica no título do widget no Painel que resulta em navegação externa.

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"interação"
interactionKind	"additionalInfoUri"
Uri	Uri registrado para navegação quando o usuário inicia o AdditionalInfoUri para um Widget. Por exemplo, ao clicar no título do Widget no Painel.

Conteúdo JSON de exemplo para um 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

Esse evento é gerado quando um usuário clica em uma ação Action.ToggleVisibility .

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"interação"
interactionKind	"action.toggleVisibility"
actionId	Id da ação AdaptiveCard clicada.
actionTitle	Título da ação AdaptiveCard clicado.
elementIds	Lista de elementos direcionados por Action.ToggleVisibility conforme definido na propriedade targetElements.

Conteúdo JSON de exemplo para um 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

Devido a limitações na biblioteca AdaptiveCards, o valor elementIds pode não conter as informações completas. Por exemplo, os elementos em um contêiner invisível não ficarão visíveis, a menos que o contêiner o faça.

Action.ShowCard

Esse evento é gerado quando um usuário clica em uma ação Action.ShowCard .

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"interação"
interactionKind	"action.showCard"
actionId	Id da ação AdaptiveCard clicada.
actionTitle	Título da ação AdaptiveCard clicado.

Conteúdo JSON de exemplo para um evento Action.ShowCard .

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

Carrossel

Esse evento é gerado quando um usuário interage com um elemento de carrossel, por exemplo, ao clicar em uma página específica no carrossel ou ao navegar com as setas para a esquerda e para a direita.

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"interação"
interactionKind	"carrossel"
activePageId	ID da página carrossel AdaptiveCards.
activePageIndex	Índice da página ativa no momento.
carouselId	ID do Carrossel AdaptiveCards.
carouselEventName	Cadeia de caracteres, uma das seguintes: "navigationNext", "navigationPrevious", "paginação" ou "reprodução automática"
carouselEventKind	Valor numérico mapeado para um dos nomes de evento de carrossel. Os valores são mapeados da seguinte maneira: navigationNext - 0, navigationPrevious - 1, paginação - 2, reprodução automática - 3

Conteúdo JSON de exemplo para um evento carrossel.

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

exitCustomization

Esse evento é gerado quando o usuário sai do modo de personalização, depois de ter entrado no modo de personalização clicando no item de menu "Personalizar" no menu de contexto do quadro do widget. Quando os dados de telemetria são disparados por esse tipo de evento, o valor de interactionKind é "exitCustomization".

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"interação"
interactionKind	"exitCustomization"

Conteúdo JSON de exemplo para um evento exitCustomization .

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

EventKind – Visibilidade

Os eventos de visibilidade ocorrem quando o widget é movido para dentro ou para fora do visor visível. Os eventos de visibilidade estão vinculados à impressão física e podem diferir da interface IWidgetProvider Ativar e desativar APIs que os Hosts podem disparar a qualquer momento. Quando os dados de telemetria são disparados por esse tipo de evento, o valor de eventKind é "visibilidade".

Propriedade	Valor
hospedar	Cadeia de caracteres que identifica o host que envia as informações de erro.
versão	Versão do esquema de conteúdo JSON.
Eventkind	"visibilidade"
visibilityKind	"visível" ou "oculto"

Conteúdo JSON de exemplo para um evento de visibilidade .

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

Aplica-se a

Comentários

Esta página foi útil?