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
});