Auf dieser Seite wird erläutert, wie Sie mit gtag.js Google Analytics-Ereignisse 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. |
Im Folgenden 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 werden, werden sie auf die Standardwerte "(not set)" festgelegt.
Weitere Informationen dazu, wie die Struktur von Ereignissen in Google Analytics interpretiert wird, finden Sie unter Google Analytics-Ereignisparameter.
Google Analytics-Standardereignisse
Sie sollten die standardmäßigen Google Analytics-Ereignisse verwenden, die vordefinierte Kategorien und Labels haben. Diese Ereignisse ermöglichen eine einheitliche Berichterstellung und Interoperabilität mit zukünftigen Funktionen.
In der folgenden Tabelle sind die standardmäßigen Google Analytics-Ereignisse, ihre Standardkategorien und gegebenenfalls die Labeltypen aufgeführt. Für Ereignisnamen, die nicht in dieser Tabelle aufgeführt sind (z.B. von Ihnen erstellte beliebige Ereignisnamen), lautet die Standardkategorie "engagement" und das Standardlabel "(not set)".
| Ereignisname | Standardkategorie | Standardlabeltyp |
|---|---|---|
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
Setze zum Senden eines Ereignisses ohne Interaktion 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
});