ChatGPT Ads Pixel Google Tag Manageris: GTM juhend

ChatGPT Ads Pixeli GTM-seadistuse lühivastus

Loo Google Tag Manageris vähemalt kaks kihti: kogu veebis töötav OpenAI Pixeli baasmärgend ja ärilise tegevuse järel käivituv sündmusemärgend. Baasmärgend laadib OpenAI brauseri SDK, määrab nõusoleku enne init-käsku ja kasutab Ads Managerist saadud Pixel ID-d. Sündmusemärgend kutsub alles kinnitatud tegevuse järel välja oaiq("measure", ...).

OpenAI ametlik dokumentatsioon kirjeldab Pixeli JavaScripti, nõusoleku, sündmuste, debug-režiimi ja Conversions API loogikat, kuid ei anna Google Tag Manageri jaoks eraldi ametlikku samm-sammult retsepti. Selles juhendis toodud GTM-struktuur on Kala Ruudu praktiline teostusmuster, mis kasutab dokumenteeritud OpenAI käske.

Ära pane Conversions API võtit GTM-i ega veebilehe JavaScripti. Pixel ID ei ole sama mis salajane API võti. Serveripoolne võti kuulub ainult serveri saladuste hoidlasse.

Mida on enne Google Tag Manageri avamist vaja?

Alusta Ads Manageri Conversions jaotisest veebipõhise andmeallika ning Pixel ID-ga. OpenAI eristab andmeallika id-väärtust ja pixel_id-väärtust: brauseri Pixeli algväärtustamiseks kasutatakse Pixel ID-d, konversioonisündmuse seadistuse loomisel viidatakse andmeallika ID-le. Ära kopeeri juhuslikult esimest sarnast tunnust.

Pane enne tehnilist tööd kirja üks põhisündmus. Teenuseäris võib see olla lead_created või appointment_scheduled, e-poes order_created, tarkvaras trial_started või subscription_created. Vali sündmus selle järgi, mis tõendab päris ärilist sammu, mitte selle järgi, millist nuppu on kõige lihtsam mõõta.

Sul peab olema avaldamisõigus GTM-i konteineris, töötav nõusolekuhaldus, testkeskkond või kontrollitud testvoog ning ligipääs Ads Manageri sündmuste kontrollile. Kui vorm või ost toimub teisel domeenil, kaardista enne ka suunamised, UTM-id ja oppref-i säilimine.

Ads Managerist õige veebiallika Pixel ID
üks täpselt defineeritud põhisündmus ja selle käivitustingimus
GTM-i konteineri muutmis- ning avaldamisõigus
CMP või muu nõusolekuhaldus koos testitava olekuga
testvorm, testtellimus või muu turvaline konversioonitee
Ads Manageri hiljutiste sündmuste vaade või arendaja ligipääs kontrollpäringule

Soovituslik märgendite arhitektuur

Üks hiiglaslik Custom HTML märgend on kiire demo, kuid halb püsilahendus. Hoia Pixeli laadimine, nõusoleku uuendus ja ärisündmused eraldi. Nii näed GTM-i eelvaates, milline kiht käivitus, ning saad sündmust parandada baaskoodi puudutamata.

Minimaalne struktuur sisaldab OpenAI Pixel – Base märgendit, OpenAI Pixel – Consent Granted märgendit ja iga olulise tulemuse jaoks eraldi sündmusemärgendit. Näiteks OpenAI Pixel – Lead Created ja OpenAI Pixel – Order Created. Muutujates hoia Pixel ID, valuuta, tellimuse väärtus ning sündmuse ID.

Nimeta märgendid, päästikud ja muutujad ühe kokkuleppe järgi. Hea nimi ütleb platvormi, funktsiooni ja sündmuse. Väldi nimetusi nagu “HTML 7” või “uus conversion”, sest veaotsingul ei ütle need midagi.

OpenAI Pixel – Base: loob oaiq järjekorra, määrab nõusoleku ja algväärtustab Pixeli
OpenAI Pixel – Consent Granted: muudab Pixeli nõusoleku true-olekusse
OpenAI Pixel – Lead Created: saadab kinnitatud müügivihje
OpenAI Pixel – Order Created: saadab kinnitatud ostu koos väärtuse ning valuutaga
OpenAI Pixel ID: konstantne GTM-i muutuja, mitte API võti
OpenAI Event ID: iga päris tegevuse kordumatu tunnus deduplitseerimiseks

