Mediennutzerereignisse

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-item Details eines Dokuments ansehen
view-home-page Ruft die Startseite auf.
search Durchsucht den Datenspeicher.
media-play Klicks auf die Wiedergabe eines Media-Elements.
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

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.

In der folgenden Tabelle finden Sie Informationen dazu, welche Nutzerereignisse Sie erfassen müssen.

Ereignis search view-home-page view-item media-play media-complete
Anwendungsfall für die Suche
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		 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		 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		 Entweder view-item oder media-play ist erforderlich. Erforderlich
Modelltyp „Was Ihnen sonst noch gefallen könnte“ nach Zielvorhaben
CTR 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		 Entweder view-item oder media-play ist erforderlich. Erforderlich
Wiedergabedauer Nicht
erforderlich		 Nicht
erforderlich		 Entweder view-item oder media-play ist erforderlich. Erforderlich
Modelltyp „Ähnlich wie diese“ nach Zielvorhaben
CTR 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		 Entweder view-item oder media-play ist erforderlich. Erforderlich
Wiedergabedauer Nicht
erforderlich		 Nicht
erforderlich		 Entweder view-item oder media-play ist erforderlich. Erforderlich
Beliebteste Modelltypen nach Zielvorhaben
CTR Nicht
erforderlich		 Nicht
erforderlich		 Entweder view-item oder media-play ist erforderlich. Nicht
erforderlich
CVR 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.

Fügen Sie diese IDs ein, damit Apps für Media-Empfehlungen genügend Daten haben, 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 DocumentInfo.name oder das Feld DocumentInfo.id ist für alle Dokumente erforderlich.

Ein Ereignis, das ein Dokument ohne DocumentInfo.name-Feld oder DocumentInfo.id-Feld enthält, kann nicht von Apps für Medienempfehlungen verwendet werden.

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: visitor123 hat sich fünf Elemente angesehen und bei zwei davon auf „Wiedergabe“ geklickt. Wenn diese Ereignisse dieselbe konsistent formatierte Pseudo-ID des Nutzers enthalten, kann eine App für Media-Empfehlungen diese Verhaltenssequenz in ihren Ergebnissen berücksichtigen.

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 attributionToken ein. Der attributionToken wird von der Methode search zusammen mit den Such- oder Browserergebnissen zurückgegeben.

Mit dem attributionToken kann Vertex AI Search das Suchereignis einer bestimmten Suchantwort genau zuordnen.

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-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"
  }]
  "panels": [
     {
       "panelId": "HOME_RFY_1",
       "documents": [
         {
           "id": "123"
         },
         {
           "id": "456"
         }
       ],
       "panelPosition": 1,
       "totalPanels": 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"
          }
        ]
      }
    ]
  }
]

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",
  "panels": [
     {
       "panelId": "HOME_RFY_1",
       "documents": [
         {
           "id": "123"
         },
         {
           "id": "456"
         }
       ],
       "panelPosition": 1,
       "totalPanels": 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": "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"
          }
        ]
      }
    ]
  }
]

Informationen zum panels-Objekt finden Sie unter Informationen zu Bereichen.

Im Folgenden sehen Sie das Nutzerereignisformat search.

Mindestens erforderliches search-Objekt

In den folgenden Beispielen werden nur die erforderlichen Felder des Nutzerereignisformats search gezeigt.

Geben Sie 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.

Bereiche

Auf einer Startseite gibt es in der Regel ein oder mehrere Bereiche, z. B. „Aktuelle Trends“ und „Für dich empfohlen“. Auf Detailseiten sind möglicherweise auch Bereiche wie „Das könnte dir auch gefallen“ zu sehen.

Bereichsinformationen für Nutzerereignisse

Panelinformationen sind für Nutzerereignisse vom Typ view-home-page und view-item erforderlich. Informationen für den Bereich sind für Startseiten und Detailseiten erforderlich, auf denen von Google empfohlene Inhalte angezeigt werden.

Wenn Sie A/B-Tests für ein Panel durchführen, müssen Sie Nutzerereignisse mit Panelinformationen für alle Inhalte im Test aufzeichnen, unabhängig von der Quelle. Für Startseiten und Detailseiten ohne von Google generierte Inhalte im Bereich wird empfohlen, aber nicht vorgeschrieben, Bereichsinformationen in den Ereignissen view-home-page und view-item anzugeben. Diese Anforderungen sind in der folgenden Tabelle zusammengefasst:

