Konfigurieren von Empfehlungen und verwendungsereignistypen in SharePoint Server

Artikel
03/21/2018

**Gilt für:**SharePoint Server 2013, SharePoint Server 2016

**Letztes Änderungsdatum des Themas:**2017-09-11

Verwendungsereignissen können Sie verfolgen, wie Benutzer Elemente auf Ihrer Website interagieren. Elemente können Dokumente, Websites oder Katalogelemente sein. Wenn ein Benutzer ein Element auf Ihrer Website interagiert, generiert SharePoint Server ein verwendungsereignis für diese Aktion. Wenn Sie möchten überwachen, wie oft ein Katalogelement von einem Mobiltelefon angezeigt wird, können Sie diese Aktivität nachverfolgen.

In diesem Artikel erfahren Sie, wie Sie benutzerdefinierte Verwendungsereignistypen erstellen und Code für die Erfassung benutzerdefinierter Verwendungsereignisse hinzufügen, sodass diese von der Analyseverarbeitungskomponente verarbeitet werden können.

Die durch Verwendungsereignisse generierten Daten können zum Anzeigen von Empfehlungen oder beliebten Elementen auf Ihrer Website verwendet werden. In diesem Artikel erfahren Sie auch, wie Sie die Darstellung von Empfehlungen durch Ändern der Wichtigkeitsstufe für einen bestimmten Verwendungsereignistyp beeinflussen können. Weitere Informationen finden Sie in Planen der Suche für websiteübergreifende Veröffentlichungswebsites in SharePoint Server 2016 unter "Planen der Verwendungsanalyse und von Verwendungsereignissen und Empfehlungen".

Die Statistik für alle Verwendungsereignistypen kann in Berichten zu Beliebtheitstrends und beliebtesten Elementen angezeigt werden. Weitere Informationen finden Sie unter Anzeigen von Verwendungsberichten in SharePoint Server.

Inhalt dieses Artikels:

Erstellen eines benutzerdefinierten Verwendungsereignistyps
Erfassen eines benutzerdefinierten Verwendungsereignisses
Erfassen eines standardmäßigen Verwendungsereignisses
Ändern der Wichtigkeitsstufe eines Verwendungsereignistyps
Ändern des Zeitraums vom Typ "Zuletzt verwendet" für einen Verwendungsereignistyp
Aktivieren und Deaktivieren der Protokollierung von Verwendungsereignissen anonymer Benutzer
Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website

Erstellen eines benutzerdefinierten Verwendungsereignistyps

Es gibt drei Standard-verwendungsereignistypen in SharePoint Server. Sie können bis zu zwölf benutzerdefinierte verwendungsereignistypen erstellen, mithilfe von Microsoft PowerShell.

Erstellen ein benutzerdefinierten verwendungsereignistyps

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.
Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:
```
# To get a site at the root site collection level:
$Site = Get-SPSite "https://localhost"

# To get a site below the root site collection level:
$Site = Get-SPSite "https://localhost/sites/<SiteName>"

# To create a custom usage event type:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$EventGuid = [Guid]::NewGuid()
$EventName = "<EventTypeName>"
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$newEventType = $tenantConfig.RegisterEventType($EventGuid, $EventName, "")
$tenantConfig.Update($SSP)
```
Dabei gilt Folgendes:
- <SiteName> ist der Name der Website, für die Sie ein benutzerdefiniertes Verwendungsereignis erstellen möchten.
- <EventTypeName> ist der Name des neuen benutzerdefinierten Verwendungsereignistyps, den Sie erstellen möchten (beispielsweise Kaufereignis).
Mit dieser Prozedur wird eine zufallsgenerierte GUID für den Verwendungsereignistyp erstellt. Verwenden Sie diese GUID, wenn Sie Code zum Erfassen des benutzerdefinierten Verwendungsereignisses hinzufügen (siehe Erfassen eines benutzerdefinierten Verwendungsereignisses).

Wichtig

Es kann bis zu drei Stunden dauern, bis ein benutzerdefinierter Verwendungsereignistyp im System verfügbar ist. Wenn Sie den Prozess beschleunigen möchten, führen Sie einen Neustart des SharePoint-Timerdiensts aus.

Hinweis

Es wird empfohlen, Windows PowerShell zum Ausführen von administrativen Befehlszeilenaufgaben zu verwenden. Das Befehlszeilentool Stsadm ist veraltet, aber weiterhin vorhanden, um die Kompatibilität mit früheren Produktversionen zu gewährleisten.

