Django Admob Server-Side Verification (SSV)

A Django app providing a view that handles Admob Server-Side Verification callbacks. Successfull verifications trigger a custom signal. Separate apps may listen to that signal and reward the user based on the information received via the callback.

Taken from the Admob SSV documentation:

Server-side verification callbacks are URL requests, with query parameters expanded by Google, that are sent by Google to an external system to notify it that a user should be rewarded for interacting with a rewarded video ad. Rewarded video SSV (server-side verification) callbacks provide an extra layer of protection against spoofing of client-side callbacks to reward users.

Requirements

• Python 3
• Django (version 1.11+)
• ecdsa

Installation

pip install django-admob-ssv

Configuration

1. Add a path for the django_admob_ssv.views.admob_ssv view to your urlpatterns.

from django.urls import path
from django_admob_ssv.views import admob_ssv

urlpatterns = [
    path('admob-ssv/', admob_ssv),
]

2. Listen to the django_admob_ssv.signals.valid_admob_ssv signal.

from django.dispatch import receiver
from django_admob_ssv.signals import valid_admob_ssv

@receiver(valid_admob_ssv)
def reward_user(sender, query, **kwargs):
    ad_network = query.get('ad_network')
    ad_unit = query.get('ad_unit')
    custom_data = query.get('custom_data')
    # ...

Take a look at this list of all SSV callback parameters.

Also make sure you connect your receiver properly, otherwise it won't get called. (Take a look at the "Where should this code live?" box).

Examples

Take a look at the "Configuration" section above and the provided example_project.