Quelle des Nutzerereignisses (view-home-page und view-item) PanelInfo erforderlich
Von Google empfohlene Inhalte Ja
Enthält Inhalte, die NICHT von Google empfohlen werden und in A/B-Tests verwendet werden Ja
Enthält Inhalte, die von Google NICHT empfohlen werden und NICHT in A/B-Tests verwendet werden Nein

Die Bereichsinformationen (PanelInfo) bestehen aus einer Reihe von Feldern, die verschiedene Elemente des Bereichs beschreiben:

  • Die ID-Nummer für den Bereich

  • Der Anzeigename

  • Die Position des Felds auf der Seite (z.B. das erste Feld (1) auf der Seite oder das dritte Feld (3) auf der Seite)

  • Die Gesamtzahl der Bereiche auf der Seite

  • Die Liste der Dokumente (DocumentInfo), die in jedem Bereich angezeigt werden

Ausführliche Informationen zu den PanelInfo-Objekten finden Sie unter PanelInfo.

Bereiche vorab laden oder verzögert laden

Es gibt zwei gängige Methoden zum Anzeigen von Empfehlungen auf Webseiten oder mobilen Seiten. Die von Ihnen verwendete Methode bestimmt die Anzahl und den Inhalt der view-home-page-Nutzerereignisse, die Sie aufzeichnen.

  • Vorabladen:Beim Vorabladen werden alle Empfehlungen generiert, bevor der Nutzer die Seite aufruft. In diesem Fall wird beim Laden der Startseite durch den Nutzer ein view-home-page- (oder view-item-)Nutzerereignis mit allen Bereichen und Dokumenten aufgezeichnet.

  • Lazy Loading:Beim Lazy Loading werden die Inhalte von Bereichen nicht generiert, wenn der Nutzer auf die Seite gelangt. Stattdessen werden Inhalte dynamisch geladen, wenn der Nutzer nach unten oder rechts scrollt, um weitere Empfehlungen zu sehen. Wenn ein Nutzer in diesem Fall die Startseite lädt, wird zuerst ein view-home-page- (oder view-item-)Nutzerereignis erfasst. Wenn der Nutzer dann scrollt, um weitere empfohlene Inhalte zu generieren, werden weitere Ereignisse erfasst. Bei den nachfolgenden Ereignissen müssen Sie im panels-Array nur die Anzahl der zusätzlich angezeigten Dokumente angeben.

Beispielszenario

Auf der Startseite eines Medienunternehmens werden zwei Empfehlungsbereiche angezeigt:

  • Ein Bereich mit aktuellen Trends, der auf dem Modell Most Popular (Beliebteste) basiert.

  • Ein personalisiertes Empfehlungsfeld, das in einem A/B-Test verwendet wird. Einige Nutzer sehen ein Vorschlagsfeld, das auf dem Modell Für Sie empfohlen basiert (Gruppe A), andere Nutzer sehen Empfehlungen aus dem proprietären Modell des Unternehmens (Gruppe B).

Wenn ein Nutzer, der Gruppe B zugewiesen ist, diese Startseite aufruft, sieht das Nutzerereignis im JavaScript-Pixel-Format so aus:

var user_event = {
  "eventType": "view-home-page",
  "userPseudoId": "4003345673.123451357",
  "eventTime": "2025-07-01T03:33:33.000001Z",
  "userInfo": {
    "userId": "jane.doe@example.com",
  },
  "tagIds": ["group-B"],
  "panels": [
    {
      "panelId": "panel-1",
      "displayId": "Trending Now",
      "documents": [
        {
          "id": "254722"
        },
        {
          "id": "2951"
        },
        ...
        {
          "id": "1201"
        }
      ],
      "panelPosition": 1,
      "totalPanels": 2
    },
    {
      "panelId": "panel-2",
      "displayId": "Recommended for You",
      "documents": [
        {
          "id": "79132"
        },
        {
          "id": "109487"
        },
        ...
        {
          "id": "164179"
        }
      ],
      "panelPosition": 2,
      "totalPanels": 2
    }
  ]
};

Nächste Schritte