Erfassen eines benutzerdefinierten Verwendungsereignisses

Nach der Erstellung eines benutzerdefinierten Verwendungsereignistyps gemäß der Beschreibung unter Erstellen eines benutzerdefinierten Verwendungsereignistyps muss dort, wo das Ereignis auftritt (also beispielsweise beim Laden einer Seite oder beim Klicken auf einen Link oder auf eine Schaltfläche durch den Benutzer), Code hinzugefügt werden. Die Daten werden dann zur Erfassung und Bearbeitung an die Analyseverarbeitungskomponente gesendet.

Wenn Sie die websiteübergreifende Veröffentlichung verwenden und Kataloginhalte auf einer Veröffentlichungswebsite angezeigt werden, müssen Sie das Verwendungsereignis für die URL des indizierten Elements erfassen und einige Websiteeinstellungen überschreiben. Wenn Sie also beispielsweise über einen Katalog auf einer Erstellungswebsite verfügen, diesen auf einer Veröffentlichungswebsite veröffentlicht haben und ein Benutzer mit dem Katalogobjekt auf der Veröffentlichungswebsite interagiert, muss dieses Verwendungsereignis für das Element auf der Erstellungswebsite erfasst werden. Außerdem müssen durch den Code, den Sie zum Erfassen des Verwendungsereignisses hinzufügen, die Website-ID und die Web-ID der Veröffentlichungswebsite durch die Website-ID und die Web-ID der Erstellungswebsite ersetzt werden.

So fügen Sie Code zum Erfassen eines benutzerdefinierten verwendungsereignisses hinzu

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

Öffnen Sie die Datei, in der das benutzerdefinierte Verwendungsereignis protokolliert werden soll (beispielsweise eine Anzeigevorlage für ein Inhaltssuche-Webpart), in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:

window.Log<CustomUsageEventType>ToEventStore = function(url)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
        var spClientContext = SP.ClientContext.get_current();
        var eventGuid = new SP.Guid("<GUID>");
        SP.Analytics.AnalyticsUsageEntry.logAnalyticsAppEvent(spClientContext, eventGuid, url);
        spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

<CustomUsageEventType> ist der Name des benutzerdefinierten Ereignisses (beispielsweise Kaufereignis).
<GUID> ist die numerische ID des Verwendungsereignistyps (beispielsweise 4e605543-63cf-4b5f-aab6-99a10b8fb257).

