WidgetAnalyticsInfoReportedArgs.AnalyticsJson Eigenschaft

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

Eigenschaftswert

Eine JSON-Zeichenfolge.

Hinweise

Die von dieser Eigenschaft zurückgegebene JSON-Zeichenfolge verwendet das folgende Format:

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

Telemetriedaten werden für drei Arten von Ereignissen, Benutzerinteraktionen, Beendigungsanpassungen und Sichtbarkeitsereignissen bereitgestellt. Die folgenden Abschnitte enthalten detaillierte Informationen zum Format des JSON-Telemetriedatenformats für jeden Ereignistyp.

EventKind – Interaktion

Die Interaktionsereignisse treten auf, wenn ein Benutzer mit einem Widget oder seinem Container interagiert. Wenn Telemetriedaten von diesem Ereignistyp ausgelöst werden, lautet der Wert von eventKind "interaction".

Titelleiste

Dieses Ereignis wird ausgelöst, wenn ein Benutzer auf die Titelleiste des Widgets geklickt hat, wird das Ereignis durch einen einfachen Klick auf die Titelleiste ausgelöst oder durch Ziehen eines Widgets an eine neue Position in der Host-App.

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Interaktion"
interactionKind	"titleBar"

Beispiel-JSON-Nutzlast für ein TitleBar-Ereignis.

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

Kontextmenü

Dieses Ereignis wird ausgelöst, wenn ein Benutzer auf eine der Aktionen unter den Auslassungspunkten "..." klickt. schaltfläche des Rahmens eines Widgets.

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	Interaktion"
interactionKind	"contextMenu"
clickedItem	Name des menüelements geklickt, z. B.: "customize", "unpin", "attribution", "feedback", "additionalInfo"

Beispiel-JSON-Nutzlast für ein ContextMenu-Ereignis.

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

Verknüpfung

Dieses Ereignis wird ausgelöst, wenn ein Benutzer auf einen Link in einem Widget klickt, z. B. beim Klicken auf einen Markdownlink in einem TextBlock. Die URL-Navigation wird vom Widget-Host behandelt, Anbieter werden nicht erwartet, dass der Link navigiert wird.

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Interaktion"
interactionKind	„Link“
url	Linkziel.

Beispiel-JSON-Nutzlast für ein Hyperlink-Ereignis.

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

AdditionalInfoUri

Dieses Ereignis wird ausgelöst, wenn ein Benutzer den AdditionalInfoUri für ein Widget startet, z. B. wenn der Benutzer im Dashboard auf den Widgettitel klickt, der zur externen Navigation führt.

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Interaktion"
interactionKind	"additionalInfoUri"
Uri	URI, der für die Navigation registriert ist, wenn der Benutzer den AdditionalInfoUri für ein Widget startet. Wenn Sie beispielsweise im Dashboard auf den Titel des Widgets klicken.

Beispiel-JSON-Nutzlast für ein AdditionalInfoUri-Ereignis.

{
    "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

Dieses Ereignis wird ausgelöst, wenn ein Benutzer auf eine Action.ToggleVisibility-Aktion klickt.

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Interaktion"
interactionKind	"action.toggleVisibility"
actionId	Die ID der adaptiveCard-Aktion, auf die geklickt wurde.
actionTitle	Titel der AdaptiveCard-Aktion geklickt.
elementIds	Liste der Elemente, die von "Action.ToggleVisibility" bestimmt sind, wie in der targetElements-Eigenschaft definiert.

Beispiel-JSON-Nutzlast für ein Action.ToggleVisibilty-Ereignis .

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

Action.ShowCard

Dieses Ereignis wird ausgelöst, wenn ein Benutzer auf eine Action.ShowCard-Aktion klickt.

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Interaktion"
interactionKind	"action.showCard"
actionId	Die ID der adaptiveCard-Aktion, auf die geklickt wurde.
actionTitle	Titel der AdaptiveCard-Aktion geklickt.

Beispiel-JSON-Nutzlast für ein Action.ShowCard-Ereignis .

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

Karussell

Dieses Ereignis wird ausgelöst, wenn ein Benutzer mit einem Karussellelement interagiert, z. B. beim Klicken auf eine bestimmte Seite im Karussell oder beim Navigieren mit den Pfeilen nach links und rechts.

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Interaktion"
interactionKind	"Karussell"
activePageId	AdaptiveCards Karussell-Seiten-ID.
activePageIndex	Index der aktuell aktiven Seite.
KarussellId	ID des AdaptiveCards Karussells.
KarussellEventName	Zeichenfolge, eine der folgenden: "navigationNext", "navigationPrevious", "pagination" oder "autoplay"
KarussellEventKind	Numerischer Wert, der einem der Karussellereignisnamen zugeordnet ist. Die Wertezuordnung wie folgt: navigationNext - 0, navigationPrevious - 1, Paginierung - 2, automatische Wiedergabe - 3

Beispiel-JSON-Nutzlast für ein Karussellereignis.

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

exitCustomization

Dieses Ereignis wird ausgelöst, wenn der Benutzer den Anpassungsmodus verlässt, nachdem er den Anpassungsmodus eingegeben hat, indem er im Kontextmenü des Widgetframes auf das Menüelement "Anpassen" klickt. Wenn Telemetriedaten von diesem Ereignistyp ausgelöst werden, lautet der Wert von interactionKind "exitCustomization".

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Interaktion"
interactionKind	"exitCustomization"

Beispiel-JSON-Nutzlast für ein exitCustomization-Ereignis .

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

EventKind - Sichtbarkeit

Die Sichtbarkeitsereignisse treten auf, wenn das Widget in den sichtbaren Viewport verschoben oder aus dem sichtbaren Viewport verschoben wird. Sichtbarkeitsereignisse sind an den physischen Eindruck gebunden und können sich von der IWidgetProvider-Schnittstelle"Activate" und "Deactivate "-APIs unterscheiden, die Hosts jederzeit auslösen können. Wenn Telemetriedaten von diesem Ereignistyp ausgelöst werden, ist der Wert von eventKind "visibility".

Eigentum	Wert
host	Zeichenfolge, die den Host identifiziert, der die Fehlerinformationen sendet.
version	Version des JSON-Nutzlastschemas.
eventKind	"Sichtbarkeit"
visibilityKind	"sichtbar" oder "ausgeblendet"

Beispiel-JSON-Nutzlast für ein Sichtbarkeitsereignis .

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