# Yhdistä Meta Pixel ja Conversions API cPixeliin {#doc-title}

Kirjoittaja: [B2B Gold](/about/#how-we-write) Päivitetty 25. syyskuuta 2026 [Käännetty englannista tekoälytyökaluilla](/docs/cpixel/connect-meta/) [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-meta&utm_term=docs-header)

## Miten yhdistän Metan cPixeliin? {#how-do-i-connect-meta-to-cpixel}

Avaa cPixelissä Kohteet, valitse Meta ja liitä kaksi arvoa Meta Events Managerista: Pixel ID, joka löytyy tietojoukkosi Settings-välilehdeltä, ja Conversions API -pääsytoken, joka luodaan samalta välilehdeltä alempaa. Valitse Set up without Dataset Quality API, kun Meta kysyy sitä. Seuraa sitten Metan vastausta jokaiseen palvelinlähetykseen Livessä.

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

1. Avaa cPixelissä **Kohteet** ja napsauta Meta-kuvaketta kohdassa **Yhdistä alusta**. **Määritä Meta-tili** avautuu näkymään **Liitä tunnuksesi**.
2. Liitä **Pixel ID tai tietojoukon tunnus** ([mistä se löytyy](#where-do-i-find-my-meta-pixel-id)) ja **Conversions API -pääsytoken** ([miten sellainen hankitaan](#how-do-i-get-a-conversions-api-access-token)). Ilman tokenia tili on **Vain selain**.
3. Nimeä tili kohdassa **Nimeä tämä tili (valinnainen)**, jos haluat, ja napsauta sitten **Jatka**.
4. Kohdassa **Valitse asetukset** pidä **Lähetä tapahtumat selaimesta** ja **Lähetä tapahtumat palvelimiltamme** valittuina. Pidä **Ei — cPixel hoitaa Meta:n (suositeltu)** valittuna, ellei toinen työkalu lähetä tähän tietojoukkoon: nimestään huolimatta **Kyllä — pidä se, niin cPixel lopettaa Meta:n lähettämisen palvelinpuolelta** pysäyttää cPixelin selain- ja palvelinlähetykset sille ([yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/)). **Lisäasetukset** on valinnainen ([tilaussäännöt](/fi/docs/cpixel/order-rules/)).
5. Napsauta **Tallenna ja jatka**. **Testaa** vahvistaa: **Meta-tili on yhdistetty**.

Voit yhdistää useita Meta-pikseleitä, jotka jakavat cPixelin tapahtumatunnukset, mutta et samaa kahdesti.

## Mistä löydän Meta Pixel ID:ni? {#where-do-i-find-my-meta-pixel-id}

Avaa [Meta Events Managerissa](https://business.facebook.com/events_manager2) kauppasi web-tietojoukko ja avaa **Settings**: siellä oleva **Pixel ID**, noin 15 numeroa, syötetään cPixelin kenttään **Pixel ID tai tietojoukon tunnus**. Meta kutsuu sitä lähes kaikkialla muualla tietojoukon tunnukseksi (dataset ID).

1. Etsi tietojoukkosi. Web-tietojoukolla, jollaista Shopify-kauppa käyttää, on näyttökuvake; puhelinkuvake tarkoittaa sovellustietojoukkoa.
2. Valitse se. Uusi tietojoukko näyttää **Your pixel hasn’t received any activity**, kunnes tapahtumia saapuu.
3. Avaa **Settings** ja kopioi numero kohdasta **Details** → **Pixel ID**.

> **Vihje:** Kahdella tietojoukolla voi olla sama nimi. Jos vain toinen niistä voi luoda tokenin, ne ovat eri tietojoukkoja: tarkista tunnus.

## Miten hankin Conversions API -pääsytokenin? {#how-do-i-get-a-conversions-api-access-token}

Valitse samalla **Settings**-välilehdellä, kohdassa **Conversions API**, **Set up without Dataset Quality API** ja napsauta **Generate access token**. Rastita tämän kaupan tietojoukko ja kopioi token, pitkä `EAA`-alkuinen merkkijono, heti: Meta näyttää sen vain kerran eikä tallenna sitä.

1. Vieritä **Settings** alas kohtaan **Conversions API**. Alla oleva kuvakaappaus, kuten Metan omakin, näyttää vaihtoehdot kohdassa **Set up direct integration**; Metan oppaan teksti sanoo **Set up manually**. Käytä sitä, minkä tilisi näyttää.
2. Valitse **Set up without Dataset Quality API** ([miksi](#should-i-set-up-the-dataset-quality-api)).
3. Napsauta **Generate access token** ja rastita tämän kaupan tietojoukko.
4. Kopioi token ennen kuin suljet paneelin. Metan huomautus on kirjaimellinen: **Copy and save this token somewhere safe. It won’t be stored by Facebook.**
5. Liitä se cPixelin kenttään **Conversions API -pääsytoken**.

> **Tärkeää:** Harmaana näkyvä **Generate access token** (kohdistettuna: **Missing prerequisite**) tarkoittaa, ettet ole tietojoukon omistavan yrityssalkun ylläpitäjä tai kehittäjä ([Meta](https://developers.facebook.com/documentation/ads-commerce/conversions-api/get-started)); tietojoukko, joka on luotu henkilökohtaisen mainostilin alle, aiheuttaa tämän. Pyydä salkun ylläpitäjää, tai [lisää tietojoukko salkkuun](https://www.facebook.com/business/help/1910428752389787) kohdassa **Data sources** Meta Business Suiten **Settings**-osiossa.

Token toimii vain niille tietojoukoille, jotka rastitit. Meta ei kerro, kuinka kauan Events Managerista luotu token kestää, ja se lakkaa toimimasta, jos sen järjestelmäkäyttäjä menettää pääsyn tietojoukkoon, minkä Meta ilmoittaa käyttöoikeusvirheenä.

## Pitäisikö minun ottaa käyttöön Dataset Quality API? {#should-i-set-up-the-dataset-quality-api}

Ei. cPixel ei tarvitse sitä, ja Metan valintaikkuna varoittaa, että kun tietojoukko alkaa käyttää Quality API:a, siitä ei tällä hetkellä voi poistua. Meta merkitsee sen **Recommended** ja sanoo sen lisäävän mittareita, kuten tapahtumien täsmäysastetta; ilman sitä luotu token lähettää samat tapahtumat.

Ilman sitä cPixelin **Tapahtumien laatu** -sivu saattaa sanoa **Tämän tyyppinen token ei voi lukea Metan pisteitä**, ainoan asian, jonka Quality API sinne lisäisi. Lähettämiseen tämä ei vaikuta.

## Mitä cPixel lähettää Metalle? {#what-does-cpixel-send-to-meta}

PageView, ViewContent, Search, AddToCart, InitiateCheckout ja AddPaymentInfo lähtevät sekä ostajan selaimesta että cPixelin palvelimilta, jakaen yhden tapahtumatunnuksen. Purchase lähtee palvelimilta, rakennettuna uudelleen Shopify-tilauksesta. Deduplikointia ei tarvitse erikseen määrittää.

- Selaimen Purchase on pois päältä, kun cPixelin palvelinlähetys kyseiselle pikselille on aktiivinen. Se laukeaa vain, kun lähetys on pois päältä tai keskeytetty: ei tokenia tai hylätty sellainen, palvelinkytkin pois päältä, tai Free-sopimuksen tauko.
- Selainreitti toimii Shopifyn web-pikselissä jokaisella sivulla, kassa mukaan lukien, joten se ei tarvitse app embediä.
- Palvelinlähetykset kuljettavat tiivistettyä sähköpostia, puhelinnumeroa, asiakas- ja laitetunnuksia, `_fbp`- ja `_fbc`-evästeitä, IP-osoitteen ja käyttäjäagentin, ja oletuksena tiivistetyn sijainnin, joka on arvattu IP-osoitteesta. Meta tarvitsee markkinointisuostumuksen: katso [mitä cPixel lähettää, ja miten suostumus muuttaa sitä](/fi/docs/cpixel/event-quality-and-consent/).

## Pitäisikö minun käyttää testitapahtuman koodia? {#should-i-use-a-test-event-code}

Vain jos haluat käyttää **Testaa yhteys** -toimintoa. cPixel käyttää koodia vain siihen testiin ja yölliseen tarkistukseen tilille, jolla ei ole onnistunutta lähetystä 7 päivään, ei koskaan oikeille tapahtumille, oli ohjatun toiminnon huomautus mitä tahansa. Testi lähettää yhden oikean PageView-tapahtuman, jonka [Meta säilyttää](https://developers.facebook.com/documentation/ads-commerce/conversions-api/using-the-api) kohdistusta ja mittausta varten.

- Kopioi tietojoukkosi **Test events** -välilehdeltä `TEST`-alkuinen koodi kenttään **Testitapahtuman koodi (valinnainen)** ja napsauta sitten **Testaa yhteys**: **Working** tarkoittaa, että Meta hyväksyi testitapahtuman.
- Oikeat tapahtumat eivät kuljeta koodia, joten ostosi eivät näy kohdassa **Test events**; tarkista tietojoukon **Overview**.

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

Käynnistä istunto **Livessä** ja selaa kauppaasi: jokainen Metan palvelinlähetys näyttää Metan vastauksen, **Hyväksytty**, **Hylätty** tai **Virhe**, HTTP-tilan kera. Vahvista sitten Events Managerissa, jossa [Meta sanoo](https://developers.facebook.com/documentation/ads-commerce/conversions-api/using-the-api) tapahtumien näkyvän 20 minuutin kuluessa.

1. Avaa cPixelissä **Live** ja napsauta **Aloita istunto**.
2. Katso toisessa välilehdessä tuote ja lisää se ostoskoriin.
3. Avaa **Palvelin**-rivi: kohdassa **Lähetetty** **Meta** näyttää **Hyväksytty**. Selainrivit eivät kuljeta vastausta.
4. Kohdassa **Kohteet** tili näyttää nyt **Vahvistettu**.
5. Events Managerissa tietojoukon **Overview** näyttää **Conversions API**:n Purchase-tapahtuman integraationa ja **Multiple** muille tapahtumille, mikä tarkoittaa selainta ja palvelinta.

Nähdäksesi oston, tee oikea tilaus: cPixel ohittaa testitilaukset oletuksena.

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

Jos Meta hylkää pääsytokenin virheellisenä tai vanhentuneena, cPixel merkitsee tilin **Token virheellinen**, pysäyttää sen palvelinlähetykset ja lähettää kriittisen hälytyksen kauppasi yhteystietosähköpostiin; **Etusivu** näyttää **Korjaa Meta**. Selainseuranta jatkuu.

1. Napsauta **Korjaa Meta** **Etusivulla**, tai **Hallinnoi** tilin vieressä kohdassa **Kohteet**.
2. [Luo uusi token](#how-do-i-get-a-conversions-api-access-token) ja liitä se kohtaan **Tallennettu — liitä uusi korvataksesi sen**.
3. Napsauta **Jatka**, sitten **Tallenna ja jatka**.

| Mitä näet | Mitä tehdä |
| --- | --- |
| **Generate access token** on harmaana | Hanki ylläpitäjän tai kehittäjän oikeudet tietojoukon yrityssalkkuun |
| **Testaa yhteys**: alusta hylkäsi tämän tokenin | Luo uusi token |
| **Testaa yhteys**: alusta kieltäytyi testitapahtumasta tälle tilille | Tunnus on väärä, tai token kuuluu toiselle tietojoukolle |
| **Meta rejected an event** **Etusivulla**, syynä käyttöoikeudet | Palauta järjestelmäkäyttäjän pääsy, tai luo uusi token |
| Osto näyttää **Ohitettu** Livessä | Lue sen syy, katso sitten [ostot eivät näy](/fi/docs/cpixel/purchases-missing/) |
| Ostot lasketaan kahdesti | Toinen työkalu lähettää tähän tietojoukkoon: [yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/) |

**Poista** kohdassa **Hallinnoi Meta-tiliä** pysäyttää lähetykset ja poistaa tallennetun tokenin; voit yhdistää uudelleen samalla tunnuksella. Metan oma opas: [Conversions API: aloittaminen](https://developers.facebook.com/documentation/ads-commerce/conversions-api/get-started).

## Katso myös {#related}

- [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/)
- [Ota Conversions API käyttöön Shopifyssa](/blog/shopify-conversions-api/)

[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-meta&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).