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 از نشانی کلیک تبلیغ می‌آید |
| Google Ads | gclid، wbraid، gbraid | از نشانی کلیک تبلیغ یا سپس از کوکی _gcl_aw می‌آید |
| Microsoft Advertising | msclkid | از نشانی کلیک تبلیغ یا کوکی _uetmsclkid که برچسب UET می‌نویسد |
هرگز فرستاده نمی‌شود: ایمیل، تلفن، نام یا IP، حتی هش‌شده. اگر بازدیدکننده شناسهٔ کلیک نداشته باشد، اصلاً چیزی نمی‌رود. تبدیل بدون تطبیق از شمارش دقیق برای شما کم‌ارزش‌تر است.
فقط با رضایت
هر فراخوان پشت همان دروازهٔ رضایت ضبط است. نشست بدون رضایت هیچ گزارش تبدیل نمی‌سازد، صرف‌نظر از کلید تنظیم پروژه.
3. Google Ads سه شناسه دارد، نه یکی
این افراد را شگفت‌زده می‌کند؛ پس روشن می‌گوییم. Google از این مورد استفاده می‌کند: gclid برای تک کلیک تبلیغ. وقتی جلوگیری از ردیابی Apple انتساب یک کلیک را ناممکن کند، Google این را می‌فرستد: wbraid یا gbraid که نمایندهٔ گروهی از کلیک‌ها هستند.
سه مورد با هم ناسازگارند؛ Google تبدیل دارای دو مورد را رد می‌کند. دقیقاً یکی می‌فرستیم و این مورد gclid در صورت وجود چند مورد مقدم است، چون دقیق‌ترین است.
فقط یک بار در نشانی هستند
شناسه فقط در نشانی نخستین صفحه پس از کلیک تبلیغ ظاهر می‌شود. سپس برچسب Google آن را در کوکی _gcl_aw ذخیره می‌کند. کوکی را به‌عنوان جایگزین می‌خوانیم؛ بدون آن تبدیل در صفحهٔ سوم بازدید اصلاً شناسه‌ای نمی‌یافت.
4. راه‌اندازی
Meta، LinkedIn و TikTok
هرکدام دو فیلد: شناسهٔ پیکسل یا قاعدهٔ تبدیل و توکن دسترسی ساخته‌شده در رابط خود شبکه. هر دو با AES-256-GCM رمزگذاری می‌شوند و پس از ذخیره هرگز دوباره نشان داده نمی‌شوند.
Google Ads شش مورد می‌خواهد
Google استثناست و بهتر است پیش از شروع دلیل را بدانید: برخلاف سه مورد دیگر توکن ساده نمی‌دهد. دسترسی با OAuth و توکن نوسازی است و Ads API علاوه بر آن این مورد را می‌خواهد: توکن توسعه‌دهنده.
| فیلد | محل یافتن |
|---|---|
| شناسهٔ مشتری | بالای سمت راست Google Ads. فقط رقم، بدون خط تیره. |
| شناسهٔ اقدام تبدیل | هدف‌ها و تبدیل‌ها، سپس اقدامی که می‌خواهید این تبدیل در آن ثبت شود. |
| توکن توسعه‌دهنده | حساب مدیریتی Google Ads، بخش API Center. |
| شناسه و رمز کارخواه OAuth | Google Cloud Console، بخش Credentials، کارخواه OAuth از نوع «desktop app». |
| توکن نوسازی | یک بار خودتان برای این دامنه تولید می‌کنید: adwords. |
LinkedIn دو راه دارد و راه کوتاه را می‌خواهید
در Campaign Manager: داده، Signals Manager، Direct API، تولید توکن دسترسی. این مسیر تبلیغ‌دهنده‌ای است که دادهٔ خودش را می‌فرستد؛ بدون برنامهٔ توسعه‌دهنده و بررسی. توکن منقضی نمی‌شود و Campaign Manager دوباره نشانش نمی‌دهد؛ فوری کپی کنید.
مسیر دیگر، برنامهٔ توسعه‌دهنده از Developer Portal لینکدین، برای پلتفرم فرستنده به‌نیابت از تبلیغ‌دهندگان متعدد است. تأیید صفحهٔ شرکت و کاربرد پذیرفته‌شده می‌خواهد و اینجا هیچ‌کدام لازم نیست.
Microsoft Advertising آسان است
پس از Google Ads همان پیچیدگی را انتظار دارید: OAuth، توکن توسعه‌دهنده و تأیید. برعکس است: دو فیلد. شناسهٔ برچسب UET که از قبل در مرورگر دارید و توکنی که در Microsoft Advertising زیر برچسب UET، «Use Conversions API»، «Copy Token» کپی می‌کنید. درخواستی لازم نیست.
از شناسهٔ یکسان با برچسب مرورگرتان استفاده کنید. همین باعث می‌شود Microsoft رویداد سرور و مرورگر را یک تبدیل ببیند، نه دو تا.
توکن توسعه‌دهنده تأیید Google می‌خواهد («Basic access») و چند روز طول می‌کشد. تنها گامی است که در یک دقیقه تمام نمی‌شود؛ ابتدا همین را شروع کنید. رمز Google شما را هرگز نمی‌بینیم؛ فقط توکن نوسازی را می‌بینیم که هر زمان می‌توانید پس بگیرید.
5. زمان گزارش تبدیل
دقیقاً یک بار به‌ازای هدف و نشست. MousePlayer پیش از فراخوان تکرار را حذف می‌کند و دادهٔ ارسالی شناسه هم دارد تا شبکه دوباره در سمت خودش تکرارزدایی کند. بازدیدکننده‌ای که پنج کالا به سبد می‌افزاید یک تبدیل می‌سازد، نه پنج تا.
آنچه در حساب تبلیغ می‌بینید
تبدیل نام هدف، ارزش و واحد پول در صورت تنظیم و زمان وقوع را دارد. در کارکرد عادی ظرف یک دقیقه می‌رسد.
اگر چیزی نمی‌رسد
- شناسهٔ کلیک نیست. بازدیدکننده از تبلیغ آن شبکه نیامده یا پیش از گذاشتن کوکی پیکسل رسیده است. چیزی فرستاده نمی‌شود؛ انتظار همین است و خطا نیست.
- رضایت نیست. دروازه پیش از همه بود.
- شبکه فراخوان را پذیرفت، اما تبدیل را رد کرد. Google، TikTok و چند مورد دیگر HTTP 200 و خطا در بدنهٔ پاسخ می‌دهند. بدنه را می‌خوانیم، نه فقط وضعیت، و دلیل در گزارش تحویل می‌آید.
همهٔ علائم تجاری نام‌برده متعلق به مالکانشان‌اند. MousePlayer با این ارائه‌دهندگان رابطهٔ تجاری ندارد.