سیستم صحت سنجی

نحوه کارکرد

سرویس صحت سنجی تبلیغات تپسل (S2S Verification) برای اپلیکیشن‌ها و بازی‌های آنلاین طراحی شده است تا توسعه دهندگان از صحت تبلیغ نشان‌داده شده اطمینان حاصل نمایند و امکان سوء استفاده از تبلیغات در نسخه‌های mod شده بازی غیرممکن شود.

نحوه کارکرد سیستم صحت سنجی به این صورت است که پس از نمایش تبلیغ در اپلیکیشن، میبایست شناسه تبلیغ (suggestionId) برای سرور بازی یا اپلیکیشن ارسال شود؛ سپس سرور بازی/اپلیکیشن با ارسال یک درخواست به سرور تپسل، از معتبر بودن شناسه ارسال شده اطمینان حاصل نماید.

جهت ارتباط سرور به سرور از آدرس زیر استفاده نمایید.

http://api.tapsell.ir/v2/suggestions/validate-suggestion

درخواست ارسال شده باید بصورت POST و محتوای ارسالی بصورت json باشد. (Content-Type:application/json)

ناشرینی که قصد استفاده از سیستم صحت سنجی تبلیغات تپسل را دارند میبایست درخواست خود را از طریق تماس تلفنی یا ارسال ایمیل به آدرس publishers@tapsell.ir به واحد فنی تپسل اطلاع دهند.

شناسه تبلیغ باید در بدنه درخواست و بصورت زیر گنجانده شود.

{
  "suggestionId":"SUGGESTION_ID"
}

پاسخ برگردانده شده به درخواست ارسال شده نیز بصورت json و مطابق نمونه‌ی زیر است.

{
  "valid": true
}

در صورتی که مقدار پارامتر valid در پاسخ برگردانده شده برابر true باشد، یعنی شناسه ارسال شده معتبر است. در غیر اینصورت شناسه تبلیغ ارسالی معتبر نبوده‌است.

دقت کنید که هر شناسه تبلیغ کدی یکبار مصرف است و اگر یکبار آن شناسه معتبر شناخته شود، در دفعات بعدی معتبر شناخته نخواهد شد.

برای استفاده از پروژه‌ی نمونه‌ی Postman روی دکمه‌ی زیر کلیک کنید.

Run in Postman

دریافت شناسه تبلیغ

مقدار SUGGESTION_ID را در کال‌بک onAdAvailable به کمک روش زیر می‌توانید دریافت کنید.

Tapsell.requestAd(CONTEXT,
        ZONE_ID,
        new TapsellAdRequestOptions(),
        new TapsellAdRequestListener() {
            @Override
            public void onAdAvailable(String adId) {
              suggustionId = adId;
            }

            @Override
            public void onError(String message) {
            }
        });

همچنین برای اطلاع از وضعیت دریافت جایزه می‌توانید از کال‌بک onRewarded استفاده نمایید.

Tapsell.showAd(CONTEXT,
        ZONE_ID,
        AD_ID,
        new TapsellShowOptions(),
        new TapsellAdShowListener() {
            @Override
            public void onOpened() {
            }

            @Override
            public void onClosed() {
            }

            @Override
            public void onError(String message) {
            }

            @Override
            public void onRewarded(boolean completed) {

              // Now S2S Service Returns True If completed variable Is True
            }
        });