පරිවර්තන API
ඔබේ ඉලක්ක බ්‍රවුසරයෙන් වෙනුවට අපේ සේවාදායකයෙන් Meta, LinkedIn, TikTok සහ Google Ads වෙත වාර්තා කරන්න – ජාලයම සකස් කළ ක්ලික් හඳුනාගැනීමේ අංකයෙන් පමණක් ගළපයි.
1. සේවාදායක පාර්ශ්වය අවශ්‍ය ඇයි?
බ්‍රවුසර පික්සලයකට පරිවර්තනයක් වාර්තා කිරීමට පෙර දේවල් තුනක් පසු කළ යුතුය: දැන්වීම් අවහිරකාරකයක්, ලුහුබැඳීම වැළැක්වීමේ සැකසුමක් සහ පික්සලය ක්‍රියාත්මක වීමට පෙර අමුත්තා ටැබය වැසීම. සේවාදායක ඇමතුම මේ තුනම පසු කරයි; එය බ්‍රවුසරයේ සිදු නොවන නිසාය.
ඔබේ ඉලක්කයක් ඉටු වූ විට MousePlayer දැනටමත් එය දනී – ඉලක්ක ඇත්තේ ඒ සඳහාය. පරිවර්තන API එම කරුණ අපේ සේවාදායකයෙන් දැන්වීම් ජාලයට යවයි.
මෙය ඔබේ පික්සලය ප්‍රතිස්ථාපනය නොකරයි. එය තබාගන්න. සෑම ජාලයක්ම දෙක අතර අනුපිටපත් ඉවත් කරන අතර ඒ සඳහා අවශ්‍ය හඳුනාගැනීමේ අංක අපි යවන්නෙමු.
2. යවන දේ සහ කිසිදා නොයවන දේ
මෙම ඇමතුම්වල අමුත්තා හඳුනාගන්නා එකම දේ ජාලයම සකස් කළ කුකිය හෝ ක්ලික් හඳුනාගැනීමේ අංකයයි. පුද්ගලයා ගැන වෙනත් කිසිවක් අපේ සේවාදායකයෙන් පිට නොවේ.
| ජාලය | භාවිත කරන හඳුනාගැනීමේ අංකය | ලැබෙන තැන |
|---|---|---|
| Meta | _fbp, _fbc | Meta පික්සලය සකස් කළ පළමු පාර්ශ්ව කුකී |
li_fat_id | LinkedIn Insight Tag සකස් කළ පළමු පාර්ශ්ව කුකිය | |
| TikTok | _ttp, ttclid | _ttp කුකියකි, ttclid ලැබෙන්නේ දැන්වීම් ක්ලික් URL වෙතිනි |
| Google Ads | gclid, wbraid, gbraid | දැන්වීම් ක්ලික් URL වෙතින්, නැතහොත් පසුව පහත _gcl_aw කුකියෙන් |
| Microsoft Advertising | msclkid | දැන්වීම් ක්ලික් URL වෙතින්, නැතහොත් පහත _uetmsclkid UET ටැගය ලියන කුකියෙන් |
කිසිදා නොයවයි: විද්‍යුත් තැපැල් ලිපිනය, දුරකථන අංකය, නම හෝ IP ලිපිනය – හැෂ් කළ ආකාරයෙන්වත් නොවේ. අමුත්තකුට ක්ලික් හඳුනාගැනීමේ අංකයක් නැතිනම් කිසිවක් නොයවයි. ගැළපීමක් නැති පරිවර්තනයකට වඩා නිවැරදි ගණනක් ඔබට වටී.
කැමැත්ත සමඟ පමණි
මෙම සෑම ඇමතුමක්ම පටිගත කිරීමටම ඇති කැමැත්ත පරීක්ෂාවට යටත් වේ. කැමැත්ත නැති සැසියකින් ව්‍යාපෘති සැකසීම්වල ස්විචය කුමක් වුවත් පරිවර්තන වාර්තාවක් නොලැබේ.
3. Google Ads හි එක් හඳුනාගැනීමේ අංකයක් නොව තුනක් ඇත
මෙය පුදුමයට හේතු වන නිසා පැහැදිලිව කිව යුතුය. Google භාවිත කරන්නේ gclid එක් දැන්වීම් ක්ලික් කිරීමක් සඳහාය. Apple හි ලුහුබැඳීම වැළැක්වීම නිසා තනි ක්ලික් කිරීමක් ආරෝපණය කළ නොහැකි වූ විට Google යවන්නේ wbraid හෝ gbraid ඒ වෙනුවටය; ඒවා ක්ලික් කාණ්ඩයක් නියෝජනය කරයි.
තුනම එකවර භාවිත කළ නොහැකිය – දෙකක් ඇති පරිවර්තනයක් Google ප්‍රතික්ෂේප කරයි. අපි හරියටම එකක් යවන්නෙමු; පහත අගය gclid එකකට වඩා ඇති විට ප්‍රමුඛ වේ, එය වඩාත් නිවැරදි නිසාය.
ඒවා URL හි ඇත්තේ එක් වරක් පමණි
හඳුනාගැනීමේ අංකය ලිපිනයේ පෙනෙන්නේ දැන්වීම ක්ලික් කිරීමෙන් පසු පළමු පිටුවේ පමණි. පසුව Google ටැගය එය පහත _gcl_aw කුකියේ ගබඩා කරයි. විකල්පයක් ලෙස අපි කුකිය කියවන්නෙමු – එය නැතිව පැමිණීමේ තුන්වන පිටුවේ පරිවර්තනයකට හඳුනාගැනීමේ අංකයක් කිසිසේත් හමු නොවනු ඇත.
4. සැකසීම
Meta, LinkedIn සහ TikTok
එක් එක් සඳහා ක්ෂේත්‍ර දෙකකි: පික්සලයේ හෝ පරිවර්තන රීතියේ හඳුනාගැනීමේ අංකය සහ ජාලයේම අතුරුමුහුණතේ ඔබ සාදන ප්‍රවේශ ටෝකනයක්. දෙකම AES-256-GCM සංකේතනයෙන් ගබඩා කරන අතර සුරැකීමෙන් පසු නැවත නොපෙන්වයි.
Google Ads සඳහා හයක් අවශ්‍යයි
Google ව්‍යතිරේකයයි; ආරම්භයට පෙර හේතුව දැනගැනීම ප්‍රයෝජනවත්ය: අනෙක් තුන මෙන් සරල ප්‍රවේශ ටෝකනයක් Google ලබා නොදෙයි. ප්‍රවේශය refresh token සමඟ OAuth හරහා සිදුවන අතර Ads API සඳහා අමතරව අවශ්‍ය වන්නේ සංවර්ධක ටෝකනයකි.
| ක්ෂේත්‍රය | සොයාගන්නා තැන |
|---|---|
| පාරිභෝගික හඳුනාගැනීමේ අංකය | Google Ads හි ඉහළ දකුණේ. ඉලක්කම් පමණි, බෙදුම් ඉරි නැතිව. |
| පරිවර්තන ක්‍රියා හඳුනාගැනීමේ අංකය | ඉලක්ක සහ පරිවර්තන යටතේ, පසුව මෙය සටහන් කිරීමට අවශ්‍ය ක්‍රියාව. |
| සංවර්ධක ටෝකනය | ඔබේ Google Ads කළමනාකරු ගිණුමේ API Center. |
| OAuth client ID සහ රහස් යතුර | Google Cloud Console, Credentials, “desktop app” වර්ගයේ OAuth client. |
| Refresh token | පහත විෂය පථය සඳහා ඔබම එක් වරක් එය ජනනය කරයි: adwords. |
LinkedIn හි මාර්ග දෙකක් ඇත; ඔබට අවශ්‍ය කෙටි එකයි
Campaign Manager තුළ: Data, Signals Manager, Direct API, Generate access token. මෙය තමන්ගේම දත්ත යවන දැන්වීම්කරුවන්ගේ මාර්ගයයි – සංවර්ධක යෙදුමක් හෝ සමාලෝචනයක් නැත. ටෝකනය කල් ඉකුත් නොවන අතර Campaign Manager එය දෙවන වරක් නොපෙන්වන බැවින් වහා පිටපත් කරන්න.
අනෙක් මාර්ගය LinkedIn Developer Portal හරහා ඉල්ලන සංවර්ධක යෙදුමකි; එය බොහෝ දැන්වීම්කරුවන් වෙනුවෙන් යවන වේදිකා සඳහාය. සමාගම් පිටුව තහවුරු කිරීම සහ අනුමත භාවිත අවස්ථාවක් අවශ්‍යයි; මෙහි ඔබට ඒ කිසිවක් අවශ්‍ය නැත.
Microsoft Advertising පහසු එකයි
Google Ads පසු ඒ බරම අපේක්ෂා කළ හැකිය – OAuth, සංවර්ධක ටෝකනයක්, අනුමැති පියවරක්. එහෙත් ප්‍රතිවිරුද්ධයයි: ක්ෂේත්‍ර දෙකකි. බ්‍රවුසරයේ දැනට භාවිත කරන UET tag ID සහ Microsoft Advertising හි UET ටැගය යටතේ “Use Conversions API”, “Copy Token” වෙතින් පිටපත් කරන ටෝකනයක්. අයදුම් කිරීමට කිසිවක් නැත.
භාවිත කරන්න: එකම tag ID ඔබේ බ්‍රවුසර ටැගයේ ඇති එක. එයින් Microsoft ට සේවාදායක සිදුවීම සහ බ්‍රවුසර සිදුවීම පරිවර්තන දෙකක් වෙනුවට එකක් ලෙස හඳුනාගත හැකිය.
සංවර්ධක ටෝකනයට Google අනුමැතිය අවශ්‍යයි (“Basic access”), එයට දින කිහිපයක් ගත වේ. විනාඩියකින් අවසන් කළ නොහැකි එකම පියවර එයයි; එබැවින් මුලින් අරඹන්න. අපි ඔබේ Google මුරපදය කිසිදා නොදකිමු – refresh token පමණි; ඕනෑම වේලාවක එය අවලංගු කළ හැකිය.
5. පරිවර්තනයක් වාර්තා වන වේලාව
එක් ඉලක්කයකට සහ සැසියකට හරියටම එක් වරකි. ඇමතුම යැවීමට පෙර MousePlayer අනුපිටපත් වළක්වන අතර දත්ත සමඟ අංකයක්ද යවන නිසා ජාලයටත් තම පැත්තේ නැවත එය වළක්වාගත හැකිය. භාණ්ඩ පහක් කරත්තයට දමන අමුත්තකු පරිවර්තන පහක් නොව එකක් ජනනය කරයි.
ඔබේ දැන්වීම් ගිණුමේ පෙනෙන දේ
පරිවර්තනයට ඔබේ ඉලක්ක නම, සකසා ඇත්නම් වටිනාකම සහ මුදල් ඒකකය, සහ සිදු වූ වේලාව ඇතුළත් වේ. සාමාන්‍ය ක්‍රියාකාරීත්වයේදී විනාඩියක් තුළ ලැබේ.
කිසිවක් නොලැබේ නම්
- ක්ලික් හඳුනාගැනීමේ අංකයක් නැත. අමුත්තා එම ජාලයේ දැන්වීමකින් පැමිණ නැත, නැතහොත් පික්සලය කුකිය සකසන්නට පෙර පැමිණ ඇත. කිසිවක් නොයවයි – මෙය අපේක්ෂිතය, දෝෂයක් නොවේ.
- කැමැත්ත නැත. කැමැත්ත පරීක්ෂාව මුලින් සිදු විය.
- ජාලය ඇමතුම පිළිගත් නමුත් පරිවර්තනය ප්‍රතික්ෂේප කළේය. Google, TikTok සහ තවත් ජාල HTTP 200 සමඟ පිළිතුරු අන්තර්ගතයේ දෝෂයක් එවයි. අපි තත්ත්වය පමණක් නොව අන්තර්ගතයද කියවන අතර හේතුව බෙදාහැරීම් සටහනේ පෙනේ.
මෙහි සඳහන් සියලු වෙළඳ ලකුණු ඒවායේ අයිතිකරුවන් සතුය. MousePlayer මෙම සැපයුම්කරුවන් සමඟ ව්‍යාපාරික සම්බන්ධතාවක් නැත.