اتصالات شرکا

AdsGram با Adjust و AppMetrica یکپارچه شده است. همچنین امکان کار با لینک‌های سایر ردیاب‌ها وجود دارد، اما در این صورت AdsGram نمی‌تواند اطلاعات لازم را برای آنالیتیکس دقیق‌تر به ردیاب منتقل کند.

مهم

تبلیغ‌دهندگانی که از Adjust و AppMetrica برای اپلیکیشن موبایل خود استفاده می‌کنند، اکنون می‌توانند داده‌های تبدیل‌هایی را که کاربران پس از کلیک روی بنرهای تبلیغاتی AdsGram انجام داده‌اند، دریافت کنند.

Adjust

۱. انتخاب شبکه

در بخش Campaign Lab، به Partners بروید

• روی New Partner کلیک کنید.
• در نوار جستجو، AdsGram را تایپ کرده و این شبکه را انتخاب کنید.
• پس از انتخاب، روی Next کلیک کنید.

۲. انتخاب اپلیکیشن

در صفحه بعدی، اپلیکیشنی را که می‌خواهید لینک را برای آن ایجاد کنید انتخاب کنید. از نوار جستجو برای یافتن اپلیکیشن خود استفاده کنید یا در لیست اسکرول کنید. می‌توانید لینک‌ها را برای یک اپلیکیشن در هر بار تنظیم کنید.
پس از انتخاب اپلیکیشن، روی Next کلیک کنید.

۳. تنظیم گزینه‌های اشتراک‌گذاری داده

در این بخش، پارامترهای اشتراک‌گذاری داده با AdsGram را تنظیم می‌کنید و انتخاب می‌کنید کدام رویدادها و پارامترهای اپلیکیشن برای تحلیل به AdsGram ارسال شوند.
دستورالعمل‌های دقیق در صفحه مستندات Adjust موجود است.

۴. دریافت لینک ردیابی

پس از پیکربندی تمام پارامترها و نگاشت‌ها، یک لینک ردیابی منحصربه‌فید دریافت خواهید کرد که باید هنگام ایجاد کمپین‌های تبلیغاتی در AdsGram استفاده شود.
علاوه بر این، می‌توانید پارامترهای اضافی مانند برچسب‌های UTM را برای ردیابی دقیق‌تر منابع ترافیک اضافه کنید.

مهم

پس از تنظیم لینک‌های ردیابی، داده‌های مربوط به تبدیل کاربران به نصب اپلیکیشن و رویدادهای درون‌برنامه‌ای پس از کلیک روی تبلیغات AdsGram فقط در رابط Adjust نمایش داده می‌شود.

AppMetrica

ایجاد ردیاب:

1. پس از ثبت‌نام در حساب شخصی AppMetrica، یکپارچه‌سازی SDK در اپلیکیشن و تنظیم ردیابی اقدامات هدف، می‌توانید ایجاد ردیاب را آغاز کنید.
2. نام ردیاب را مشخص کنید.
3. اپلیکیشن را اضافه کنید.

دستورالعمل‌های دقیق در صفحه مستندات AppMetrica موجود است.

انتقال داده‌های نصب:

4. دریافت‌کننده postback را انتخاب کنید (AdsGram).
5. نوع رویدادی که باید به AdsGram ارسال شود را مشخص کنید.
6. URL Postback را دریافت کنید — لینکی که از طریق آن رویدادها و نصب‌ها به سرور AdsGram ارسال می‌شوند.
7. پس از ایجاد postback‌ها، یک لینک ردیابی دریافت خواهید کرد. این لینک باید هنگام ایجاد کمپین در AdsGram استفاده شود. علاوه بر این، در صورت نیاز می‌توانید پارامترهای اضافی مانند برچسب‌های UTM اضافه کنید.

Keitaro

۱. ایجاد ردیاب در Keitaro

1. پس از ورود به داشبورد Keitaro، به بخش Trackers بروید.
2. روی Create tracker یا New tracker کلیک کنید.
3. نام ردیاب را وارد کرده و AdsGram را به‌عنوان نوع منبع ترافیک انتخاب کنید.
4. برای ایجاد ردیاب روی Save کلیک کنید.

۲. پیکربندی Postback در Keitaro

1. در تنظیمات ردیاب ایجادشده، به بخش Postback یا API Integration بروید.

2. در فیلد Postback URL، نقطه انتهایی AdsGram را وارد کنید:

   https://api.adsgram.ai/confirm_conversion?

