კონვერსიების API-ები

1. საერთოდ რატომ სერვერის მხარე?

ბრაუზერის პიქსელს კონვერსიის მოხსენებამდე სამი რამ უნდა გადაურჩეს: რეკლამის ბლოკერი, ჩაწერის პრევენცია და ვიზიტორის მიერ ჩანართის ნაადრევი დახურვა. სერვერული გამოძახება სამივეს უძლებს, რადგან ბრაუზერში საერთოდ არ ხდება.

MousePlayer-მა უკვე იცის, როდის შესრულდა მიზანი — სწორედ ამისთვისაა მიზნები. კონვერსიების API-ები ამ ფაქტს ჩვენი სერვერიდან სარეკლამო ქსელს გადასცემს.

2. რას ვაგზავნით და რას არასდროს

ამ გამოძახებებში ვიზიტორს მხოლოდ ეს ამოიცნობს: თავად ქსელის შექმნილი ქუქი ან დაწკაპუნების იდენტიფიკატორი. ადამიანის შესახებ სხვა არაფერი ტოვებს ჩვენს სერვერს.

ქსელი	გამოყენებული იდენტიფიკატორი	წყარო
Meta	_fbp, _fbc	Meta პიქსელის შექმნილი პირველი მხარის ქუქიები
LinkedIn	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 ტეგი წერს

მხოლოდ თანხმობით

ყველა ეს გამოძახება იმავე თანხმობის ბარიერს ექვემდებარება, რასაც ჩაწერა. თანხმობის არმქონე სესია კონვერსიას არ აგზავნის, პროექტის გადამრთველის მიუხედავად.

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 გამონაკლისია და მიზეზის ცოდნა დაწყებამდე ღირს: დანარჩენი სამისგან განსხვავებით მარტივ წვდომის ტოკენს არ იძლევა. წვდომა OAuth-ითა და განახლების ტოკენით ხდება; Ads API დამატებით მოითხოვს დეველოპერის ტოკენს.

ველი	სად იპოვოთ
კლიენტის ID	Google Ads-ის ზედა მარჯვენა კუთხეში. მხოლოდ ციფრები, დეფისების გარეშე.
კონვერსიის მოქმედების ID	მიზნები და კონვერსიები, შემდეგ შესაბამისი მოქმედება.
დეველოპერის ტოკენი	თქვენი Google Ads მმართველის ანგარიში, API ცენტრი.
OAuth კლიენტის ID და საიდუმლო	Google Cloud Console, ავტორიზაციის მონაცემები, OAuth კლიენტი ტიპით „კომპიუტერის აპი“.
განახლების ტოკენი	თქვენ თვითონ ერთხელ ქმნით ამ მოქმედების არით: adwords.

LinkedIn-ს ორი გზა აქვს; მოკლე გჭირდებათ

Campaign Manager-ში: მონაცემები, სიგნალების მმართველი, პირდაპირი API, წვდომის ტოკენის შექმნა. ეს საკუთარი მონაცემების გამგზავნი რეკლამის დამკვეთების გზაა — დეველოპერის აპისა და განხილვის გარეშე. ტოკენს ვადა არ გასდის და მეორედ არ გამოჩნდება, ამიტომ მაშინვე დააკოპირეთ.

მეორე გზა, LinkedIn Developer Portal-ით მოთხოვნილი აპი, ბევრი რეკლამის დამკვეთის სახელით გამგზავნ პლატფორმებს ემსახურება. სჭირდება კომპანიის გვერდის დამოწმება და დამტკიცებული გამოყენება; აქ არც ერთი არ გჭირდებათ.

Microsoft Advertising მარტივია

Google Ads-ის შემდეგ იგივე სირთულეს ელით — OAuth, დეველოპერის ტოკენი, დამტკიცება. პირიქითაა: ორი ველი. ბრაუზერში უკვე გამოყენებული UET ტეგის ID და Microsoft Advertising-იდან დაკოპირებული ტოკენი UET ტეგის ქვეშ: „Conversions API-ის გამოყენება“, „ტოკენის კოპირება“. განაცხადი საჭირო არ არის.

გამოიყენეთ იგივე ტეგის ID, რაც ბრაუზერის ტეგს აქვს. ასე Microsoft სერვერულსა და ბრაუზერის მოვლენას ერთ კონვერსიად ცნობს და არა ორად.

5. როდის იგზავნება კონვერსია

ზუსტად ერთხელ თითო მიზანსა და სესიაზე. MousePlayer გაგზავნამდე დუბლიკატებს აშორებს; მონაცემებს დამატებით ID ახლავს, რათა ქსელმა თავის მხარესაც შეამოწმოს. კალათაში ხუთი ნივთის დამატება ერთ კონვერსიას ქმნის და არა ხუთს.

რას ნახავთ სარეკლამო ანგარიშში

კონვერსიას ახლავს მიზნის სახელი, მითითების შემთხვევაში ღირებულება და ვალუტა, და მოხდენის დრო. ჩვეულებრივ ერთ წუთში მიდის.

თუ არაფერი მოდის

• დაწკაპუნების იდენტიფიკატორი არ არის. ვიზიტორი ამ ქსელის რეკლამით არ მოვიდა ან პიქსელის ქუქის შექმნამდე მოვიდა. არაფერი იგზავნება — ეს მოსალოდნელია და არა შეცდომა.
• თანხმობა არ არის. ბარიერი პირველია.
• ქსელმა გამოძახება მიიღო, მაგრამ კონვერსია უარყო. Google, TikTok და სხვები HTTP 200-ს და პასუხის სხეულში შეცდომას აბრუნებს. ვკითხულობთ სხეულს და არა მხოლოდ სტატუსს; მიზეზი მიწოდების ჟურნალში ჩანს.