ردیابی تبدیل در کمپین‌های Telegram Ads

ردیابی تبدیل برای لینک‌های داخل Telegram در کمپین‌های Telegram Ads

در کمپین‌های Telegram Ads، ماکروهای AdsGram برای لینک‌هایی که به مقصدهای داخل Telegram می‌روند پشتیبانی نمی‌شوند و به این لینک‌های تبلیغاتی منتقل نمی‌شوند. بنابراین API تأیید تبدیل را نمی‌توان برای ردیابی تبدیل‌های لینک‌هایی که به Telegram Mini Apps (TMA)، ربات‌ها یا کانال‌ها می‌روند استفاده کرد.

برای لینک‌های داخل Telegram در کمپین‌های Telegram Ads، رویدادهای هدف زیر به‌طور پیش‌فرض و خودکار در Goal 1 ثبت می‌شوند:

• TMA — اجرای TMA؛
• ربات‌ها — اجرای ربات؛
• کانال‌ها — عضویت در کانال.

تبدیل‌ها به‌طور خودکار ثبت می‌شوند، بنابراین نیازی به پیکربندی اضافی نیست.

راه‌اندازی postback تبدیل برای لینک‌های وب در Telegram Ads

پارامترها:

• token — یک توکن منحصربه‌فرد مرتبط با حساب شما. این توکن در پنل AdsGram در دسترس است و در صورت نیاز قابل بازتولید است.

  نحوه دریافت توکن:

  1. پنل AdsGram را باز کنید.
  2. روی پروفایل خود در گوشه بالا سمت راست کلیک کنید.
  3. پارامتر token را پیدا کنید و برای کپی کردن آن روی دکمه کپی کلیک کنید.

  

• campaignid — شناسه کمپین تبلیغاتی AdsGram که تبدیل به آن تعلق دارد. با مقدار ماکروی {campaign_id} که در لینک تبلیغاتی ارسال می‌شود مطابقت دارد. AdsGram هنگام کلیک کاربر روی لینک، مقدار ماکرو را جایگزین می‌کند.

• goaltype — پارامتری که نوع تبدیل (مرحله قیف) را مشخص می‌کند و به بخش‌بندی اقدامات مختلف کاربر کمک می‌کند. مقادیر صحیح از ۱ تا ۳ را می‌پذیرد.

  نحوه استفاده از goaltype:

  1. مراحل قیف را در محصول یا سرویس خود تعریف کنید.
  2. مراحل را به مقادیر goaltype نگاشت کنید:
     • ۱. ثبت‌نام
     • ۲. اولین واریز/خرید
     • ۳. واریز/خرید مجدد
  3. ردیابی تبدیل را برای مراحل مربوطه سفر کاربر پیکربندی کنید.
  4. پارامتر goaltype را به درخواست API خود هنگام ارسال داده‌های تبدیل اضافه کنید.
  5. از این پارامتر در آنالیتیکس خود برای انجام تحلیل عملکرد دقیق بر اساس نوع تبدیل استفاده کنید.

نحوه راه‌اندازی ردیابی تبدیل:

1. یک کمپین Telegram Ads انتخاب کنید. از یک کمپین فعال موجود استفاده کنید یا کمپین جدیدی بسازید.
2. لینک ردیابی را پیکربندی کنید. مطمئن شوید که ماکروی {campaign_id} را دارد.
3. توکن خود را دریافت کنید. توکن منحصربه‌فرد خود را از پنل AdsGram کپی کنید.
4. ارسال postback را تنظیم کنید. سرور خود را طوری پیکربندی کنید که هر بار کاربر یک اقدام هدف را انجام می‌دهد، یک درخواست API به AdsGram بفرستد.
5. نوع تبدیل را مشخص کنید. اگر می‌خواهید مراحل قیف را از هم تفکیک کنید، مقدار مناسب goaltype را تنظیم کنید.
6. یکپارچه‌سازی را آزمایش کنید. مراحل بخش آزمایش یکپارچه‌سازی در پایین را دنبال کنید و مطمئن شوید تبدیل‌ها در آمار AdsGram نمایش داده می‌شوند.

نمونه درخواست API هنگام تبدیل:

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&campaignid=72156&goaltype=2

در این مثال، goaltype=2 نشان‌دهنده تبدیلی مانند اولین واریز یا خرید است.

YOUR_UNIQUE_TOKEN را با توکن حساب خود و 72156 را با شناسه کمپین تبلیغاتی خود جایگزین کنید.

پاسخ مورد انتظار: 200 OK — تبدیل با موفقیت ثبت شد.

آزمایش یکپارچه‌سازی

برای آزمایش ردیابی تبدیل، این مراحل را دنبال کنید:

1. یک کمپین بسازید یا انتخاب کنید. یک کمپین Telegram Ads بسازید یا انتخاب کنید و لینک ردیابی را مطابق مستندات پیکربندی کنید. مطمئن شوید که ماکروی {campaign_id} در لینک وجود دارد.
2. منتظر کلیک‌ها بمانید. صبر کنید تا کاربران چند بار روی لینک ردیابی کلیک کنند.
3. به‌صورت دستی یک postback آزمایشی با پارامتر goaltype=1 ارسال کنید. از یک token معتبر و شناسه کمپین آزمایشی در پارامتر campaignid استفاده کنید.
4. نتیجه را بررسی کنید. مطمئن شوید که درخواست با موفقیت پردازش شده و تبدیل در آمار AdsGram برای کمپین انتخاب‌شده نمایش داده می‌شود.

عیب‌یابی

• تبدیل در آمار نمایش داده می‌شود: یکپارچه‌سازی به‌درستی پیکربندی شده و برای سناریوی آزمایش‌شده کار می‌کند.
• سرور خطا برمی‌گرداند: URL درخواست و مقادیر پارامترهای token، campaignid و goaltype را بررسی کنید.
• درخواست موفق است، اما تبدیل نمایش داده نمی‌شود: آمار هر یک ساعت یک بار به‌روزرسانی می‌شود. اگر پس از یک ساعت تبدیل هنوز نمایش داده نشد، با پشتیبانی AdsGram یا مدیر حساب خود تماس بگیرید و حتماً لاگ‌های درخواست و پاسخ را پیوست کنید.