1. Loo Pixeli baasmärgend

OpenAI ametlik paigalduskood loob window.oaiq järjekorra, laadib asünkroonselt faili https://bzrcdn.openai.com/sdk/oaiq.min.js ja käivitab init-käsu Pixel ID-ga. GTM-is saab sama koodi lisada Custom HTML märgendina. Asenda näidisväärtus GTM-i muutujaga, mitte käsitsi mitmes märgendis.

Baaskoodi loogiline järjestus on: loo oaiq järjekord, kutsu oaiq("consent", false), kutsu oaiq("init", { pixelId: "{{OpenAI Pixel ID}}", debug: true }) ning laadi SDK. Nõusoleku käsk peab ametliku juhendi järgi olema enne algväärtustamist. Debug jäta sisse ainult testi ajaks.

Avalda baasmärgend kõigil lehtedel, kus soovid hilisemaid konversioone mõõta. OpenAI soovitab paigalduskoodi lehe head-osas varakult laadida, et varased tegevused ei läheks kaotsi. GTM-is tähendab see, et baasmärgend peab käivituma enne sündmusemärgendeid.

2. Seo Pixel nõusolekuhaldusega

OpenAI Pixel eeldab vaikimisi consent=true olekut, kui sa ei määra enne init-käsku false-väärtust ega Pixel leia salvestatud keeldumist. Seetõttu ei piisa sellest, et GTM-i märgend lihtsalt “ootab bännerit”. Baasmärgend peab saatma dokumenteeritud consent-käsu õiges järjekorras.

Praktiline GTM-muster on algväärtustada Pixel consent=false olekus ja saata oaiq("consent", true) ainult siis, kui sinu CMP kinnitab vastava mõõtmis- või reklaaminõusoleku. Tagasivõtmisel saada uuesti false. Millise nõusolekukategooriaga Pixel siduda, otsusta oma andmekaitseanalüüsi ja CMP seadistuse põhjal.

OpenAI dokumentatsiooni järgi ei saada Pixel false-olekus mõõtmissündmuste päringuid. Hiljem true-olekusse lülitamine lubab tulevased sündmused, kuid blokeeritud sündmusi tagantjärele ei korrata. Testi seetõttu värske lehevaatamisega nii nõustumist, keeldumist kui ka tagasivõtmist.

3. Loo müügivihje sündmusemärgend

Müügivihje jaoks kasuta toetatud standardset sündmust lead_created, kui kasutaja on päriselt esitanud kontaktisoovi. Event data objekti type peab olema customer_action. Kõne kuju on oaiq("measure", "lead_created", { type: "customer_action" }, { event_id: "{{Lead ID}}" }).

Päästik ei tohiks olla lihtsalt vorminupu klikk. Klikk võib toimuda ka vigase vormi, katkise võrgu või serverivea korral. Parem signaal on rakenduse andmekihi sündmus, edukalt kinnitatud vormivastus või unikaalne tänulehe olek, mis tekib ainult pärast salvestatud päringut.

event_id peab viitama ühele päris tegevusele. Kui vormirakendus annab kontaktile või päringule ID, kasuta seda. Kui saadad sama lead_created sündmuse ka Conversions API kaudu, peab serveri id ja Pixeli event_id olema sama, et OpenAI saaks duplikaadi ära tunda.

4. Loo ostusündmus õigete ühikute ja väljadega

Ostu standardne sündmus on order_created ning data type on contents. Näiteks 79,90 euro väärtus saadetakse kujul amount: 7990 ja currency: "EUR". OpenAI kasutab valuuta standardset väikseimat ühikut; summa peab olema täisarv, mitte 79.90 stringina.

Praktiline kõne on oaiq("measure", "order_created", { type: "contents", amount: {{Order Value Minor Units}}, currency: "EUR" }, { event_id: "{{Order ID}}" }). Kui lisad contents massiivi, kasuta ainult OpenAI dokumenteeritud välju. Ära saada GTM-i kaudu rohkem kliendi- ega tooteandmeid, kui mõõtmise eesmärk vajab.

