# Yhdistä Pinterest Tag ja Conversions API cPixeliin {#doc-title}

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

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

Pinterest tarvitsee kolme arvoa cPixelissä: Tag ID, kohdasta Conversions, Pinterest tag, Tag manager Pinterest Ads Managerissa; mainostilisi tunnus, Ads Managerin osoiterivillä; ja Conversions API -pääsytoken, kohdasta Conversions API, Set up API. cPixel laukaisee Pinterest-tagin Shopify-verkkokaupassasi ja lähettää ostoskoritapahtumat ja ostot palvelimiltaan.

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

1. Avaa cPixelissä **Kohteet** ja napsauta Pinterest-kuvaketta kohdassa **Yhdistä alusta**. **Määritä Pinterest-tili** avautuu näkymään **Liitä tunnuksesi**.
2. Täytä **Tagitunnus**, **Mainostilin tunnus** ja **Conversions API -pääsytoken**, kaikki pakollisia. Harmaa vihje niiden yläpuolella, joka sanoo ettei ostoja seurata, on peräisin ajalta ennen cPixelin Pinterest-palvelinyhteyttä. Nimeä tili kohdassa **Nimeä tämä tili (valinnainen)**, jos haluat.
3. Napsauta **Testaa yhteys**: se lukee mainostilisi tokenilla, vahvistaen pääsyn, ei toimitusta.
4. Napsauta **Jatka**. Kohdassa **Valitse asetukset** pidä **Lähetä tapahtumat selaimesta** ja **Lähetä tapahtumat palvelimiltamme** valittuina. Pidä **Ei — cPixel hoitaa Pinterest:n (suositeltu)** valittuna, ellei toinen työkalu lähetä tähän tagiin: nimestään huolimatta **Kyllä — pidä se, niin cPixel lopettaa Pinterest:n lähettämisen palvelinpuolelta** pysäyttää cPixelin selain- ja palvelinlähetykset sille.
5. Napsauta **Tallenna ja jatka**. **Testaa** vahvistaa: **Pinterest-tili on yhdistetty**.

