اتصالات شرکا

AdsGram از ادغام با پلتفرم‌های محبوب اسناد و ردیابی پشتیبانی می‌کند. این پلتفرم‌ها به شما امکان می‌دهند کلیک‌ها، نصب‌ها و اقدامات کاربران را پس از تعامل با تبلیغات AdsGram ردیابی کنید و همچنین داده‌های تبدیل را به AdsGram ارسال کنید که این امر امکان بهینه‌سازی کمپین‌ها بر اساس هزینه تبدیل (tCPA) را فراهم می‌کند.

اتصالات زیر در دسترس هستند:

• AppsFlyer
• Adjust
• AppMetrica
• Kochava
• Keitaro

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

Adjust

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

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

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

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

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

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

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

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

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

۵. انتقال داده‌های تبدیل

به‌طور پیش‌فرض، داده‌های فعالیت کاربران از Adjust به AdsGram منتقل می‌شود و به‌طور خودکار به اهداف مربوطه اختصاص می‌یابد:

• نشست‌ها (Sessions) - به Goal 1
• نصب‌ها (Installs) - به Goal 2

مهم

برای راه‌اندازی کمپین tCPA، باید حداقل ۱۰ تبدیل برای هدف انتخاب‌شده دریافت کنید. برای مثال، اگر کمپین با Goal 2 راه‌اندازی شود، باید حداقل ۱۰ تبدیل برای Goal 2 دریافت کنید.

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 و پارامتر record را اضافه کنید. نام پارامتر باید با پارامتر record مشخص‌شده در Tracking Link مطابقت داشته باشد.

   برای مثال، اگر ماکروی AdsGram را در Tracking Link به این شکل ارسال کنید:

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

   در این صورت باید موارد زیر را در postback مربوط به Keitaro مشخص کنید:

   https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record={_record}

   که در آن:

   • YOUR_UNIQUE_TOKEN — توکن از پروفایل AdsGram شماست
   • record — پارامتری که در Tracking Link ارسال می‌کنید
   • {_record} — ماکرویی که مقدار اصلی پارامتر record را به postback ارسال می‌کند

   هشدار

   برای دریافت مقدار خام از سیستم ردیابی، قبل از نام ماکرو "_" (زیرخط) اضافه کنید. این مورد فقط برای ردیاب 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 به‌درستی منتقل می‌شود.

AppsFlyer

یکپارچه‌سازی AdsGram با AppsFlyer به شما امکان می‌دهد داده‌های مربوط به نصب اپلیکیشن و اقدامات کاربران درون اپلیکیشن را به AdsGram ارسال کنید.

پس از پیکربندی یکپارچه‌سازی، AdsGram موارد زیر را دریافت خواهد کرد:

• نصب‌های اپلیکیشن (Installs) - به‌طور خودکار به Goal 1 اختصاص می‌یابند
• سایر In-App Events - به‌طور خودکار به Goal 2 اختصاص می‌یابند

هیچ پیکربندی اضافی یا نگاشت رویداد به هدف در AdsGram لازم نیست. برای مثال، اگر رویدادهایی مانند registration، purchase، deposit و غیره از AppsFlyer ارسال شوند، همگی به‌طور خودکار در Goal 2 شمارش می‌شوند.

IMPORTANT

کمپین‌های tCPA فقط می‌توانند روی Goal 1 اجرا شوند. این یعنی کمپین‌های tCPA فقط می‌توانند برای نصب اپلیکیشن بهینه‌سازی شوند. In-App Events ارسال‌شده به Goal 2 را نمی‌توان به‌عنوان هدف برای کمپین‌های tCPA استفاده کرد.

۱. اتصال AdsGram از طریق Integrated Partners

AdsGram یک شریک یکپارچه (integrated partner) در AppsFlyer است. برای اتصال:

• در پنل AppsFlyer به بخش Collaboration → Partner Marketplace بروید
• در نوار جستجو AdsGram (نام بازاریابی) یا adsgram1e_int (نام فنی) را وارد کرده و این شریک را انتخاب کنید

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

