Metadata-Version: 2.1
Name: django-admob-ssv
Version: 1.0.3
Summary: Admob Server-Side Verification for Django projects
Home-page: https://github.com/DoctorJohn/django-admob-ssv
Author: Jonathan Ehwald
Author-email: pypi@ehwald.info
License: MIT License
Description: # 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](https://developers.google.com/admob/android/rewarded-video-ssv):
        
        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](https://pypi.org/project/Django/) (version 1.11+)
        - [ecdsa](https://pypi.org/project/ecdsa/)
        
        ## Installation
        
        ```pip install django-admob-ssv```
        
        ## Configuration
        
        1. Add a ```path``` for the ```django_admob_ssv.views.admob_ssv``` view to your ```urlpatterns```.
        
        ```python
        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.
        
        ```python
        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](https://developers.google.com/admob/android/rewarded-video-ssv).
        
        Also make sure you [connect your receiver properly](https://docs.djangoproject.com/en/2.2/topics/signals/#connecting-receiver-functions), 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```.
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP
Description-Content-Type: text/markdown
