# Yhdistä OpenAI Ads (ChatGPT Ads) cPixeliin {#doc-title}

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

## Miten yhdistän OpenAI Adsin cPixeliin? {#how-do-i-connect-openai-ads-to-cpixel}

Avaa OpenAI Ads Managerissa Tools ja sitten Conversions: Pixel ID on painettu datalähteesi alle Data Source -välilehdellä, ja sivun otsikon avainkuvake luo Conversions API -avaimen, joka näytetään vain kerran. Liitä molemmat cPixeliin, joka lähettää sen jälkeen ostoskoritapahtumat ja ostot ChatGPT Adsille palvelimiltaan.

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

1. Avaa cPixelissä **Kohteet** ja napsauta OpenAI Ads -kuvaketta kohdassa **Yhdistä alusta**. **Määritä OpenAI Ads-tili** avautuu näkymään **Liitä tunnuksesi**.
2. Liitä **Pixel ID** ([mistä se löytyy](#where-do-i-find-my-openai-ads-pixel-id)) ja **Conversions API -avain** ([miten sellainen luodaan](#how-do-i-create-a-conversions-api-key)); molemmat vaaditaan. Nimeä tili kohdassa **Nimeä tämä tili (valinnainen)**, jos haluat.
3. Napsauta **Testaa yhteys**. OpenAI vahvistaa testitapahtuman tallentamatta sitä, joten **Tunnistetietosi tavoittavat tämän tilin** vahvistaa pääsyn, ei toimitusta.
4. Napsauta **Jatka**. Kohdassa **Valitse asetukset** pidä **Lähetä tapahtumat selaimesta** ja **Lähetä tapahtumat palvelimiltamme** valittuina, vastaa kysymykseen **Onko virallinen OpenAI Ads-sovellus myös asennettu?** (alla) ja napsauta **Tallenna ja jatka**. **Testaa** vahvistaa: **OpenAI Ads-tili on yhdistetty**.

> **Tärkeää:** OpenAI:n oma [ChatGPT Ads -sovellus Shopifylle](https://help.openai.com/en/articles/20001523-set-up-chatgpt-ads-for-shopify) lähettää myös kauppasi tapahtumat OpenAI-pikselille. Kaksi lähettäjää antaa yhdelle tilaukselle kaksi tapahtumatunnusta, ja OpenAI säilyttää molemmat. Anna kummallekin työkalulle oma Pixel ID, tai vastaa **Kyllä — pidä se, niin cPixel lopettaa OpenAI Ads:n lähettämisen palvelinpuolelta**, mikä nimestään huolimatta pysäyttää cPixelin selain- ja palvelinlähetykset kyseiselle pikselille ([yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/)).

## Mistä löydän OpenAI Ads -pixelini tunnuksen? {#where-do-i-find-my-openai-ads-pixel-id}

Avaa [OpenAI Ads Managerissa](https://ads.openai.com/) **Tools** → **Conversions**: **Data Source** -välilehdellä datalähteesi nimen alla oleva harmaa tunnus on Pixel ID, ei osoiterivillä näkyvä mainostilin tunnus.

1. Laajenna vasemmasta valikosta **Tools** ja valitse **Conversions**.
2. Kopioi **Data Source** -välilehdeltä harmaa tunnus, tai [luo datalähde](https://help.openai.com/en/articles/20001409-conversion-measurement), jos sinulla ei ole yhtään.

## Miten luon Conversions API -avaimen? {#how-do-i-create-a-conversions-api-key}

Napsauta avainkuvaketta **Warnings**-kohdan vieressä **Conversions**-sivulla, sitten **Create new key**. Kopioi avain, joka alkaa `sk-svcacct-`, heti: OpenAI näyttää sen vain kerran.

1. Napsauta **avainkuvaketta**. **Conversion keys** listaa avaimesi peitettyinä; OpenAI ei koskaan paljasta vanhaa uudelleen.
2. Napsauta **Create new key**, nimeä se ja kopioi avain kohdasta **Save your key** ennen sen sulkemista.
3. Liitä se cPixelin kenttään **Conversions API -avain**.

> **Vihje:** Avaimen poistaminen mitätöi sen heti, joten luo ja liitä uusi avain ennen kuin poistat vanhan.

## Estääkö “Ads cannot serve until you finish account setup” tämän? {#does-ads-cannot-serve-until-you-finish-account-setup-block-this}

Ei. Uudet tilit näyttävät sen, kunnes laskutus ja tilin logo on määritetty; se rajoittaa mainosten näyttämistä, ei Conversions API:a.

## Mitä cPixel lähettää ChatGPT Adsille? {#what-does-cpixel-send-to-chatgpt-ads}

Ostoskoritapahtumat ja ostot lähtevät aina cPixelin palvelimilta, muodossa checkout_started ja order_created, koska teema ei voi toimia Shopifyn kassalla tai kiitossivulla. Kun [app embed](/fi/docs/cpixel/getting-started/) on päällä, verkkokaupan tagi lisää sivunäytöt, tuotenäytöt ja ostoskoriin lisäykset (page_viewed, contents_viewed, items_added), joten millään tapahtumalla ei ole kahta lähettäjää.

- Jos ostajan selain ei voi ladata OpenAI:n tagia, cPixel lähettää sen verkkokauppatapahtuman palvelimiltaan avaimellasi, ei koskaan sellaista, jonka tagi on jo lähettänyt. Se ei voi nähdä OpenAI:n hylkäävän selaintapahtumaa.
- Yhtään maksutietotapahtumaa ei saavuta OpenAI:ta.
- Palvelinlähetykset kuljettavat tiivistettyä sähköpostia, puhelinnumeroa, asiakas- ja laitetunnuksia, `oppref`- ja `obref`-tunnisteita, IP-osoitteen ja käyttäjäagentin. OpenAI Ads tarvitsee markkinointisuostumuksen; cPixel ei koskaan lähetä nimiä tai postiosoitteita.
- OpenAI [deduplikoi](https://developers.openai.com/ads/conversions-api) Pixel ID:n, tapahtuman nimen ja tapahtumatunnuksen perusteella, säilyttäen ensimmäisen kopion, ja hyväksyy jopa 7 päivää vanhoja tapahtumia.

OpenAI Ads Manager [pisteyttää jokaisen datalähteen tapahtumien laadun](https://help.openai.com/en/articles/20001513-understand-and-improve-event-quality) päivittäin. cPixelin **Tapahtumien laatu** -sivu ei lue tätä pistemäärää, ja sen huomautus, ettei OpenAI julkaise mitään, on vanhentunut.

## Mikä on oppref, ja lähettääkö cPixel sen? {#what-is-oppref-and-does-cpixel-send-it}

oppref on klikkausviite, jonka OpenAI lisää laskeutumissivusi osoitteeseen, kun joku klikkaa ChatGPT-mainosta. OpenAI [käyttää sitä](https://help.openai.com/en/articles/20001409-conversion-measurement) yhdistämään konversion klikkaukseen, tiivistetyt yhteystiedot varajärjestelmänä. cPixel lähettää sen palvelintapahtumiensa mukana aina kun sillä on sellainen.

- cPixel lukee sen osoitteesta ja, app embedin ollessa päällä, `__oppref`-evästeestä, jonka OpenAI:n tagi säilyttää verkkotunnuksellasi ja joka säilyy siirryttäessä `www`:n ja paljaan verkkotunnuksen välillä.
- OpenAI:n tagi [säilyttää tämän evästeen 30 päivää](https://developers.openai.com/ads/measurement-pixel), käynnistäen laskennan uudelleen aina kun oppref ilmestyy osoitteeseen uudelleen.
- OpenAI pyytää säilyttämään oppref-tiedon uudelleenohjausten läpi: sellainen, joka poistaa kyselyparametrit, menettää sen.

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

Käynnistä istunto **Livessä** ja tee oikea tilaus: oston **Palvelin**-rivi näyttää OpenAI:n vastauksen, **Hyväksytty**, **Hylätty** tai **Virhe**, HTTP-tilan kera. Tarkista sitten **Event Stream** -välilehti Ads Managerissa.

1. Avaa cPixelissä **Live** ja napsauta **Aloita istunto**.
2. Tee toisessa välilehdessä oikea tilaus; cPixel ohittaa testitilaukset oletuksena.
3. Avaa oston **Palvelin**-rivi: **OpenAI Ads** näyttää **Hyväksytty**. Verkkokauppatapahtumat näkyvät **Selain**-riveinä, ilman vastausta.
4. Avaa Ads Managerissa **Tools** → **Conversions**, sitten **Event Stream** -välilehti. Verkkokauppatapahtumat saapuvat sinnekin, ei koskaan kassasivuilta.

**Kohteet** merkitsee tilin **Vahvistettu** ensimmäisen hyväksytyn palvelinlähetyksen jälkeen. Attribuoidut konversiot saapuvat OpenAI:n raportteihin [24–48 tunnissa](https://help.openai.com/en/articles/20001214-measure-results).

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

Jos OpenAI hylkää avaimen, cPixel merkitsee tilin **Token virheellinen**, pysäyttää sen palvelinlähetykset ja lähettää kriittisen hälytyksen kauppasi yhteystietosähköpostiin; **Etusivu** näyttää **Korjaa OpenAI**.

1. [Luo uusi avain](#how-do-i-create-a-conversions-api-key).
2. Napsauta **Korjaa OpenAI** **Etusivulla**, tai **Hallinnoi** tilin vieressä kohdassa **Kohteet**, ja liitä se kohtaan **Tallennettu — liitä uusi korvataksesi sen**. **Testaa yhteys** tarkistaa sen.
3. Napsauta **Jatka**, sitten **Tallenna ja jatka**.

| Mitä näet | Mitä tehdä |
| --- | --- |
| **Testaa yhteys**: alusta hylkäsi tämän tokenin | Avain poistettiin tai kirjoitettiin väärin: luo uusi |
| Konversiot näyttävät 0 Ads Managerissa | Kampanjan konversiotavoitteen on vastattava lähetettyä tapahtumaa, order_created ostoille ([OpenAI](https://help.openai.com/en/articles/20001214-measure-results)) |
| Ostot lasketaan kahdesti | Toinen työkalu lähettää tähän Pixel ID:hen: [yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/) |
| Osto näyttää **Ohitettu** Livessä | Lue sen syy, katso sitten [ostot eivät näy](/fi/docs/cpixel/purchases-missing/) |

**Poista** kohdassa **Hallinnoi OpenAI Ads-tiliä** pysäyttää lähetykset ja poistaa tallennetun avaimen. OpenAI:n oma dokumentaatio: [Conversions API](https://developers.openai.com/ads/conversions-api).

## Katso myös {#related}

- [Seuraa ChatGPT Adsin konversioita Shopifyssa](/blog/chatgpt-ads-conversion-tracking-shopify/)
- [Katso jokainen lähetys Livessä](/fi/docs/cpixel/live-events/)
- [Yksi lähettäjä per pikseli](/fi/docs/cpixel/official-channel-apps/)
- [Mitä cPixel lähettää, ja miten suostumus muuttaa sitä](/fi/docs/cpixel/event-quality-and-consent/)

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