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 Beispiel 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 von "(not set)"
gesetzt.
Weitere Informationen dazu, wie die Ereignisstruktur 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 nicht in dieser Tabelle aufgeführt sind (z.B. 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, legen Sie den Parameter non_interaction
auf true
fest:
gtag('event', 'video_auto_play_start', {
'event_label': 'My promotional video',
'event_category': 'video_auto_play',
'non_interaction': true
});