Öffnen Sie die Datei, in der auf das benutzerdefinierte Verwendungsereignis verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
```
# The example below shows how a custom usage event type is referred to when a button is clicked: 
<button onclick="Log<CustomUsageEventType>ToEventStore('<URL>')"></button>
```
Dabei gilt Folgendes:
- <CustomUsageEventType> ist der Name des benutzerdefinierten Ereignistyps.
- <URL> ist die vollständige URL des Elements, in dem das Verwendungsereignis protokolliert werden soll (beispielsweise https://contoso.com/faq).

Zum Hinzufügen von Code zum Erfassen eines benutzerdefinierten verwendungsereignisses und websiteeinstellungen zu überschreiben

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view GUIDs for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

window.Log<CustomUsageEventType>ToEventStore = function(url, siteIdGuid, webIdGuid, spUser)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
      var spClientContext = SP.ClientContext.get_current();
      var eventGuid = new SP.Guid("<GUID>");
SP.Analytics.AnalyticsUsageEntry.logAnalyticsAppEvent2(spClientContext, eventGuid, url, webIdGuid, siteIdGuid, spUser);
      spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

Dabei gilt Folgendes:

<CustomUsageEventType> ist der Name des benutzerdefinierten Ereignistyps (beispielsweise Kaufereignis).
<GUID> ist die numerische ID des Verwendungsereignistyps (beispielsweise 4e605543-63cf-4b5f-aab6-99a10b8fb257).

Öffnen Sie die Datei, in der auf den benutzerdefinierten Verwendungsereignistyp verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
```
# The example below shows how a custom usage event type is referred to when the \"Buy!\" button is clicked:
<button onclick="Log<CustomUsageEventType>ToEventStore('<URL>', new SP.Guid('{<SiteId GUID>}'), new SP.Guid('{<WebId GUID>}'), '<UserName>')">Buy!</button>
```
Dabei gilt Folgendes:
- <CustomUsageEventType> ist der Name des benutzerdefinierten Ereignistyps (beispielsweise "Kaufereignis").
- <URL> ist die URL aus der verwalteten Eigenschaft "OriginalPath".
- <SiteId GUID> ist die Website-ID-GUID der Erstellungswebsite. Informationen zum Abrufen der Website-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.
- <WebId GUID> ist die Web-ID-GUID der Erstellungswebsite. Informationen zum Abrufen der Web-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.
- <UserName> kann eine Cookie-ID sein, mit deren Hilfe Benutzer auf einer Website mit anonymen Benutzern identifiziert werden.

Erfassen eines standardmäßigen Verwendungsereignisses

Wenn Sie Code hinzufügen möchten, durch den auf einen standardmäßigen Verwendungsereignistyp (beispielsweise Ansichten) verwiesen wird, muss der Code dort hinzugefügt werden, wo das Ereignis auftritt.

Wenn Sie die websiteübergreifende Veröffentlichung verwenden, um Kataloginhalte auf einer Veröffentlichungswebsite anzuzeigen, müssen Sie das Verwendungsereignis für die URL des indizierten Elements erfassen und einige Websiteeinstellungen überschreiben. Wenn Sie also beispielsweise über einen Katalog auf einer Erstellungswebsite verfügen, diesen auf einer Veröffentlichungswebsite veröffentlicht haben und ein Benutzer mit dem Katalogobjekt auf der Veröffentlichungswebsite interagiert, muss dieses Verwendungsereignis für das Element auf der Erstellungswebsite erfasst werden. Außerdem müssen durch den Code, den Sie zum Erfassen des Verwendungsereignisses hinzufügen, die Website-ID und die Web-ID der Veröffentlichungswebsite durch die Website-ID und die Web-ID der Erstellungswebsite ersetzt werden.

So fügen Sie Code zum Erfassen eines standardmäßigen verwendungsereignisses hinzu

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

window.Log<DefaultUsageEventType>ToEventStore = function(url)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
        var spClientContext = SP.ClientContext.get_current();
        SP.Analytics.AnalyticsUsageEntry.logAnalyticsEvent(spClientContext, <EventTypeId>, url);
        spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

Dabei gilt Folgendes:

<DefaultUsageEventType> ist der Name des standardmäßigen Verwendungsereignistyps (beispielsweise Ansichten).
<EventTypeId> ist die numerische ID des Verwendungsereignistyps (beispielsweise 1).

Öffnen Sie die Datei, in der auf das standardmäßige Verwendungsereignis verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
```
# The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>')"> 
```
Dabei gilt Folgendes:
- <DefaultUsageEventType> ist der Name des standardmäßigen Verwendungsereignistyps (beispielsweise Ansichten).
- <URL> ist die vollständige URL des Elements, in dem das Verwendungsereignis protokolliert werden soll (beispielsweise https://contoso.com/careers).
Speichern Sie die Datei.

Zum Hinzufügen von Code zum Erfassen eines standardmäßigen verwendungsereignisses und websiteeinstellungen zu überschreiben

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

window.Log<DefaultUsageEventType>ToEventStore = function(url, siteIdGuid, webIdGuid, spUser)
{
    ExecuteOrDelayUntilScriptLoaded(function()
    {
      var spClientContext = SP.ClientContext.get_current();
      SP.Analytics.AnalyticsUsageEntry.logAnalyticsEvent(spClientContext, <EventTypeId>, url, webIdGuid, siteIdGuid, spUser);
spClientContext.executeQueryAsync(null, Function.createDelegate(this, function(sender, e){ alert("Failed to log event for item: " + document.URL + " due to: " + e.get_message()) }));
    }, "SP.js");
}

Dabei gilt Folgendes:

<DefaultUsageEventType> ist der Name des standardmäßigen Ereignistyps (beispielsweise Ansichten).
<EventTypeId> ist die numerische ID des Verwendungsereignistyps (beispielsweise 1).

Öffnen Sie die Datei, in der auf den standardmäßigen Verwendungsereignistyp verwiesen wird, in einem HTML-Editor, und fügen Sie den folgenden Code hinzu:
```
# The example below shows how a default usage event type is referred to on a page load:
<body onload="Log<DefaultUsageEventType>ToEventStore('<URL>', new SP.Guid('{<SiteId GUID>}'), new SP.Guid('{<WebId GUID>}'), '<UserName>')">
```
Dabei gilt Folgendes:
- <DefaultUsageEventType> ist der Name des standardmäßigen Ereignistyps (beispielsweise Ansichten).
- <URL> ist die URL aus der verwalteten Eigenschaft OriginalPath.
- <SiteId GUID> ist die Website-ID-GUID der Erstellungswebsite. Informationen zum Abrufen der Website-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.
- <WebId GUID> ist die Web-ID-GUID der Erstellungswebsite. Informationen zum Abrufen der Web-ID-GUID finden Sie unter Abrufen der Website-ID-GUID und der Web-ID-GUID für eine Website.
- <UserName> kann beispielsweise eine Cookie-ID sein, mit deren Hilfe Benutzer auf einer Website mit anonymen Benutzern identifiziert werden.

Hinweis

Ändern der Wichtigkeitsstufe eines Verwendungsereignistyps

Die Verwendungsereignistyp-Eigenschaft RecommendationWeight ist ein numerischer Wert, der die Wichtigkeit eines Verwendungsereignistyps relativ zu anderen Verwendungsereignistypen angibt, die im Rahmen der Empfehlungsberechnung verwendet werden. Für den standardmäßigen Verwendungsereignistyp Ansichten ist der Wert für RecommendationWeight auf "1" festgelegt. Bei den anderen standardmäßigen Verwendungsereignistypen (Angezeigte Empfehlungen und Angeklickte Empfehlungen) sowie bei allen benutzerdefinierten Verwendungsereignistypen ist der Wert für RecommendationWeight auf "0" festgelegt. Wenn Sie die Wichtigkeit eines Verwendungsereignistyps in der Empfehlungsberechnung erhöhen möchten, ändern Sie den Wert des Parameters RecommendationWeight. Die höchstmögliche Wichtigkeitsstufe ist 10.

So ändern Sie die Ebene der Wichtigkeit einer verwendungsereignistyps

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To change the importance level of a usage event type:
$event.RecommendationWeight = <RecommendationWeightNumber>
$tenantConfig.Update($SSP)

# To verify the changed importance level for the usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

Dabei gilt Folgendes:

<EventTypeId> ist die numerische ID des Verwendungsereignistyps, dessen Gewichtung Sie ändern möchten (beispielsweise 256).
<RecommendationWeightNumber> ist die Wichtigkeitsstufe, die Sie für den Verwendungsereignistyp festlegen möchten (beispielsweise 4).

Hinweis

Ändern des Zeitraums vom Typ "Zuletzt verwendet" für einen Verwendungsereignistyp

Die Verwendungsereignistyp-Eigenschaft RecentPopularityTimeframe ist ein numerischer Wert zum Definieren des Zeitraums vom Typ Zuletzt verwendet im Bericht Beliebteste Elemente. Der Bericht mit den beliebtesten Elementen enthält die beliebtesten Elemente pro Verwendungsereignistyp für alle Elemente in einer Bibliothek oder Liste (beispielsweise die am häufigsten angezeigten Elemente einer Bibliothek oder Liste). Der Bericht kann nach den Zeiträumen Zuletzt verwendet oder Jemals sortiert werden. Der Zeitraum für zuletzt verwendete Elemente ist für die einzelnen Verwendungsereignisse standardmäßig auf die letzten 14 Tage festgelegt. Dieser Zeitraum kann auf einen Wert zwischen einem und 14 Tagen festgelegt werden.

So ändern Sie den letzten Zeitraum für einen verwendungsereignistyp

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To change the Recent time span for a usage event type:
$event.RecentPopularityTimeFrame = <TimeFrame>
$tenantConfig.Update($SSP)

# To verify the changed Recent time frame for the usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

Dabei gilt Folgendes:

<EventTypeId> ist die numerische ID des Verwendungsereignistyps, dessen Zeitraum vom Typ Zuletzt verwendet Sie ändern möchten (beispielsweise 256).
<TimeFrame> ist der neue Zeitraum vom Typ Kürzlich verwendet, der für den Benutzerereignistyp gelten soll (beispielsweise 7).

Hinweis

Die Änderungen am Zeitraum vom Typ "Zuletzt verwendet" werden erst nach Ausführung des Zeitgeberauftrags "Verwendungsanalyse" aktualisiert.

Hinweis

Aktivieren und Deaktivieren der Protokollierung von Verwendungsereignissen anonymer Benutzer

Benutzer, die Inhalte auf einer Website betrachten, ohne mit einem Konto verbunden zu sein, werden als anonyme Benutzer bezeichnet. Für die Protokollierung anonymer Benutzer ist ausschließlich der Ereignistyp Ansichten aktiviert. Die Protokollierung benutzerdefinierter Verwendungsereignisse ist für anonyme Benutzer standardmäßig deaktiviert.

So aktivieren Sie die Protokollierung von verwendungsereignissen anonymer Benutzer

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To enable the logging of anonymous users:
$event.Options = [Microsoft.Office.Server.Search.Analytics.EventOptions]::AllowAnonymousWrite
$tenantConfig.Update($SSP)

# To verify that the logging of anonymous users has been enabled, i.e. that the Options property is set to AllowAnonymousWrite:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event

Dabei gilt Folgendes:

<EventTypeId> ist die numerische ID des Verwendungsereignistyps, den Sie für die Protokollierung anonymer Benutzer aktivieren möchten (beispielsweise 256).

So deaktivieren Sie die Protokollierung von verwendungsereignissen anonymer Benutzer

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.

Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

# To view EventTypeId for all usage event types:
$SSP = Get-SPEnterpriseSearchServiceApplicationProxy
$SSP.GetAnalyticsEventTypeDefinitions([Guid]::Empty, 3) | ft

# To get a usage event type:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }

# To disable the logging of anonymous users:
$event.Options = [Microsoft.Office.Server.Search.Analytics.EventOptions]::None
$tenantConfig.Update($SSP)

# To verify that logging of anonymous users has been disabled, i.e. that the Options property is set to None:
$tenantConfig = $SSP.GetAnalyticsTenantConfiguration([Guid]::Empty)

Dabei gilt Folgendes:

<EventTypeId> ist die numerische ID des Verwendungsereignistyps, den Sie für die Protokollierung anonymer Benutzer deaktivieren möchten (beispielsweise 256).

Hinweis

Für den standardmäßigen Verwendungsereignistyp Ansichten kann die Protokollierung anonymer Benutzer nicht deaktiviert werden.

Hinweis

Abrufen von SiteId-GUID und der WebId-GUID für eine Website

Mit den folgenden PowerShell-Befehlen können Sie die Website-ID-GUID und die Web-ID-GUID für eine Website abrufen.

Beim Abrufen von SiteId-GUID und der WebId-GUID für eine Website

Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
- Feste Serverrolle securityadmin auf der SQL Server-Instanz.
- Die feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden.
- Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.
- Fügen Sie Mitgliedschaften hinzu, falls zusätzlich zu den obigen Mindestanforderungen noch weitere Mitgliedschaften erforderlich sind.
Ein Administrator kann mithilfe des Add-SPShellAdmin-Cmdlets Berechtigungen zur Verwendung des SharePoint Server-Cmdlets gewähren.

Hinweis

Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.
Starten Sie SharePoint 15-Verwaltungsshell.
Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:
```
# To get the SiteId GUID and the WebId GUID for a root site collection:
$site = Get-SPSite "<RootSiteURL>"
$web = $site.RootWeb
$site.id
$web.id

# To get the WebId GUID for a site below the root site collection:
$site = Get-SPSite "<RootSiteURL>"
$web = $site.OpenWeb("<SubSiteLocation>")
$web.id
```
Dabei gilt Folgendes:
- <RootSiteURL> ist die URL der Stammwebsite, deren Website-ID-GUID und Web-ID-GUID Sie ermitteln möchten. Beispiel: https://contoso.com/sites/catalog.
- <SubSiteLocation> ist der restliche URL-Pfad der Unterwebsite nach der Stammwebsite-URL. Lautet die Stammwebsite-URL beispielsweise https://contoso.com/sites/catalog und die Unterwebsite-URL https://contoso.com/sites/catalog/products, geben Sie products für diesen Platzhalter ein.

Hinweis

Konfigurieren von Empfehlungen und verwendungsereignistypen in SharePoint Server

Erstellen eines benutzerdefinierten Verwendungsereignistyps

Erfassen eines benutzerdefinierten Verwendungsereignisses

Erfassen eines standardmäßigen Verwendungsereignisses

Ändern der Wichtigkeitsstufe eines Verwendungsereignistyps

Ändern des Zeitraums vom Typ "Zuletzt verwendet" für einen Verwendungsereignistyp

Aktivieren und Deaktivieren der Protokollierung von Verwendungsereignissen anonymer Benutzer

Abrufen von SiteId-GUID und der WebId-GUID für eine Website

See also

Zusätzliche Ressourcen