Käivita ost alles makse või tellimuse kinnitatud oleku järel. Tänulehe laadimine võib korduda värskendamisel, brauseri tagasi-liikumisel või bookmark’i kaudu. Püsiv Order ID event_id-na aitab sama sündmust Pixeli ja serveri vahel deduplitseerida, kuid GTM-is tasub ka korduskäivitus tehniliselt ära hoida.

Milliseid sündmusi OpenAI Pixel toetab?

OpenAI ametlik standardnimekiri sisaldab veebis muu hulgas page_viewed, contents_viewed, items_added, checkout_started, lead_created, appointment_scheduled, order_created, registration_completed, subscription_created ja trial_started. Kasuta standardset sündmust alati, kui see kirjeldab tegevust õigesti.

Kohandatud sündmus kasutab teise argumendina väärtust custom, data type väärtust custom ning options objektis custom_event_name välja. Nimi peab olema 1–64 märki, algama ja lõppema tähe või numbriga ning sisaldama ainult tähti, numbreid, alakriipse või sidekriipse. Järjepidevuse jaoks soovitab OpenAI väiketähti.

app_installed ja app_opened ei ole praegu JavaScripti Pixeli sündmused. Need saadetakse serverist Conversions API kaudu. Ära ehita GTM-i veebikonteinerisse märgendit, mida brauseri SDK ei toeta.

Käivitusjärjekord: miks sündmus vahel “kaob”?

Kõige tavalisem GTM-i viga on see, et lead_created või order_created käivitub enne Pixeli baasmärgendit. Kui oaiq järjekorda pole loodud, annab brauser vea või kaob sündmus. Kui nõusoleku olek pole veel määratud, võib mõõtmine käituda teisiti kui kavatsesid.

Kasuta GTM-i tag sequencing loogikat või eraldi andmekihi sündmust, mis tekib alles pärast baasmärgendi valmisolekut. Eelvaates peab järjekord olema nähtav: consent default, Pixeli base/init, nõusoleku uuendus ning alles siis ärisündmus.

Ära lahenda järjestust pika juhusliku viivitusega. Taimer võib aeglases seadmes olla liiga lühike ja kiires seadmes asjatult pikk. Seo käivitus tehnilise valmisoleku või deterministliku sündmusega.

Pixel, Conversions API või mõlemad?

Google Tag Manageri veebikonteiner saadab brauseripõhiseid Pixeli sündmusi. Serveris kinnitatud tellimus või CRM-i müügivihje sobib Conversions API-le. OpenAI kirjeldab serveripoolset API-t Pixelist töökindlama allikana ning soovitab võimaluse korral kasutada seda täpsema mõõtmise jaoks.

Mõlemat kasutades peab sama konversioon kasutama sama Pixel ID-d, sündmuse nime ja sündmuse ID-d. Pixeli event_id ning serveri id peavad olema üks ja sama väärtus. OpenAI kasutab deduplitseerimisel Pixel ID, event name ja ID kombinatsiooni ning arvestab sobiva võtme esimesena saabunud sündmust.

Serveri API võti ei tohi kunagi jõuda GTM-i veebikonteinerisse, dataLayer’isse, brauserisse ega lehe lähtekoodi. Kui kasutad server-side GTM-i, peab saladus paiknema serverikeskkonna turvalises hoidlas ning veebileht ei tohi seda kliendile avaldada.

oppref, UTM-id ja GTM

OpenAI Pixel püüab reklaamiklikiga saabunud oppref väärtuse URL-ist ja salvestab selle nõusoleku korral esimese osapoole __oppref küpsisesse. GTM-i sündmusemärgend ei pea oppref-i käsitsi Pixeli measure-käsule lisama. Serverisündmuse jaoks peab rakendus algse väärtuse ise säilitama, sest Conversions API seda automaatselt ei püüa.

UTM-parameetrid täidavad teist ülesannet: need aitavad GA4-s ja CRM-is eristada tasulist kampaanialiiklust. Hoia UTM-id ning oppref läbi suunamiste alles, kuid ära aja neid omavahel segi. UTM ei asenda OpenAI kliki viidet ja oppref ei anna GA4-le automaatselt sinu kampaaniataksonoomiat.

Kui sihtleht suunab teise domeeni või eemaldab päringustringi, testi kogu ahelat päris testlingiga. GTM saab mõõta ainult lehel, kuhu konteiner ja vajalikud parameetrid tegelikult jõuavad.

