Auf dieser Seite werden Nutzerereignisse für Apps zur Mediensuche und -empfehlung beschrieben, einschließlich Nutzerereignistypen, Anforderungen und Beispielen für Nutzerereignistypen. Für Medien-Apps sind Nutzerereignisse erforderlich.
Allgemeine Informationen zur Mediensuche und zu Empfehlungen finden Sie unter Einführung in die Mediensuche und Empfehlungen.
Informationen zum Aufzeichnen von Nutzerereignissen finden Sie unter Nutzerereignisse in Echtzeit aufzeichnen. Informationen zum Bulk-Importieren früherer Nutzerereignisse finden Sie unter Verlaufsnutzerereignisse importieren.
Nutzerereignistypen
Sie können die folgenden Arten von Nutzerereignissen aufzeichnen, wenn Endnutzer Ihre Website besuchen:
Name des Nutzerereignisses | Nutzeraktion |
---|---|
view-category-page |
Eine Kategorieseite wird aufgerufen, z. B. „Startseite“ > „Serien“ > „Dramen“ oder „Startseite“ > „Filme“ > „Action“. |
view-item |
Ruft Details zu einem Dokument auf. |
view-home-page |
Ruft die Startseite auf. |
search |
Durchsucht den Datenspeicher. |
media-play |
Klicks auf ein Medienelement. |
media-complete |
Die Wiedergabe eines Medienelements wird beendet. |
Weitere Informationen zum Nutzerereignisobjekt finden Sie in der UserEvent
API-Referenzdokumentation.
Ereignisanforderungen für die Mediensuche und -empfehlungen
Welche Nutzerereignisse Sie erfassen müssen, sehen Sie in der folgenden Tabelle.
Welche Arten von Nutzerereignissen Sie benötigen, hängt davon ab, ob es sich bei Ihrer App um eine Such- oder eine Empfehlungs-App handelt, um das Zielvorhaben (Klickrate, Conversion-Rate oder Wiedergabedauer) und, nur bei Empfehlungs-Apps, um den von Ihnen ausgewählten Modelltyp. Weitere Informationen zu Empfehlungsmodelltypen und Optimierungszielen finden Sie unter Empfehlungstypen für Media-Apps.
Ereignis | search |
view-home-page |
view-category-page |
view-item |
media-play |
media-complete |
|
---|---|---|---|---|---|---|---|
Suchanwendungsfall | |||||||
Erforderlich | Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | ||
Modelltyp „Empfehlungen für dich“ nach Ziel | |||||||
CTR | Nicht erforderlich |
Erforderlich für den Kontext der Startseite Nicht erforderlich für den allgemeinen Kontext |
Nicht erforderlich |
Erforderlich | Erforderlich | Dringend empfohlen Erforderlich, wenn die Deaktivierung des Verlaufs aktiviert ist |
|
CVR | Nicht erforderlich |
Erforderlich für den Kontext der Startseite Nicht erforderlich für den allgemeinen Kontext |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | |
Wiedergabedauer | Nicht erforderlich |
Erforderlich für den Kontext der Startseite Nicht erforderlich für den allgemeinen Kontext |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | |
Modelltyp „Was Ihnen sonst noch gefallen könnte“ nach Ziel | |||||||
CTR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Wird dringend empfohlen Erforderlich, wenn die Deaktivierung des Verlaufs aktiviert ist |
|
CVR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | |
Wiedergabedauer | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | |
Modelltyp „Ähnliche Inhalte“ nach Zielvorhaben | |||||||
CTR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich, wenn die Deaktivierung von Suchanfragen im Verlauf aktiviert ist | |
CVR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | |
Wiedergabedauer | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | |
Beliebtester Modelltyp nach Zielvorhaben | |||||||
CTR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Nicht erforderlich |
|
CVR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich |
Anforderungen an Mediennutzerereignisse
Achten Sie darauf, dass Ihre Nutzerereignisse die folgenden Anforderungen erfüllen, damit Ihre Medien-Apps Qualitätsergebnisse generieren können.
Ereignistyp | Anforderung | Auswirkungen |
---|---|---|
Alle Termine |
Synthetische Daten oder doppelte Ereignisse dürfen nicht enthalten sein. |
Synthetische oder doppelte Ereignisse wirken sich negativ auf die Ergebnisqualität aus und können die Bereitstellung Ihrer App verhindern. Doppelte Ereignisse können zu falschen Messwerten führen. |
Geben Sie für jeden aufgenommenen Ereignistyp mindestens 100 eindeutige Nutzer-Pseudo-IDs an. |
Dadurch wird sichergestellt, dass Apps für Medienempfehlungen über genügend Daten verfügen, um gute Ergebnisse zu generieren. |
|
Nutzer-Pseudo-IDs müssen beim Ereignisimport oder bei der Ereignisaufzeichnung und in Anfragen für Medienempfehlungen genau gleich formatiert sein. |
Wenn Sie ein einheitliches Format für Nutzer-Pseudo-IDs verwenden, können Apps für Medienempfehlungen Besuchermuster korrekt erkennen und Ergebnisse basierend auf dem Nutzerverhalten in besserer Qualität liefern. |
|
Das Feld |
Ein Ereignis, das ein Dokument ohne |
|
Die in den Ereignissen enthaltenen Dokumente sollten in Ihrem Datenspeicher vorhanden sein. |
Das Verhältnis von nicht verbundenen Ereignissen sollte so niedrig wie möglich sein. Ein hohes Verhältnis kann sich negativ auf die Qualität der Ergebnisse auswirken. |
|
Einige Nutzerereignisse sollten dieselbe Pseudo-ID haben. |
Damit gültige Verhaltenssequenzverläufe erstellt werden können, müssen Apps für Medienempfehlungen mehrere Ereignisse mit derselben Pseudo-Nutzer-ID sehen können.
Beispiel: |
|
view-item |
Fügen Sie genau ein Dokument pro Ereignis ein. |
Das Ereignis kann nicht verwendet werden, wenn kein Dokument vorhanden ist. Wenn mehrere Dokumente angegeben sind, ist das Ereignis fehlerhaft und kann nicht verwendet werden. |
media-play |
Fügen Sie genau ein Dokument pro Ereignis ein. |
Wenn mehrere Dokumente angegeben sind, ist das Ereignis fehlerhaft und kann nicht verwendet werden. |
Beispiele für Nutzerereignistypen und Schemas
In diesem Abschnitt werden die Datenformate für jeden von den Medienempfehlungen unterstützten Ereignistyp bereitgestellt.
Beispiele für JavaScript Pixel werden bereitgestellt. Für BigQuery wird das vollständige Tabellenschema für jeden Typ bereitgestellt.
Für alle Nutzerereignistypen ist userId
optional.
Hinweis:
Das Feld
tagIds
ist nur erforderlich, wenn Sie einen A/B-Test machen.Das Feld
attributionToken
ist optional. Es wird verwendet, um die Leistung zu messen.search
- undview-item
-Ereignisse, die über Klicks in einer Media-App generiert werden, sollten ein Attributionstoken haben, damit die Ereignisse mit den Empfehlungen verknüpft werden können, die sie generiert haben.
Weitere Informationen zum Nutzerereignisobjekt finden Sie in der UserEvent
API-Referenzdokumentation.
view-category-page
Im Folgenden sehen Sie das Nutzerereignisformat view-category-page
.
Mindestens erforderliches view-category-page-Objekt
In den folgenden Beispielen werden nur die erforderlichen Felder des Nutzerereignisformats view-category-page
gezeigt.
Obwohl normalerweise nur eine Kategorie mit einer Seite verknüpft ist, unterstützt das Feld pageCategories
auch eine Kategoriehierarchie, die Sie als Liste bereitstellen können.
JavaScript Pixel
var user_event = { "eventType": "view-category-page", "userPseudoId": "user-pseudo-id", "eventTime": "2020-01-01T03:33:33.000001Z", "pageInfo": { "pageCategory": "category1 > category2" } };
BigQuery
Dies ist das vollständige JSON-Schema für diesen Nutzerereignistyp. Geben Sie dieses Schema an, wenn Sie Tabellen für diesen Nutzerereignistyp in BigQuery erstellen.
Die Modi für Pflichtfelder werden auf REQUIRED
oder REPEATED
gesetzt. Die Modi für optionale Felder sind auf NULLABLE
gesetzt.
Beachten Sie, dass eventTime
zum Importieren von Ereignissen mit BigQuery erforderlich ist. eventTime
ist ein String im Zeitstempelformat.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "pageCategory", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] } ]
view-item
Im Folgenden sehen Sie das Datenformat des Nutzerereignisses view-item
.
Mindestens erforderliches view-item-Objekt
In den folgenden Beispielen werden nur die erforderlichen Felder des Nutzerereignisformats view-item
gezeigt.
In den meisten Fällen enthält documents
Details zum zugehörigen Dokument.
JavaScript Pixel
var user_event = { "eventType": "view-item", "userPseudoId": "user-pseudo-id", "eventTime": "2020-01-01T03:33:33.000001Z", "documents": [{ "id": "document-id" }] };
BigQuery
Dies ist das vollständige JSON-Schema für diesen Nutzerereignistyp. Geben Sie dieses Schema an, wenn Sie Tabellen für diesen Nutzerereignistyp in BigQuery erstellen.
Die Modi für Pflichtfelder werden auf REQUIRED
oder REPEATED
gesetzt. Die Modi für optionale Felder sind auf NULLABLE
gesetzt.
Beachten Sie, dass eventTime
zum Importieren von Ereignissen mit BigQuery erforderlich ist. eventTime
ist ein String im Zeitstempelformat.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] } ]
view-home-page
Im Folgenden sehen Sie das Nutzerereignisformat view-home-page
.
Mindestens erforderliches view-home-page-Objekt
In den folgenden Beispielen werden nur die erforderlichen Felder des Nutzerereignisformats view-home-page
gezeigt.
JavaScript Pixel
var user_event = { "eventType": "view-home-page", "userPseudoId": "user-pseudo-id", "eventTime": "2020-01-01T03:33:33.000001Z", };
BigQuery
Dies ist das vollständige JSON-Schema für diesen Nutzerereignistyp. Geben Sie dieses Schema an, wenn Sie Tabellen für diesen Nutzerereignistyp in BigQuery erstellen.
Die Modi für Pflichtfelder werden auf REQUIRED
oder REPEATED
gesetzt. Die Modi für optionale Felder sind auf NULLABLE
gesetzt.
Beachten Sie, dass eventTime
zum Importieren von Ereignissen mit BigQuery erforderlich ist. eventTime
ist ein String im Zeitstempelformat.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" }, { "name": "quantity", "type": "INT64", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] } ]
search
Im Folgenden sehen Sie das Nutzerereignisformat search
.
Mindestens erforderliches search-Objekt
In den folgenden Beispielen werden nur die erforderlichen Felder des Nutzerereignisformats search
gezeigt.
Mindestens eines der Felder searchQuery
oder pageCategory
ist erforderlich:
Geben Sie
searchQuery
für Suchen ein, bei denen der Nutzer eine Textabfrage eingegeben hat.Geben Sie
pageCategory
an, wenn der Nutzer durch Stöbern zu den gewünschten Elementen gelangt ist, also durch Klicken auf Kategorien statt durch Eingabe einer Textabfrage.
documents
sollte die Liste der Dokument-IDs enthalten, die dem Endnutzer auf der Suchergebnisseite angezeigt werden.
JavaScript Pixel
var user_event = { eventType: "search", userPseudoId: "user-pseudo-id", eventTime: "2020-01-01T03:33:33.000001Z", searchInfo: { searchQuery: "search-query", }, pageInfo: { pageCategory: "category1 > category2", }, attributionToken: "attribution-token", documents: [ { id: "document-id1", }, { id: "document-id2", }, ] };
BigQuery
Dies ist das vollständige JSON-Schema für diesen Nutzerereignistyp. Geben Sie dieses Schema an, wenn Sie Tabellen für diesen Nutzerereignistyp in BigQuery erstellen.
Die Modi für Pflichtfelder werden auf REQUIRED
oder REPEATED
gesetzt. Die Modi für optionale Felder sind auf NULLABLE
gesetzt.
Beachten Sie, dass eventTime
zum Importieren von Ereignissen mit BigQuery erforderlich ist. eventTime
ist ein String im Zeitstempelformat.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "searchInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "searchQuery", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageCategory", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] } ]
media-play
Im Folgenden sehen Sie das Nutzerereignisformat media-play
.
Mindestens erforderliches media-play-Objekt
In den folgenden Beispielen werden nur die erforderlichen Felder des Nutzerereignisformats media-play
gezeigt.
JavaScript Pixel
var user_event = { "eventType": "media-play", "userPseudoId": "user-pseudo-id", "eventTime": "2020-01-01T03:33:33.000001Z", "documents": [ { "id": "document-id1" } ] };
BigQuery
Dies ist das vollständige JSON-Schema für diesen Nutzerereignistyp. Geben Sie dieses Schema an, wenn Sie Tabellen für diesen Nutzerereignistyp in BigQuery erstellen.
Die Modi für Pflichtfelder werden auf REQUIRED
oder REPEATED
gesetzt. Die Modi für optionale Felder sind auf NULLABLE
gesetzt.
Beachten Sie, dass eventTime
zum Importieren von Ereignissen mit BigQuery erforderlich ist. eventTime
ist ein String im Zeitstempelformat.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] } ]
media-complete
Im Folgenden sehen Sie das Nutzerereignisformat media-complete
.
Mindestens erforderliches media-complete-Objekt
In den folgenden Beispielen werden nur die erforderlichen Felder des Nutzerereignisformats media-complete
gezeigt.
JavaScript Pixel
var user_event = { "eventType": "media-complete", "userPseudoId": "user-pseudo-id", "eventTime": "2020-01-01T03:33:33.000001Z", "documents": [ { "id": "document-id1" } ], "mediaInfo": { "mediaProgressDuration": "65s", "mediaProgressPercentage": 1.2 } };
BigQuery
Dies ist das vollständige JSON-Schema für diesen Nutzerereignistyp. Geben Sie dieses Schema an, wenn Sie Tabellen für diesen Nutzerereignistyp in BigQuery erstellen.
Die Modi für Pflichtfelder werden auf REQUIRED
oder REPEATED
gesetzt. Die Modi für optionale Felder sind auf NULLABLE
gesetzt.
Beachten Sie, dass eventTime
zum Importieren von Ereignissen mit BigQuery erforderlich ist. eventTime
ist ein String im Zeitstempelformat.
[ { "name": "eventType", "type": "STRING", "mode": "REQUIRED" }, { "name": "userPseudoId", "type": "STRING", "mode": "REQUIRED" }, { "name": "eventTime", "type": "STRING", "mode": "REQUIRED" }, { "name": "userInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "userId", "type": "STRING", "mode": "NULLABLE" }, { "name": "userAgent", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "pageInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "pageviewId", "type": "STRING", "mode": "NULLABLE" }, { "name": "uri", "type": "STRING", "mode": "NULLABLE" }, { "name": "referrerUri", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "attributionToken", "type": "STRING", "mode": "NULLABLE" }, { "name": "documents", "type": "RECORD", "mode": "REPEATED", "fields": [ { "name": "id", "type": "STRING", "mode": "NULLABLE" } ] }, { "name": "tagIds", "type": "STRING", "mode": "REPEATED" }, { "name": "attributes", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "example_text_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "text", "type": "STRING", "mode": "REPEATED" } ] }, { "name": "example_number_attribute", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "numbers", "type": "NUMERIC", "mode": "REPEATED" } ] } ] }, { "name": "mediaInfo", "type": "RECORD", "mode": "NULLABLE", "fields": [ { "name": "mediaProgressDuration", "type": "STRING", "mode": "NULLABLE" }, { "name": "mediaProgressPercentage", "type": "NUMERIC", "mode": "NULLABLE" } ] } ]
Benutzerdefinierte Attribute
Sie können zusätzliche benutzerdefinierte Attribute und Funktionen für Nutzerereignisse hinzufügen. Dies kann zu besseren, spezifischeren Ergebnissen für Ihre Nutzer führen.
Verwenden Sie zum Hinzufügen benutzerdefinierter Attribute attributes
, wenn Sie ein Nutzerereignis aufzeichnen.
Wenn Sie benutzerdefinierte Attribute für aufgenommene Nutzerereignisse angeben, müssen Sie diese auch in die Nutzerereignisse aufnehmen, die Sie mit Empfehlungs- und Suchanfragen verknüpfen. Die Formatierung von benutzerdefinierten Attributen muss bei importierten Ereignissen und Ereignissen, die mit Anfragen bereitgestellt werden, einheitlich sein. So können Medien-Apps diese benutzerdefinierten Attribute verwenden, um die Qualität zu verbessern.
Sie können benutzerdefinierte Textwerte mit dem Feld text
oder benutzerdefinierte numerische Werte mit dem Feld numbers
angeben.
Das folgende Beispiel zeigt den Abschnitt attributes
aus einer Anfrage zum Aufzeichnen eines Nutzerereignisses:
attributes: { user_age: {text: ["teen", "young adult"]}, user_location: {text: ["CA"]}, user_zip: {numbers: [90210]} }
Über Nutzerinformationen
userPseudoId
steht für die eindeutige Nutzerkennung und ist erforderlich, wenn Sie ein Nutzerereignis aufzeichnen.
Die Nutzerinformationen (UserInfo
), die beim Aufzeichnen eines Nutzerereignisses einbezogen werden, enthalten den Wert userPseudoId
und, falls verfügbar, den Wert userId
.
userId
ist optional und kann als eindeutige, dauerhafte Kennzeichnung für einen Nutzer auf allen Geräten verwendet werden, wenn sich ein Nutzer auf Ihrer Website anmeldet. Wenn Sie den userId
für einen Nutzer aufzeichnen, können Apps für die Mediensuche und Empfehlungen für einen Nutzer persönlichere Ergebnisse über mehrere Geräte hinweg generieren, z. B. sowohl ein Mobilgerät als auch einen Webbrowser.
Informationen zum Zeitstempel
Wenn Sie ein Nutzerereignis aufzeichnen, müssen Sie einen genauen Zeitstempel für das Ereignis angeben. Genaue Zeitstempel sorgen dafür, dass Ihre Ereignisse in der richtigen Reihenfolge gespeichert werden. Für Ereignisse, die mit dem JavaScript-Pixel erfasst wurden, werden Zeitstempel automatisch erfasst. Beim Importieren von Ereignissen müssen Sie den Zeitstempel im Feld eventTime
in dem von RFC 3339 angegebenen Format festlegen.