3. پارامترهای کوئری الزامی زیر را اضافه کنید:

   token=YOUR_UNIQUE_TOKEN&record={_record_data}

   که در آن YOUR_UNIQUE_TOKEN توکن از پروفایل AdsGram شماست.

   هشدار

   برای دریافت مقدار خام از سیستم ردیابی، قبل از نام ماکرو "_" (زیرخط) اضافه کنید. این مورد فقط برای ردیاب Keitaro مربوط است و برای جلوگیری از حمله XSS ضروری است.

۳. تنظیم کمپین در AdsGram

1. Click URL را از تنظیمات ردیاب Keitaro خود کپی کنید (مثلاً: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
2. در داشبورد AdsGram، هنگام ایجاد کمپین، این لینک را در فیلد Click URL قرار دهید.
3. ماکروهای الزامی AdsGram را به لینک اضافه کنید:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}

4. اطمینان حاصل کنید که ماکرو {record_data} در لینک نهایی وجود دارد.

۴. تنظیم اهداف در Keitaro

1. در تنظیمات ردیاب Keitaro خود، به بخش Goals یا Conversions بروید.
2. یک هدف جدید ایجاد کنید یا یک هدف موجود را انتخاب کنید.
3. ارسال postback به URL مشخص‌شده قبلی را برای این هدف فعال کنید.
4. شرایط فعال‌سازی را تعریف کنید (مثلاً هنگام تأیید تبدیل یا وضعیت خاص).

Kochava

۱. ایجاد ردیاب در Kochava

1. پس از ورود به داشبورد Kochava، به بخش Apps & Assets بروید.
2. روی Add New کلیک کرده و App را برای ایجاد ردیاب اپلیکیشن جدید انتخاب کنید.
3. فیلدهای الزامی را پر کنید:
   • Platform: پلتفرم اپلیکیشن را انتخاب کنید (iOS، Android، Web).
   • App Name: نام اپلیکیشن خود را وارد کنید.
   • Store ID: شناسه فروشگاه اپلیکیشن را وارد کنید (App Store ID، Package Name و غیره).
4. برای ایجاد اپلیکیشن روی Save کلیک کنید.

۲. تنظیم اتصال شریک

1. در صفحه اپلیکیشن ایجادشده، به بخش Partner Management بروید.
2. روی Add Partner کلیک کنید.
3. AdsGram را از لیست شرکا پیدا و انتخاب کنید.
4. برای ادامه به تنظیمات پیکربندی، روی Next کلیک کنید.

۳. پیکربندی پارامترهای اتصال

1. در بخش Integration Settings، نوع ردیابی را انتخاب کنید (Click-Through، View-Through یا Hybrid).

2. گزینه Server-to-Server Postbacks را فعال کنید.

3. در فیلد Postback URL، نقطه انتهایی AdsGram را وارد کنید:

   https://api.adsgram.ai/confirm_conversion

4. پارامترهای زیر را به Postback Parameters اضافه کنید:

   • پارامتر الزامی: {record_data} (به‌طور خودکار توسط Kochava درج می‌شود).
   • افزودن پارامتر: token با مقدار YOUR_UNIQUE_TOKEN (از پروفایل AdsGRAM شما دریافت می‌شود).

5. ماکروهای نگاشت داده را تنظیم کنید:

   • {campaign_id} → campaign_id
   • {click_id} → click_id
   • {publisher_id} → publisher_id

۴. تنظیم کمپین در AdsGram

1. به بخش Tracking Links در Kochava برگردید و یک لینک ردیابی ایجاد کنید (مثلاً: https://your-app.kochava.com/install?data={encrypted_data}).
2. در داشبورد AdsGram، هنگام ایجاد کمپین، این لینک را در فیلد Click URL قرار دهید.
3. ماکروهای الزامی AdsGram را به‌عنوان پارامتر به لینک اضافه کنید:

   https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}

4. اطمینان حاصل کنید که ماکرو {record_data} در URL نهایی وجود دارد.

۵. تنظیم رویدادها در Kochava

1. در داشبورد Kochava، به بخش Events بروید.
2. یک رویداد جدید ایجاد کنید یا یک رویداد استاندارد انتخاب کنید (مثلاً install، purchase).
3. postback را برای رویداد انتخاب‌شده پیکربندی کنید:
   • Send Postback را فعال کنید.
   • اتصال AdsGram ایجادشده قبلی را انتخاب کنید.
   • فیلترها و شرایط فعال‌سازی را تعریف کنید.
4. پیکربندی رویداد را ذخیره کنید.

۶. آزمایش اتصال

1. از Test Mode در Kochava برای تأیید ردیابی نصب استفاده کنید.
2. درخواست‌های ورودی را در لاگ‌های Kochava و AdsGram بررسی کنید.
3. اطمینان حاصل کنید که پارامتر record_data به‌درستی منتقل می‌شود.