Content Security Policy võib Pixeli blokeerida

Kui veeb kasutab ranget Content Security Policyt, ei piisa GTM-i märgendi edukast käivitumisest. OpenAI dokumentatsiooni järgi peab script-src lubama https://bzrcdn.openai.com, connect-src https://bzr.openai.com ja https://bzrcdn.openai.com ning image fallback’i jaoks img-src https://bzr.openai.com.

Ära lisa CSP-sse unsafe-inline väärtust ainult Pixeli pärast. OpenAI ametlik näide kasutab nonce’i või olemasolevat hash-põhist lahendust. GTM-i Custom HTML ja nonce’i koostoime sõltub veebirakendusest ning vajab arendaja kontrolli.

Brauseri konsooli CSP vead on otsene signaal, et märgend käivitus GTM-is, kuid SDK või sündmusepäring blokeeriti turvapoliitika tasemel.

Kuidas GTM-i eelvaates ja brauseris testida?

Ava GTM Preview ning tee üks puhas test iga nõusoleku- ja konversioonitee jaoks. Vaata, millise sündmuse juures base, consent ja conversion märgendid käivitusid. Kontrolli ka fired once per page või once per event seadistust vastavalt eesmärgile.

Hoia OpenAI init-objektis testimise ajal debug: true. Ametliku juhendi järgi logib see SDK tegevuse brauseri konsooli. Network-vaates otsi ühendusi bzr.openai.com domeenile ning kinnita, et keeldumise korral mõõtmissündmuse päringut ei teki.

Kontrolli eraldi värsket lehevaatamist, edukat vormi, vigast vormi, lehe värskendamist, topeltklikki, ostu kordusavamist ja nõusoleku tagasivõtmist. Üks edukas testjuhtum ei kata kõige tavalisemaid duplikaate.

Kuidas kontrollida sündmust Ads Manageris?

OpenAI conversion tracking juhend kirjeldab hiljutiste sündmuste kontrolli, mis näitab ligikaudu viimase 15 minuti sündmuste valimit. Veendu, et sündmuse type, allikas ja kanal vastavad testile. Brauserisündmuse kanal on pixel_sdk, serverisündmusel server_to_server.

Hiljutiste sündmuste vaade on integratsiooni testimiseks, mitte ajalooliseks tulemusraportiks. Omistatud konversioonide ja kampaaniatulemuse hindamiseks kasuta Insightsi. Tehniliselt vastu võetud sündmus ei tõesta veel, et see on õige sündmuse seadistusega kampaaniale seotud.

Kui sündmus saabub, loo või kontrolli konversioonisündmuse seadistus ja seo see õige kampaaniaga. OpenAI rõhutab, et event setting valib andmeallikast sündmuse; see ei saada sündmust ise.

Kümme avaldamiseelset kontrolli

Avalda GTM-i konteiner alles siis, kui nii nõusoleku- kui konversiooniteekond on tõendatud. Salvesta testkuupäev, konteineri versioon, testtellimus või lead ID ja tulemus.

Pixel ID pärineb õigest Ads Manageri kontost ja veebiallikast
oaiq consent=false käivitub enne init-käsku
nõusoleku true- ja false-uuendused töötavad CMP tegeliku oleku järgi
baasmärgend käivitub enne kõiki measure-märgendeid
lead käivitub ainult serveris kinnitatud vormi järel, mitte pelgal klikil
ostusumma on täisarvuna valuuta väikseimas ühikus ja currency on kaasas
event_id on ühe tegevuse kordumatu püsiv ID
Pixel ja Conversions API kasutavad sama sündmuse jaoks sama ID-d
keeldumise korral ei teki mõõtmissündmuse päringut ega Pixeli küpsiseid
sündmus on nähtav OpenAI hiljutiste sündmuste kontrollis õige kanaliga

Levinud vead ja nende diagnoos

Kui konsool ütleb, et oaiq ei ole defineeritud, käivitus sündmus enne baasmärgendit või base ei laadinud. Kui GTM näitab fired, kuid võrgupäringut ei ole, kontrolli nõusolekut, CSP-d, brauserilaiendeid ja seda, kas sündmus üldse pidi false-olekus saatma.

