Auf dieser Seite werden Nutzerereignisse für Apps für die Suche nach und Empfehlungen von Medien beschrieben, einschließlich Nutzerereignistypen, Anforderungen und Beispielen für Nutzerereignistypen. Nutzerereignisse sind für Media-Apps 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 Importieren von bisherigen Nutzerereignissen im Bulk finden Sie unter Bisherige Nutzerereignisse importieren.
Nutzerereignistypen
Sie können die folgenden Arten von Nutzerereignissen aufzeichnen, wenn Endnutzer Ihre Website besuchen oder durchsuchen:
Name des Nutzerereignisses | Nutzeraktion |
---|---|
view-category-page |
Ruft eine Kategorieseite auf, z. B. „Startseite“ > „TV“ > „Dramen“ oder „Startseite“ > „Filme“ > „Action“. |
view-item |
Details eines Dokuments ansehen |
view-home-page |
Ruft die Startseite auf. |
search |
Durchsucht den Datenspeicher. |
media-play |
Klicks auf die Schaltfläche „Wiedergeben“ bei einem Media-Element. |
media-complete |
Beendet die Wiedergabe eines Media-Elements und signalisiert das Ende der Wiedergabe. |
Weitere Informationen zum Nutzerereignisobjekt finden Sie in der UserEvent
-API-Referenzdokumentation.
Anforderungen an Ereignisse für die Mediensuche und ‑empfehlungen
In der folgenden Tabelle finden Sie Informationen dazu, welche Nutzerereignisse Sie erfassen müssen.
Die Arten von Nutzerereignissen, die Sie benötigen, hängen davon ab, ob Ihre App eine Such- oder Empfehlungs-App ist, vom Zielvorhaben (Klickrate, Conversion-Rate oder Wiedergabedauer) und, nur bei Empfehlungs-Apps, vom Typ des von Ihnen ausgewählten Modells. 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 |
|
---|---|---|---|---|---|---|---|
Anwendungsfall für die Suche | |||||||
Erforderlich | Nicht erforderlich |
Nicht erforderlich |
Erforderlich | Erforderlich | Erforderlich | ||
Modelltyp „Empfehlungen für Sie“ nach Zielvorhaben | |||||||
CTR | Nicht erforderlich |
Für den Kontext auf der Startseite erforderlich Für den allgemeinen Kontext nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Dringend empfohlen Erforderlich, wenn die Herabstufung des Verlaufs aktiviert ist |
||
CVR | Nicht erforderlich |
Für den Kontext auf der Startseite erforderlich Für den allgemeinen Kontext nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Erforderlich | ||
Wiedergabedauer | Nicht erforderlich |
Für den Kontext auf der Startseite erforderlich Für den allgemeinen Kontext nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Erforderlich | ||
Modelltyp „Was Ihnen sonst noch gefallen könnte“ nach Zielvorhaben | |||||||
CTR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Dringend empfohlen Erforderlich, wenn die Herabstufung des Verlaufs aktiviert ist |
||
CVR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Erforderlich | ||
Wiedergabedauer | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Erforderlich | ||
Modelltyp „Ähnlich wie diese“ nach Zielvorhaben | |||||||
CTR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Erforderlich, wenn die Herabstufung des Verlaufs aktiviert ist | ||
CVR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Erforderlich | ||
Wiedergabedauer | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Erforderlich | ||
Beliebteste Modelltypen nach Zielvorhaben | |||||||
CTR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Entweder view-item oder media-play ist erforderlich. |
Nicht erforderlich |
||
CVR | Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Nicht erforderlich |
Erforderlich |
Anforderungen an Media-Nutzerereignisse
Achten Sie darauf, dass Ihre Nutzerereignisse die folgenden Anforderungen erfüllen, damit Ihre Media-Apps Qualitätsergebnisse generieren können.
Ereignistyp | Anforderung | Auswirkungen |
---|---|---|
Alle Termine |
Geben Sie keine synthetischen Daten oder doppelten Ereignisse an. |
Synthetische oder doppelte Ereignisse wirken sich negativ auf die Ergebnisqualität aus und können verhindern, dass Sie Ihre App bereitstellen. Doppelte Ereignisse können zu falschen Messwerten führen. |
Geben Sie mindestens 100 eindeutige Pseudo-IDs für Nutzer für jeden aufgenommenen Ereignistyp an. |
Dadurch wird sichergestellt, dass Apps für Medienempfehlungen über genügend Daten verfügen, um gute Ergebnisse zu generieren. |
|
Pseudonymisierte Nutzer-IDs müssen beim Importieren oder Aufzeichnen von Ereignissen und in Anfragen für Media-Empfehlungen genau gleich formatiert sein. |
Wenn Sie ein einheitliches Format für Nutzer-Pseudonym-IDs verwenden, können Apps für Media-Empfehlungen Besuchermuster richtig erkennen und auf Grundlage des Nutzerverhaltens Ergebnisse 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 des Nutzers haben. |
Um gültige Verhaltenssequenzverläufe zu erstellen, müssen Apps für Medienempfehlungen mehrere Ereignisse mit derselben Nutzer-Pseudonym-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. |
search |
Fügen Sie die |
Mit dem |
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. |
Nutzerereignis-Tags für A/B-Tests
Wenn Sie A/B-Tests durchführen, müssen Sie allen Nutzerereignissen, die Sie erfassen, Tag-IDs hinzufügen. Fügen Sie für jede Testgruppe ein Tag hinzu.
Fügen Sie beispielsweise den Nutzerereignissen aus Ihrem aktuellen Modell das Tag "tagIds": ["original"]
und den Nutzerereignissen aus Vertex AI Search für Media das Tag "tagIds": ["google"]
hinzu.
Beispiele für Nutzerereignistypen und Schemas
In diesem Abschnitt werden die Datenformate für jeden von Media-Empfehlungen 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.
Weitere Informationen zum Nutzerereignisobjekt finden Sie in der API-Referenzdokumentation für UserEvent
.
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 mit einem 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 mit einem 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 mit einem 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.
searchQuery
für Suchereignisse an, bei denen der Nutzer eine Textanfrage eingegeben hat.
Die attributionToken
wird mit den Suchergebnissen zurückgegeben.
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", }, 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 mit einem 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 mit einem 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": 0.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 mit einem 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 sie auch in die Nutzerereignisse einbeziehen, die Sie Empfehlungs- und Suchanfragen zuordnen. Die Formatierung benutzerdefinierter Attribute muss zwischen importierten Ereignissen und Ereignissen, die mit Anfragen bereitgestellt werden, einheitlich sein. So können Media-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 permanente Kennzeichnung für einen Nutzer auf allen Geräten verwendet werden, wenn sich ein Nutzer auf Ihrer Website anmeldet. Wenn Sie die userId
für einen Nutzer aufzeichnen, können Apps für die Suche und Empfehlungen von Medien 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.