Конверсия APIлары
Максаттарыңызды браузерден эмес, серверибизден Meta, LinkedIn, TikTok жана Google Ads платформаларына билдирип, тармак өзү койгон чыкылдатуу идентификатору аркылуу гана дал келтириңиз.
1. Эмне үчүн сервер тарап керек?
Браузердин пиксели конверсияны билдиргенге чейин үч тоскоолдуктан өтүшү керек: жарнама бөгөттөгүч, көзөмөлдөөнү алдын алуу жөндөөсү жана пиксель иштегенге чейин коноктун өтмөктү жабышы. Сервердик чакыруу үчөөнөн тең өтөт, анткени ал браузерде таптакыр аткарылбайт.
MousePlayer максаттарыңыздын бири качан аткарылганын билет — максаттар ошол үчүн бар. Конверсия APIлары ошол фактыны серверибизден жарнама тармагына гана өткөрөт.
Бул пикселиңизди алмаштырбайт. Аны калтырыңыз. Ар бир тармак экөөнүн ортосунда кайталанууларды жоёт жана биз ага керектүү идентификаторлорду жөнөтөбүз.
2. Эмнени жөнөтөбүз жана эмнени эч качан жөнөтпөйбүз
Бул чакырууларда конокту аныктаган жалгыз нерсе — тармак өзү койгон cookie же чыкылдатуу идентификатору. Адам тууралуу башка эч нерсе серверибизден чыкпайт.
| Тармак | Колдонулган идентификатор | Кайдан алынат |
|---|---|---|
| Meta | _fbp, _fbc | Meta пиксели койгон биринчи тараптын cookieлери |
li_fat_id | LinkedIn Insight Tag койгон биринчи тараптын cookieси | |
| TikTok | _ttp, ttclid | _ttp — cookie, ttclid жарнама чыкылдатылган URL даректен алынат |
| Google Ads | gclid, wbraid, gbraid | Жарнама чыкылдатылган URL даректен же андан кийинки _gcl_aw cookieсинен |
| Microsoft Advertising | msclkid | Жарнама чыкылдатылган URL даректен же UET теги жазган _uetmsclkid cookieсинен |
Эч качан жөнөтүлбөйт: электрондук почта дареги, телефон номери, аты же IP дареги — хештелген түрдө да. Конокто чыкылдатуу идентификатору жок болсо, таптакыр эч нерсе жөнөтүлбөйт. Так сан сиз үчүн дареги жок конверсиядан пайдалуураак.
Макулдук менен гана
Бул чакыруулар жаздыруунун өзү менен бирдей макулдук дарбазасынын артында турат. Макулдугу жок сеанс долбоор жөндөөлөрүндөгү которгучка карабастан конверсия билдирүүсүн түзбөйт.
3. Google Ads бир эмес, үч идентификаторго ээ
Бул адамдарды таң калтырат, ошондуктан так айтабыз. Google бир жарнама чыкылдатуусу үчүн gclid колдонот. Apple көзөмөлдөөнү алдын алып, жеке чыкылдатууну таандык кылуу мүмкүн болбогондо, Google анын ордуна wbraid же gbraid жөнөтөт; алар чыкылдатуулардын тобун билдирет.
Бул үчөө бири-бирин жокко чыгарат — Google эки идентификатору бар конверсияны четке кагат. Биз так бирөөнү жөнөтөбүз; бир нечеси бар болсо, gclid тандалат, анткени ал эң так.
Алар URL даректе бир жолу гана болот
Идентификатор даректе жарнама чыкылдатылгандан кийинки биринчи бетте гана көрүнөт. Андан соң Google теги аны _gcl_aw cookieсинде сактайт. Биз cookieни кошумча булак катары окуйбуз — ансыз кирүүнүн үчүнчү бетиндеги конверсия эч кандай идентификатор тапмак эмес.
4. Жөндөө
Meta, LinkedIn жана TikTok
Ар бирине эки талаа: пикселдин же конверсия эрежесинин IDси жана тармактын өз интерфейсинде түзгөн кирүү токениңиз. Экөө тең AES-256-GCM менен шифрленип сакталат жана сакталгандан кийин кайра көрсөтүлбөйт.
Google Ads үчүн алтоо керек
Google өзгөчө жана баштаардан мурун себебин билүү пайдалуу: башка үчөөнөн айырмаланып, Google жөнөкөй кирүү токенин бербейт. Кирүү жаңылоо токени бар OAuth аркылуу иштейт, ал эми Ads API кошумча иштеп чыгуучу токенин талап кылат.
| Талаа | Кайдан табылат |
|---|---|
| Кардар IDси | Google Ads ичинде жогорку оң бурчта. Сандар гана, сызыкчасыз. |
| Конверсия аракетинин IDси | Максаттар жана конверсиялар бөлүмүнөн бул катталсын деген аракетти тандаңыз. |
| Иштеп чыгуучу токени | Google Ads башкаруучу аккаунтуңуздун API борборунда. |
| OAuth кардар IDси жана сыры | Google Cloud Console, Кирүү маалыматтары, түрү «desktop app» болгон OAuth кардары. |
| Жаңылоо токени | Муну төмөнкү камтуу чөйрөсү үчүн өзүңүз бир жолу түзөсүз: adwords. |
LinkedInде эки жол бар, сизге кыскасы керек
Campaign Manager ичинде: Маалыматтар, Signals Manager, Direct API, Кирүү токенин түзүү. Бул өз маалыматтарын жөнөткөн жарнама берүүчүлөрдүн жолу — иштеп чыгуучу колдонмосу да, текшерүү да жок. Токендин мөөнөтү бүтпөйт жана Campaign Manager аны экинчи жолу көрсөтпөйт, ошондуктан дароо көчүрүңүз.
Башка жол — LinkedIn Developer Portal аркылуу суралуучу иштеп чыгуучу колдонмосу — көп жарнама берүүчүнүн атынан жөнөткөн платформалар үчүн бар. Ал компания бетин ырастоону жана бекитилген колдонуу мисалын талап кылат; бул жерде алардын кереги жок.
Microsoft Advertising оңой жөндөлөт
Google Adsтен кийин OAuth, иштеп чыгуучу токени жана бекитүү кадамы сыяктуу эле оорчулукту күтөсүз. Бирок тескерисинче: эки талаа гана. Браузерде колдонгон UET тег IDңиз жана Microsoft Advertising ичинде UET тегинин астындагы «Use Conversions API», «Copy Token» жеринен көчүргөн токениңиз. Арыз берүүнүн кереги жок.
Браузер теги менен бирдей тег IDсин колдонуңуз. Ушул Microsoftко сервердик окуя менен браузер окуясын эки эмес, бир конверсия катары таанууга мүмкүндүк берет.
Иштеп чыгуучу токенине Google уруксаты керек («Basic access»); бул бир нече күнгө созулат. Бул бир мүнөттө бүтүрө албаган жалгыз кадам, ошондуктан аны биринчи баштаңыз. Биз Google сырсөзүңүздү эч качан көрбөйбүз — жаңылоо токенин гана көрөбүз, аны каалаган убакта жокко чыгара аласыз.
5. Конверсия качан билдирилет
Ар бир максат жана сеанс үчүн так бир жолу. MousePlayer чакыруу жөнөтүлгөнгө чейин кайталоону басат; жүктө кошумча ID да бар, ошондуктан тармак өз тарабында кайра баса алат. Себетке беш товар кошкон конок беш эмес, бир конверсия түзөт.
Жарнама аккаунтуңузда эмнени көрөсүз
Конверсияда максаттын аты, коюлган болсо мааниси менен валютасы жана болгон убактысы болот. Кадимки иштөөдө ал бир мүнөттүн ичинде келет.
Эч нерсе келбесе
- Чыкылдатуу идентификатору жок. Конок бул тармактын жарнамасы аркылуу келген эмес же пиксель cookieни коё электе келген. Эч нерсе жөнөтүлбөйт — бул күтүлгөн көрүнүш, ката эмес.
- Макулдук жок. Адегенде дарбаза текшерилет.
- Тармак чакырууну кабыл алып, бирок конверсияны четке какты. Google, TikTok жана башкалар HTTP 200 менен жооп берип, катаны жооптун денесине жазат. Биз абалды гана эмес, денени да окуйбуз жана себеп жеткирүү журналында көрсөтүлөт.
Бул жерде аталган бардык соода белгилери тиешелүү ээлерине таандык. MousePlayer бул провайдерлер менен ишкердик байланышта эмес.