Конверсия 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-і | Goals and conversions, содан кейін осы конверсия тіркелетін әрекет. |
| Әзірлеуші токені | Google Ads басқарушы есептік жазбаңыз, API Center. |
| OAuth клиент ID-і мен құпиясы | Google Cloud Console, Credentials, түрі «desktop app» болатын OAuth client. |
| Жаңарту токені | Оны мына ауқым үшін бір рет өзіңіз жасайсыз: adwords. |
LinkedIn ішінде екі жол бар, сізге қысқасы керек
Campaign Manager ішінде: Data, Signals Manager, Direct API, Generate access token. Бұл — өз дерегін жіберетін жарнама берушілер жолы, әзірлеуші қолданбасы да, тексеру де жоқ. Токен мерзімсіз және 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 осы қызмет жеткізушілерімен іскерлік қатынаста емес.