Ymmärrä AI Commercen palvelinpuolinen GA4-seuranta

AI Commercen tässä koodikannassa todennettu GA4-tietolähde on palvelinpuolinen Measurement Protocol. Tapahtuma rakennetaan pyynnön yhteydessä, tallennetaan Redis-jonoon ja lähetetään ajastetusti HTTPS-osoitteeseen google-analytics.com/mp/collect. Lähetys otetaan käyttöön vain, kun verkkotunnukselle on asetettu sekä GA4-mittaustunniste että API-salaisuus. Selaimen gtag-tapahtumat tai niiden yhdistäminen palvelintapahtumiin eivät kuulu tähän todennettuun sopimukseen.

Tunnista palvelintapahtuman yhteiset tiedot

Palvelintapahtuman yhteiset tiedot ovat client_id, aikaleima, sivun osoite ja otsikko sekä mahdollisuuksien mukaan istunnon tunniste ja sitoutumisaika. transaction_id lisätään ostoon, tarjoukseen, yhteydenottoon tai pikaostoon silloin, kun kyseinen tunniste on saatavilla. Nämä kentät eivät itsessään todista selaintapahtumien deduplikointia. Jos rinnalla käytetään selaimen tagia tai Google Tag Manageria, tarkista päällekkäiset tapahtumat GA4-raportoinnista ennen konversioiden käyttöä.

Tunnista toteutetut sivu- ja liiditapahtumat

Toteutetut sivu- ja liiditapahtumat ovat page_view, search, sign_up, generate_lead ja benefit. Haku lähetetään vain, kun hakusana ei ole tyhjä. Yhteydenotto, pikaosto ja tarjous käyttävät generate_lead-tapahtumaa; pikaosto ja tarjous saavat oman lead_type-arvonsa. Muita selaimen automaattisia tapahtumia ei pidä merkitä AI Commercen palvelintuen piiriin pelkän GA4:ssä näkymisen perusteella. Tarkista tapahtuman nimi ja parametrit vastaanotetusta payloadista ennen raportin rakentamista.

Rajaa selaimen ja ulkoisten työkalujen tapahtumat pois palvelinluettelosta

Selaimen ja ulkoisten työkalujen tapahtumat, kuten user_engagement, session_start, first_visit, scroll, click, submit_form, contact_form, builderio-form-submit, file_download, exception, add_shipping_info, apply_coupon, login, register_submit, account_update, forgot_password, filter_applied ja country_change, eivät löydy tästä palvelintoteutuksesta. GA4 tai Google Tag Manager voi kerätä niitä muualla, mutta älä nimeä niitä AI Commercen natiivisti tukemiksi ilman kyseisen storefrontin kooditodistetta. Tarkista tarvittaessa DebugView tai reaaliaikanäkymä ja kirjaa, mistä tapahtuma saapui.

Tunnista toteutetut kaupankäyntitapahtumat

Toteutetut kaupankäyntitapahtumat ovat add_to_cart, add_to_wishlist, add_payment_info ja purchase. Ostoon liitetään tuotteet, valuutta, arvo ja tilauksen transaction_id. Maksutietotapahtuma sisältää tuotteet, arvon, maksutavan ja mahdollisen kupongin. Koodissa on myös begin_checkout- ja view_item-rakentajat, mutta nykyinen sivutyyppireititys ylikirjoittaa niiden tuloksen page_view-tapahtumalla. Älä rakenna raporttia niiden varaan ennen toteutuksen korjausta ja erillistä vahvistusta.

Erota GA4 Measurement Protocol Google Ads -konversioista

AI Commercen verkkotunnusasetuksissa on GA4:n mittaustunnisteen ja API-salaisuuden lisäksi erillisiä Google Ads -konversiotunnisteita. Ne eivät laajenna tässä kuvattua GA4-palvelintapahtumien luetteloa. Koodikannasta ei löydy artikkelin vanhaa selaimen gtag('event', 'conversion', ...) -esimerkkiä eikä integraatiopartnerin käyttöliittymälaajennusta. Toteuta uusi Google Ads- tai selaintapahtuma vain erillisen, katselmoidun seurantasuunnitelman perusteella ja varmista tapahtuman omistaja, arvo, valuutta sekä yksilöivä tunniste.

Arvioi seurannan kattavuus ja tietosuoja

Seurannan kattavuuden ja tietosuojan tekniset rajat ohittavat GA4-palvelinlähetyksen, jos aktiivista istuntoa ei ole, pyyntö tulee poissuljetusta IP-osoitteesta tai kyse on suostumuskutsusta. Ehdot eivät yksin osoita GDPR-vaatimustenmukaisuutta. Tarkista kaupan suostumusmalli, käyttötarkoitukset, säilytysajat, mittaustunniste ja API-salaisuus. Vahvista jokainen raportointiin tai konversioksi valittu tapahtuma GA4:n vastaanottamasta datasta ja selvittämäsi Google-version ajantasaisista ohjeista.