> **Tärkeää:** Pinterestin oma Shopify-sovellus asentaa myös tagin ja Conversions API:n ([Pinterest](https://help.pinterest.com/en/business/article/link-your-shopify-and-pinterest-accounts)), joten pidä [yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/).

## Mistä löydän Pinterest Tag ID:ni? {#where-do-i-find-my-pinterest-tag-id}

Pinterestin **Connect a data source** -sivun oikeassa yläkulmassa: noin 13 numeroa, näkyy ennen kuin täytät mitään.

1. Napsauta [Pinterest Ads Managerissa](https://ads.pinterest.com/) valikkokuvaketta **Campaign manager** -kohdan vieressä vasemmassa yläkulmassa, sitten **Conversions** kohdassa **Manage business**.
2. Avaa vasemmasta palkista **Pinterest tag** → **Tag manager**.
3. Ilman tagia Tag manager näyttää mainospaneelin. Napsauta **Install the Pinterest tag**; se ei sido sinua mihinkään.
4. Kopioi **Connect a data source** -sivulla **Tag ID** oikeasta yläkulmasta cPixeliin, sulje sitten sivu, sillä cPixelin app embed asentaa tagin.

> **Vihje:** Tag manager listaa tagin vasta kun tapahtumia saapuu, joten sen mainospaneeli voi jäädä näkyviin; **Install the Pinterest tag** näyttää silti Tag ID:si.

## Mikä numero on mainostilini tunnus? {#which-number-is-my-ad-account-id}

Numero, jonka Pinterest näyttää Conversions API -tokenisi vieressä sitä luodessasi. Se on myös Ads Managerin osoiterivillä ja mainostilisi nimen alla [Business Managerissa](https://help.pinterest.com/en/business/article/business-manager-partner-access).

> **Tärkeää:** Kolme Pinterest-numeroa näyttävät samalta. **Tag ID**, noin 13 numeroa, on se, jolla verkkokauppatagi laukeaa; **mainostilin tunnus** on se, minne cPixelin palvelinlähetykset menevät; **Pin ID**, noin 18 numeroa Pinin osoitteen lopussa, tunnistaa kuvan eikä koskaan tallenna konversiota.

cPixel hylkää Tag ID:n **Mainostilin tunnus** -kentässä (“Tuo on yllä antamasi tagin tunnus…”).

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

Luo se kohdassa **Conversions** → **Conversions API** → **Set up API** Pinterest Ads Managerissa. Se on pakollinen: cPixelin palvelimet lähettävät ostoskoritapahtumat ja ostot sillä.

1. Avaa **Conversions**-sivulla **Conversions API** → **Set up API**.
2. Valitse **Conversion access token** ja napsauta **Generate new token**.
3. Kopioi token heti cPixeliin. Pinterest näyttää mainostilisi tunnuksen sen vieressä.

Yksi token kattaa useita mainostilejä saman Pinterest-käyttäjän alla ([Pinterest](https://developers.pinterest.com/docs/api/v5/events-create/)). cPixel tallentaa sen eikä näytä sitä enää uudelleen.

## Mitä cPixel lähettää Pinterestille? {#what-does-cpixel-send-to-pinterest}

Verkkokauppatapahtumat Pinterest-tagilta, jonka cPixelin app embed lataa, ja ostoskoritapahtumat sekä ostot cPixelin palvelimilta Conversions API:n kautta; jokainen tapahtuma kulkee vain yhteen suuntaan.

- **Sivukäynnit ja ostoskoriin lisäykset** tulevat tagilta, vain kun app embed on päällä. Jos selain estää tagin, cPixel lähettää sen tapahtuman palvelimiltaan.
- **Ostoskoritapahtumat ja ostot** tulevat cPixelin palvelimilta muodossa `initiate_checkout` ja `checkout`, Pinterestin ostotapahtuma, rakennettuna uudelleen Shopify-tilauksesta, koska mikään teemakoodi ei toimi kassalla tai kiitossivulla.

Palvelintapahtumat kuljettavat tiivistettyä sähköpostia, puhelinta ja Shopify-asiakastunnusta, kun ne tunnetaan, sekä IP-osoitteen ja käyttäjäagentin; Pinterestin klikkaustunnusta ei tallenneta. Pinterest säilyttää ensimmäisen tapahtuman per tapahtumatunnus 48 tunnin ajan ([Pinterest](https://developers.pinterest.com/docs/track-conversions/track-conversions-in-the-api/)) ja pisteyttää datasi kohdassa **Conversions** → **Event quality** ([Pinterest](https://help.pinterest.com/en/business/article/eqs)), pistemäärän jota cPixel ei lue.

> **Huom:** cPixelin Pinterest-palvelinyhteys on uusi: tuotannossa syyskuusta 2026 alkaen, eikä sitä ole vielä vahvistettu oikealla mainostilillä. Tarkista ensimmäinen ostoskoritapahtumasi ja ostosi Livessä.

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

Seuraa ostoskoritapahtumaa ja ostoa cPixelin Livessä, jossa palvelinlähetykset näyttävät Pinterestin vastauksen, vahvista sitten Pinterest Ads Managerissa.

1. Avaa cPixelissä **Live** ja napsauta **Aloita istunto**.
2. Selaa kauppaasi toisessa välilehdessä ja lisää ostoskoriin. **Selain**-rivit listaavat Pinterestin **Lähetetty selaimesta**, ilman vastausta: alustat eivät vastaa selainlähetyksiin.
3. Aloita kassalla ja tee oikea tilaus; cPixel ohittaa testitilaukset oletuksena. Niiden **Palvelin**-rivien pitäisi näyttää Pinterest **Hyväksytty**.
4. Avaa Pinterestissä **Conversions** → **Events overview**; uuden tagin näkyminen voi kestää jopa [24 tuntia](https://help.pinterest.com/en/business/article/install-the-pinterest-tag).

**Kohteet** merkitsee tilin **Vahvistettu** ensimmäisen hyväksytyn palvelinlähetyksen jälkeen, yleensä ensimmäisen ostoskoritapahtuman. Pinterestin **Test events** -sivu ja Tag Helper -laajennus tarkistavat vain tagin ([Pinterest](https://help.pinterest.com/en/business/article/verify-the-pinterest-tag)). Pinterestin oma opas: [Seuraa konversioita Pinterest-tagilla](https://help.pinterest.com/en/business/article/track-conversions-with-pinterest-tag).

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

Jos Pinterest ei vastaanota cPixelin tapahtumia, avaa Pinterest-rivi Livessä: lähetys, joka ei ole **Hyväksytty**, nimeää syynsä.

| Mitä näet | Mitä tehdä |
| --- | --- |
| **Testaa yhteys** epäonnistuu | Mainostilin tunnus on todennäköisesti Tag ID, tai tokenin käyttäjä ei pääse siihen tiliin |
| **Hylätty** tai **Virhe** | Lue Pinterestin vastaus rivin tiedoista; cPixel yrittää virheitä uudelleen itse |
| **Korjaa Pinterest** **Etusivulla**: token hylättiin, palvelinlähetykset pysähtyivät ja kriittinen hälytys [lähetettiin sähköpostitse](/fi/docs/cpixel/alerts-and-reconciliation/) | Luo uusi token, napsauta **Korjaa Pinterest**, tai **Hallinnoi** tilin vieressä kohdassa **Kohteet**, liitä se ja tallenna |
| Yksikään **Selain**-rivi ei nimeä Pinterestiä | App embed on pois päältä (**Selain**-merkki näyttää **Vaatii sovelluksen upotuksen**): kytke **cPixel-seuranta** päälle ja tallenna teemasi, uudelleen teemaa vaihdettuasi |
| Osto puuttuu tai on **Ohitettu** | Lue sen syy, katso sitten [ostot eivät näy](/fi/docs/cpixel/purchases-missing/) |
| Ostot lasketaan kahdesti | Toinen työkalu, kuten Pinterestin sovellus tai tagi teemassasi, lähettää tähän tagiin |

**Poista**, kohdassa **Hallinnoi Pinterest-tiliä**, pysäyttää lähetykset kyseiselle tilille ja poistaa sen tokenin.

## Katso myös {#related}

- [Ota app embed käyttöön](/fi/docs/cpixel/getting-started/)
- [Katso jokainen lähetys Livessä](/fi/docs/cpixel/live-events/)
- [Yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/)

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