ਰੂਪਾਂਤਰਨ 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
ਹਰ ਇੱਕ ਲਈ ਦੋ ਖੇਤਰ: ਪਿਕਸਲ ਜਾਂ ਰੂਪਾਂਤਰਨ ਨਿਯਮ ਦੀ 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 ਵੀ ਹੈ, ਤਾਂ ਜੋ ਨੈੱਟਵਰਕ ਆਪਣੇ ਪਾਸੇ ਮੁੜ ਰੋਕ ਸਕੇ। ਟੋਕਰੀ ਵਿੱਚ ਪੰਜ ਚੀਜ਼ਾਂ ਪਾਉਣ ਵਾਲਾ ਵਿਜ਼ਟਰ ਇੱਕ ਰੂਪਾਂਤਰਨ ਬਣਾਉਂਦਾ ਹੈ, ਪੰਜ ਨਹੀਂ।
ਇਸ਼ਤਿਹਾਰ ਖਾਤੇ ਵਿੱਚ ਕੀ ਦਿਸੇਗਾ
ਰੂਪਾਂਤਰਨ ਵਿੱਚ ਟੀਚੇ ਦਾ ਨਾਮ, ਸੈੱਟ ਹੋਣ ਉੱਤੇ ਮੁੱਲ ਅਤੇ ਮੁਦਰਾ ਅਤੇ ਵਾਪਰਨ ਦਾ ਸਮਾਂ ਹੁੰਦਾ ਹੈ। ਆਮ ਕਾਰਵਾਈ ਵਿੱਚ ਇੱਕ ਮਿੰਟ ਅੰਦਰ ਆਉਂਦਾ ਹੈ।
ਜੇ ਕੁਝ ਨਾ ਆਵੇ
- ਕਲਿੱਕ ਪਛਾਣਕਰਤਾ ਨਹੀਂ। ਵਿਜ਼ਟਰ ਉਸ ਨੈੱਟਵਰਕ ਦੇ ਇਸ਼ਤਿਹਾਰ ਰਾਹੀਂ ਨਹੀਂ ਆਇਆ ਜਾਂ ਪਿਕਸਲ ਦੀ ਕੂਕੀ ਸੈੱਟ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਆਇਆ। ਕੁਝ ਨਹੀਂ ਭੇਜਿਆ ਜਾਂਦਾ — ਉਮੀਦ ਅਨੁਸਾਰ ਹੈ, ਗਲਤੀ ਨਹੀਂ।
- ਸਹਿਮਤੀ ਨਹੀਂ। ਰੋਕ ਪਹਿਲਾਂ ਆਈ।
- ਨੈੱਟਵਰਕ ਨੇ ਕਾਲ ਮੰਨੀ ਪਰ ਰੂਪਾਂਤਰਨ ਰੱਦ ਕੀਤਾ। Google, TikTok ਅਤੇ ਕਈ ਹੋਰ HTTP 200 ਨਾਲ ਜਵਾਬ ਦਿੰਦੇ ਹਨ ਪਰ ਜਵਾਬ ਦੇ ਅੰਦਰ ਗਲਤੀ ਹੁੰਦੀ ਹੈ। ਅਸੀਂ ਸਿਰਫ਼ ਸਥਿਤੀ ਨਹੀਂ, ਮੁੱਖ ਜਵਾਬ ਪੜ੍ਹਦੇ ਹਾਂ ਅਤੇ ਕਾਰਨ ਡਿਲਿਵਰੀ ਲੌਗ ਵਿੱਚ ਆਉਂਦਾ ਹੈ।
ਇੱਥੇ ਦੱਸੇ ਸਾਰੇ ਟ੍ਰੇਡਮਾਰਕ ਆਪਣੇ ਮਾਲਕਾਂ ਦੇ ਹਨ। MousePlayer ਦਾ ਇਨ੍ਹਾਂ ਪ੍ਰਦਾਤਾਵਾਂ ਨਾਲ ਕੋਈ ਵਪਾਰਕ ਸੰਬੰਧ ਨਹੀਂ ਹੈ।