Measure Google Analytics Events (Google Analytics-Ereignisse erfassen)

Auf dieser Seite wird erläutert, wie Sie gtag.js verwenden, um Google Analytics-Ereignisse zu senden.

Ereignisse senden

Wenn Sie Google Analytics-Ereignisse auf einer Webseite senden möchten, auf der das Google-Tag hinzugefügt wurde, verwenden Sie den gtag.js-Befehl event mit der folgenden Syntax:

gtag('event', <action>, {
  'event_category': <category>,
  'event_label': <label>,
  'value': <value>
});
Name Typ Standardwert Beschreibung
<action> string Der Wert, der in Google Analytics-Ereignisberichten als Ereignisaktion angezeigt wird.
<category> string "general" Die Kategorie des Ereignisses.
<label> string Das Label des Ereignisses.
<value> number Eine nicht negative Ganzzahl, die als Ereigniswert angezeigt wird.

Mit folgendem Befehl wird ein Ereignis mit der Aktion 'aaa', der Kategorie 'bbb' und dem Label 'ccc' gesendet:

gtag('event', 'aaa', {
  'event_category' : 'bbb',
  'event_label' : 'ccc'
});

Wenn <category> oder <label> weggelassen wird, werden sie auf den Standardwert "(not set)" festgelegt.

Weitere Informationen dazu, wie die Struktur von Ereignissen von Google Analytics interpretiert wird, finden Sie unter Anatomie von Google Analytics-Ereignisparametern.

Google Analytics-Standardereignisse

Sie sollten die standardmäßigen Google Analytics-Ereignisse verwenden, die vordefinierte Kategorien und Labels haben. Die Verwendung dieser Ereignisse erleichtert die konsistente Berichterstellung und Interoperabilität mit zukünftigen Funktionen.

In der folgenden Tabelle sind die standardmäßigen Google Analytics-Ereignisse, ihre Standardkategorien und Standardlabeltypen (falls verfügbar) aufgeführt. Für Ereignisnamen, die in dieser Tabelle nicht aufgeführt sind (z.B. beliebige von Ihnen erstellte Ereignisnamen), ist die Standardkategorie "engagement" und das Standardlabel "(not set)".

Ereignisname Standardkategorie Standard-Labeltyp
add_payment_info ecommerce  
add_to_cart ecommerce  
add_to_wishlist ecommerce  
begin_checkout ecommerce  
checkout_progress ecommerce  
generate_lead engagement  
login engagement method
purchase ecommerce  
refund ecommerce  
remove_from_cart ecommerce  
search engagement search_term
select_content engagement content_type
set_checkout_option ecommerce  
share engagement method
sign_up engagement method
view_item engagement  
view_item_list engagement  
view_promotion engagement  
view_search_results engagement search_term

Ereignisse ohne Interaktion senden

Wenn Sie ein Ereignis ohne Interaktion senden möchten, setzen Sie den Parameter non_interaction auf true:

gtag('event', 'video_auto_play_start', {
  'event_label': 'My promotional video',
  'event_category': 'video_auto_play',
  'non_interaction': true
});