# Yhdistä Google Analytics 4 cPixeliin {#doc-title}

Kirjoittaja: [B2B Gold](/about/#how-we-write) Päivitetty 25. syyskuuta 2026 [Käännetty englannista tekoälytyökaluilla](/docs/cpixel/connect-ga4/) [cPixel-sivu](/shopify/cpixel/) [cPixel Shopify App Storessa](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=fi/docs/cpixel/connect-ga4&utm_term=docs-header)

## Miten yhdistän GA4:n cPixeliin? {#how-do-i-connect-ga4-to-cpixel}

Avaa Google Analyticsissa Admin, Data collection and modification, Data streams, avaa web-tietovirtasi ja kopioi G-alkuinen mittaustunnus. Avaa samalla paneelilla Measurement Protocol API secrets ja luo yksi. Liitä molemmat cPixeliin ja vahvista sitten oikealla tilauksella, koska GA4 hyväksyy väärän salaisuuden hiljaa.

### Liitä ne cPixeliin {#paste-them-into-cpixel}

1. Avaa cPixelissä **Kohteet** ja napsauta GA4-kuvaketta kohdassa **Yhdistä alusta**. **Määritä Google Analytics 4-tili** avautuu näkymään **Liitä tunnuksesi**.
2. Liitä mittaustunnus kenttään **Mittaustunnus** ja salaisuus kenttään **Measurement Protocol API -salaisuus (valinnainen)**. Nimeä tili kohdassa **Nimeä tämä tili (valinnainen)**, jos haluat, ja napsauta sitten **Jatka**.
3. Kohdassa **Valitse asetukset** pidä **Lähetä tapahtumat selaimesta** ja **Lähetä tapahtumat palvelimiltamme** valittuina. Pidä **Ei — cPixel hoitaa Google Analytics 4:n (suositeltu)** valittuna, ellei toinen työkalu lähetä tähän ominaisuuteen: nimestään huolimatta **Kyllä — pidä se, niin cPixel lopettaa Google Analytics 4:n lähettämisen palvelinpuolelta** pysäyttää cPixelin selain- ja palvelinlähetykset sille.
4. Kohdassa **Lisäasetukset** **Tietojen sijainti** voi lähettää palvelinpuolen tapahtumat Googlen EU-päätepisteeseen; vain päätepiste muuttuu. Napsauta **Tallenna ja jatka**. **Testaa** vahvistaa: **Google Analytics 4-tili on yhdistetty**.

> **Tärkeää:** Salaisuus on valinnainen ohjatussa toiminnossa, mutta ilman sitä tili pysyy tilassa **Vain selain**: selaustapahtumia, ei ostoja.

## Mistä löydän GA4-mittaustunnukseni? {#where-do-i-find-my-ga4-measurement-id}

Web-tietovirtasi tiedoissa GA4:n **Admin**-osiossa: `G-` ja sen jälkeen kirjaimia ja numeroita, tyypillisesti kymmenen ([Google](https://support.google.com/analytics/answer/12270356)).

1. Valitse [Google Analyticsissa](https://analytics.google.com/analytics/web/) omaisuutesi, napsauta **Admin** vasemmassa alakulmassa ja, kohdassa **Data collection and modification**, napsauta **Data streams**.
2. Napsauta kauppasi web-tietovirtaa. **Measurement ID** on **Stream details**-osion ensimmäisellä rivillä; käytä sen vieressä olevaa kopiointikuvaketta.

> **Huom:** Mittaustunnus ei ole **Stream ID**, tavallinen numero samalla rivillä, eikä omaisuuden tunnus. cPixel haluaa sen, joka alkaa `G-`.

## Miten luon Measurement Protocol API -salaisuuden? {#how-do-i-create-a-measurement-protocol-api-secret}

Samalla tietovirtapaneelilla: avaa **Measurement Protocol API secrets**, luo salaisuus ja kopioi sen arvo, noin 22 merkkiä. Googlen opas: [Measurement Protocol GA4:lle](https://developers.google.com/analytics/devguides/collection/protocol/ga4).

1. Vieritä **Events**-osioon ja napsauta **Measurement Protocol API secrets**, sen viimeinen rivi. Olemassa olevat salaisuudet on listattu, ja voit käyttää yhtä niistä uudelleen.
2. Napsauta **Create**, anna sille lempinimi kuten cPixel, napsauta **Create** uudelleen ja kopioi **Secret value** cPixeliin.

Google saattaa ensin pyytää sinua hyväksymään käyttäjätietojen keräysehtonsa ([Google](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties/acknowledgeUserDataCollection)).

## Miksi GA4 ei varoita väärästä salaisuudesta? {#why-doesnt-ga4-warn-about-a-wrong-secret}

Koska Measurement Protocol ei koskaan raportoi virheitä. Google sanoo, ettei se “palauta HTTP-virhekoodeja, vaikka tapahtuma olisi virheellinen”, eikä sen vahvistuspalvelin tarkista API-salaisuutta ([Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/validating-events)).

Joten väärä salaisuus näyttää onnistumiselta kaikkialla: Live näyttää **Hyväksytty**, tili näyttää **Vahvistettu** eikä hälytystä laukea, kun taas GA4 hylkää datan. **Testaa yhteys** käyttää Googlen vahvistuspalvelinta, joten se tarkistaa kuorman, ei salaisuutta.

## Mitä cPixel lähettää GA4:lle, ja mistä? {#what-does-cpixel-send-to-ga4-and-from-where}

Ostot ja hyvitykset lähtevät cPixelin palvelimilta; kaikki muu ostajan selaimesta, tai palvelimelta kun selaimen kopio ei koskaan lähtenyt laitteelta.

| Lähetetty | Tapahtumat |
| --- | --- |
| Selain: Shopifyn web-pikseli, jokaisella sivulla kassa mukaan lukien | page_view, view_item, view_item_list, search, view_cart, add_to_cart, remove_from_cart, begin_checkout, add_shipping_info, add_payment_info |
| Palvelin: Measurement Protocol | purchase, tilaus tapahtumatunnuksena; refund, kun hyvität tilauksen |
| Palvelin, vain kun selain ei pystynyt | Selaintapahtuma, joka ei koskaan lähtenyt ostajan laitteelta, merkitty Livessä estetyn selaintapahtuman uudelleenlähetykseksi |

GA4 deduplikoi ostot tapahtumatunnuksen perusteella web-tietovirroilla ([Google](https://support.google.com/analytics/answer/12313109)), mutta ei muita tapahtumia, joten cPixel lähettää kunkin niistä kerran. Se ei voi palauttaa tapahtumaa, kun estäjä pysäytti myös cPixelin oman pyynnön, eikä se voi nähdä GA4:n hylkäävän selaintapahtumaa.

Osto tarvitsee selainistunnon, jonka cPixelin pikseli tallentaa kassalla. Ilman sitä, kuten kun estäjä pysäytti cPixelin pyynnön, Live näyttää “Ei tarpeeksi dataa tämän kohteen payloadin rakentamiseen” eikä GA4 saa ostoa.

Palvelinostot kuljettavat GA4:n asiakas- ja istuntotunnukset, tiivistetyn sähköpostin ja puhelimen, sekä Shopify-asiakastunnuksen tiivistämättömänä `user_id`-kentässä. Molemmat reitit tarvitsevat ostajan analytiikkasuostumuksen.

> **Huom:** GA4 antaa palvelintapahtumalle sen käynnin lähteen, median ja kampanjan vain, jos se saapuu 24 tunnin sisällä istunnon alkamisesta ([Google](https://developers.google.com/analytics/devguides/collection/protocol/ga4/use-cases)). Myöhemmin lähetetyt ostot, esimerkiksi asetuksella **Kun tilaus lähetetään** kohdassa **Settings**, voivat menettää kampanjansa.

Shopifyn Google & YouTube -sovellus voi myös lähettää sivunäyttöjä ja ostoja omaisuuteesi, joten pidä [yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/). cPixelin päivittäinen tarkistus merkitsee GA4-tagin, joka on liitetty teemaasi:

## Miten tarkistan, että se toimi? {#how-do-i-check-it-worked}

Tee oikea tilaus ja etsi osto cPixelin **Livestä** ja GA4:n **Realtime**-raportista. Testitilaukset ohitetaan oletuksena: maksa oikealla tavalla, tai poista valinta kohdasta **Settings** → **Testitilaukset**.

1. Avaa cPixelissä **Live**, napsauta **Aloita istunto**, ja tee sitten tilaus toisessa välilehdessä.
2. Avaa oston **Palvelin**-rivi. Google Analytics 4 näyttää **Hyväksytty**, mikä tarkoittaa vain, että Google vastasi.
3. Avaa GA4:ssä **Realtime**-raportti ja etsi ostoa. Realtime kestää tyypillisesti muutaman minuutin, muut raportit 24–48 tuntia ([Google](https://support.google.com/analytics/answer/11198161)).

DebugView ei näytä sitä: se listaa vain debug-tilassa lähetetyt tapahtumat, joita cPixelin oikeat lähetykset eivät ole ([Google](https://support.google.com/analytics/answer/7201382)).

## Mitä jos se ei toimi? {#what-if-it-doesnt-work}

Useimmat epäonnistumiset näkyvät cPixelin **Livessä**; väärä salaisuus ei näy missään, joten tarkista GA4 itse.

| Mitä näet | Mitä se tarkoittaa | Mitä tehdä |
| --- | --- | --- |
| **Hyväksytty** Livessä, ei ostoa GA4:ssä 48 tunnin jälkeen | Väärä salaisuus tai mittaustunnus, tai toiselta tietovirralta | Luo salaisuus samalle tietovirralle ja liitä se kohtaan **Hallinnoi Google Analytics 4-tiliä** kohdassa **Kohteet**, sitten **Jatka** ja **Tallenna ja jatka** |
| **Ohitettu**, syyn kera | cPixel valitsi olla lähettämättä, esimerkiksi analytiikkasuostumuksen puute tai testitilaus | Maksa oikeasti, tai poista valinta kohdasta **Testitilaukset** |
| Tili näyttää **Vain selain** | Salaisuutta ei ole tallennettu | Lisää sellainen kohdassa **Hallinnoi Google Analytics 4-tiliä** |
| Sivunäytöt tuplaantuneet, liikevaihto oikein | Toinen lähettäjä, kuten Google & YouTube -sovellus tai teemassa oleva tagi | Pidä [yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/) |

**Poista**, kohdassa **Hallinnoi Google Analytics 4-tiliä**, pysäyttää lähetykset kyseiselle tilille ja poistaa sen salaisuuden.

## Katso myös {#related}

- [Miksi GA4-ostot eivät täsmää Shopifyn kanssa](/blog/ga4-shopify-purchases/)
- [Katso jokainen lähetys Livessä](/fi/docs/cpixel/live-events/)
- [Yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/)
- [Miten cPixel laskee jokaisen oston vain kerran](/fi/docs/cpixel/deduplication/)

[cPixel Facebook Pixel CAPI GA4](/shopify/cpixel/)

[Asenna ilmaiseksi Shopify App Storesta](https://apps.shopify.com/cpixel?utm_source=b2bgold.app&utm_medium=referral&utm_campaign=docs&utm_content=fi/docs/cpixel/connect-ga4&utm_term=card) [Paketit ja hinnat](/shopify/cpixel/#pricing)

Tarvitsetko apua sovelluksen cPixel kanssa? Lähetä sähköpostia osoitteeseen [support@b2bgold.app](mailto:support@b2bgold.app).