راه‌اندازی postback تبدیل برای لینک‌های فرود اکوسیستم Telegram

توجه

دستورالعمل‌های این بخش برای کمپین‌های Telegram Ads کاربرد ندارند. برای اطلاعات بیشتر درباره ردیابی تبدیل برای لینک‌های داخل Telegram در کمپین‌های Telegram Ads، این بخش را ببینید.

پارامترها:

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

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

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

  

• tgid — شناسه Telegram کاربری که روی لینک تبلیغاتی کلیک کرده است.

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

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

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

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

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

1. یک کمپین انتخاب کنید. از یک کمپین فعال موجود استفاده کنید یا کمپین جدیدی بسازید.
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&tgid=98110997&goaltype=2&campaignid=72156

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

مقادیر نمونه را با داده‌های واقعی خود جایگزین کنید:

• YOUR_UNIQUE_TOKEN — توکن حساب AdsGram شما؛
• 98110997 — شناسه Telegram کاربری که روی لینک تبلیغاتی کلیک کرده است؛
• 72156 — شناسه کمپین تبلیغاتی شما.

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

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

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

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

عیب‌یابی

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