نحوه ایجاد BlockId؟
ثبتنام
حساب کاربری خود را در https://partner.adsgram.ai/registration ایجاد کنید
هشدار
اگر قبلاً به عنوان تبلیغدهنده به شبکه ما متصل شده و کمپینهایی راهاندازی کردهاید، مهم است که در حساب ناشر با همان نام کاربری که در حساب تبلیغدهنده استفاده کردهاید، وارد شوید.
به این ترتیب بهطور خودکار تبلیغاتی که به اپلیکیشن شما منجر میشوند را در داخل اپلیکیشن شما نمایش نخواهیم داد.
ایجاد Ad Platform
روی Create... کلیک کنید و Ad platform را انتخاب کنید.
App name — نامی مناسب برای App شما.
Telegram direct link — لینک مستقیم به اپلیکیشن تلگرام شما.
Web app url — آدرس URL اپلیکیشن شما که در آن میزبانی میشود.
اطلاعات
صاحب App میتواند Telegram direct link و Web app url را در BotFather با استفاده از دستور /myapps دریافت کند.
Bot ID — شناسه یکتا برای ربات شما در تلگرام.
اطلاعات
صاحب App میتواند Bot ID را در BotFather با استفاده از دستور /mybots و کلیک روی دکمه API Token دریافت کند.
بخش اول API Token قبل از علامت دو نقطه، Bot ID است.
ایجاد Test platform
اگر میخواهید در نسخه dev/test اپلیکیشن خود برای اشکالزدایی تنظیم و یکپارچهسازی تبلیغ تست کنید، یک Test platform ایجاد کنید.
پس از ایجاد، میتوان پلتفرم را با وضعیت Active و بدون نیاز به بررسی راهاندازی کرد. رویدادهای مربوط به پلتفرمهای تست شمارش نخواهند شد.
هشدار
هنگام ایجاد Test platform، از Telegram direct link، Web app url و Bot ID اپلیکیشن dev خود استفاده کنید، در غیر این صورت با خطایی مانند زیر مواجه خواهید شد 👇
ممنوعیت نمایش دستههای مخاطب بزرگسال و Gambling
با تماس با پشتیبانی ما @adsgramsupport یا support@adsgram.ai، میتوانید درخواست کنید نمایش تبلیغدهندگان از دستههای Gambling یا Adult روی mini-app شما غیرفعال شود.
خطر
غیرفعال کردن آنها منجر به کاهش قابل توجه درآمد شما خواهد شد.
ایجاد Ad unit
روی Create... کلیک کنید و Ad unit را انتخاب کنید.
Name — نام بلاک مناسب برای شما.
Ad Platform — پلتفرم ایجاد شده قبلی. پلتفرم را در منوی کشویی انتخاب کنید.
Block type — نوع بلاکی که میخواهید نمایش دهید. نوع بلاک را در منوی کشویی انتخاب کنید. میتواند Reward، Interstitial یا Task باشد
Reward URL Optional
برای ناشرانی که بیش از ۵۰ هزار کاربر متوسط روزانه دارند معنادار است.
علاوه بر callback استاندارد سمت کلاینت که در تابع show استفاده میشود، پس از دریافت پاداش توسط کاربر در سمت کلاینت، یک درخواست GET با telegramId کاربر به reward url شما ارسال میکنیم. برای اتصال تأیید سرور پاداش برای کاربر، نقطه انتهایی شما باید شرایط زیر را داشته باشد:
- درخواست GET را بپذیرد.
- یک درخواست https باشد، به این معنی که پورت ۴۴۳ خواهد بود.
- دارای بخش [userId] باشد، بخش [userId] رشته با Telegram ID کاربر جایگزین خواهد شد. مثال:
https://test.adsgram.ai/reward?userid=[userId]
هشدار
در حالت debug درخواست ارسال نخواهد شد زیرا debug view به عنوان مشاهده تبلیغ واقعی شمارش نمیشود.
نکته
اگر در چندین مکان داخل web app تبلیغ نمایش میدهید. برای درک بهتر اینکه کاربران کجا تبلیغ تماشا میکنند و شما درآمد کسب میکنید، استفاده از چندین بلاک راحتتر است. آمار هر بلاک به صورت جداگانه در صفحه پلتفرم نمایش داده خواهد شد.
تا ۱۰ ad unit میتوان برای یک ad platform ایجاد کرد.
Moderation
پس از ایجاد بلاک، باید از بررسی عبور کند.
برای عبور از بررسی، پیامی به @adsgramsupport یا support@adsgram.ai با موارد زیر ارسال کنید:
لینک پلتفرم خود در قالب https://partner.adsgram.ai/platforms/xxx/
و پیام فوروارد شده از BotFather
با Telegram direct link و Web app url مانند زیر 👇
کپی BlockID
در گوشه بالا سمت راست روی <> Show code و سپس Copy BlockID کلیک کنید. از این blockId در کد خود استفاده کنید.