تب Integration را باز کنید:

• سوییچ Activate Partner را فعال کنید
• AAP را غیرفعال کنید (باید هم در تنظیمات اپلیکیشن و هم در این تب غیرفعال شود)
• در Install Postback، گزینه This partner only را انتخاب کنید. این یعنی AdsGram نصب‌های نسبت داده‌شده به AdsGram را دریافت می‌کند. این نصب‌ها در AdsGram به‌عنوان Goal 1 شمارش می‌شوند.

IMPORTANT

اگر می‌خواهید کمپینی با بهینه‌سازی برای نصب راه‌اندازی کنید، مطمئن شوید که نصب‌ها به AdsGram ارسال می‌شوند و در Goal 1 نمایش داده می‌شوند. کمپین‌های tCPA بهینه‌شده برای نصب فقط می‌توانند روی Goal 1 راه‌اندازی شوند.

۳. پیکربندی Postback رویدادهای درون‌برنامه‌ای

postback مربوط به In-App Events (خریدها، ثبت‌نام‌ها و غیره) را در بخش In-App Event Postbacks پیکربندی کنید:

• رویدادهای مورد نیاز را اضافه کنید، برای مثال:
  • purchase - خریدها
  • af_complete_registration - ثبت‌نام‌ها
• در فیلد For users from، گزینه This partner only را انتخاب کنید
• AdsGram فقط خود رویداد را بدون پارامترها یا درآمد آن دریافت می‌کند. بنابراین در فیلد Including می‌توانید No values & no revenue را انتخاب کنید

توصیه می‌شود:

• اجازه پیکربندی integration داده شود (به‌جز postback رویدادهای درون‌برنامه‌ای)
• اجازه پیکربندی postback رویدادهای درون‌برنامه‌ای داده شود

سایر مجوزها (گزارش‌های retention، درآمد و غیره) اختیاری هستند.

پس از پیکربندی یکپارچه‌سازی، روی Save Integration کلیک کنید.

۴. پیکربندی Tracking Link

تب Tracking Link را باز کنید:

• AppsFlyer به‌طور خودکار یک لینک ردیابی برای AdsGram ایجاد کرده و شناسه شریک لازم را اضافه می‌کند: pid=adsgram1e_int
• ۴ ماکروی AdsGram به‌طور خودکار پر می‌شوند (af_storeid، c و غیره)
• در صورت نیاز، پارامترهای ثابت را به‌عنوان پارامتر اضافی اضافه کنید
• در Click-through attribution، پنجره اسناد را انتخاب کنید. مقدار پیش‌فرض ۷ روز است، اما در صورت نیاز می‌توانید آن را تغییر دهید

۵. پیکربندی Permissions

تب Permissions را باز کرده و مجوزهای الزامی را فعال کنید:

• دسترسی به اپلیکیشن‌ها در داشبورد
• تبدیل‌های تجمیعی
• رویدادها
• Protect360

👉 روی Save Integration کلیک کنید

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

هنگام ایجاد کمپین در AdsGram:

• Click link را در فیلد Link وارد کنید. سیستم به‌طور خودکار یک لینک ردیابی AppsFlyer ایجاد کرده و ماکروهای لازم را اضافه می‌کند
• در لینک ردیابی AppsFlyer، در صورتی که نام package/bundle شما از قبل درج نشده باشد، آن را مشخص کنید (مثلاً id12345678 یا com.app.name)
• در فیلد Link که ظاهر می‌شود، لینک مستقیم محصول خود را در Google Play / App Store / RuStore وارد کنید

۷. نکات

• این تنظیمات برای همه بنرهای داخل کمپین اعمال می‌شود
• تبلیغ‌دهنده مسئول صحت پارامترهای لینک و اسناد (attribution) است
• در صورت استفاده از لینک سفارشی، باید حتماً یک لینک مستقیم محصول را نیز در فیلد Link مشخص کنید