Kui sama ost ilmub mitu korda, kontrolli tänulehe korduslaadimist, GTM-i triggerit ning Pixeli ja serveri event ID vastavust. Kui sündmus saabub OpenAI vaatesse, kuid kampaaniaraportis ei kajastu, kontrolli event settingut, kampaaniaga sidumist, sündmuse nime ja atribuutimise tingimusi.

Kui GTM-is on korraga Custom HTML, WordPressi plugin ja arendaja otse lehele lisatud Pixel, eemalda dubleeriv paigaldus. Üks kontrollitud baaskood ja dokumenteeritud sündmuseomanik on turvalisem kui kolm osaliselt kattuvat lahendust.

Kala Ruudus seadistab Pixeli koos päris müügiloogikaga

Kala Ruudus aitab valida õige ChatGPT Ads konversiooni, ehitada GTM-i märgendid, siduda nõusoleku, säilitada UTM-id ja oppref-i ning testida sündmuse brauserist Ads Manageri ja CRM-ini. Vajaduse korral kaasame arenduse Conversions API või keeruka domeenidevahelise teekonna jaoks.

Tulemuseks on avaldatud GTM-i versioon, märgendite ja muutujate nimekiri, sündmuste andmesõnastik, testprotokoll ning selge vastutus. Kampaania käivitub alles pärast seda, kui põhisündmus on kontrollitud ja duplikaadi risk lahendatud.

Saada meile veebiaadress, kasutatav vormi- või e-poeplatvorm, GTM-i ja CMP lahendus ning kirjeldus tegevusest, mida pead heaks tulemuseks. Vastame, kas piisab Pixelist, millal on vaja Conversions API-t ja milline seadistusplaan sobib sinu veebile.

Korduma kippuvad küsimused

Kas ChatGPT Ads Pixelil on Google Tag Manageri ametlik mall?

OpenAI ametlik arendajadokumentatsioon kirjeldab JavaScripti paigalduskoodi, nõusolekut ja sündmusi, kuid ei anna eraldi GTM-i samm-sammult juhendit. Pixeli saab GTM-is teostada Custom HTML märgenditega, järgides dokumenteeritud oaiq käske ja õiget käivitusjärjekorda.

Kas OpenAI Conversions API võtme võib lisada GTM-i?

Ei. Conversions API võti peab jääma serveri turvalisse saladuste hoidlasse. Veebikonteineris kasutatakse Pixel ID-d; salajast API võtit ei tohi panna JavaScripti, dataLayer’isse ega lehe lähtekoodi.

Millal peab ChatGPT Ads Pixel GTM-is käivituma?

Baasmärgend peab looma oaiq järjekorra, määrama nõusoleku enne init-käsku ja käivituma enne sündmusemärgendeid. Konversioonisündmus käivitub alles pärast kinnitatud tegevust ning sobiva nõusoleku korral.

Milline sündmus sobib kontaktivormile?

Kinnitatud kontaktisoovile sobib tavaliselt lead_created data type väärtusega customer_action. Ära käivita seda pelgalt nupuklikil; eelista edukat serverivastust, andmekihi kinnitust või ainult pärast salvestamist avanevat tänuolekut.

Kuidas vältida Pixeli ja Conversions API topeltkonversiooni?

Saada sama tegevus sama Pixel ID, sündmuse nime ja sündmuse ID-ga. Pixeli event_id ja Conversions API id peavad kattuma, et OpenAI saaks duplikaadi tuvastada.

Kuidas kontrollida, kas OpenAI Pixel töötab?

Kasuta GTM Preview’d, Pixeli debug-režiimi, brauseri konsooli ja Network-vaadet ning kontrolli sündmust Ads Manageri hiljutiste sündmuste vaates. Testi eraldi nõustumist, keeldumist, edukat konversiooni ja korduskäivituse vältimist.

Loe edasi

Kontrollitud allikad

Artikli tootefaktid kontrolliti 30. septembril 2026.

Oluline

Platvormi võimalused, saadavus ja hinnastus võivad muutuda. Kontrollime kampaania planeerimisel alati konto hetkeolukorda ning OpenAI ametlikku dokumentatsiooni.

ChatGPT Ads Pixel Google Tag Manageris: GTM seadistus samm-sammult