General purpose Python client for the AppNexus API.
This library exists because most of the open-source solutions we found were for specific AppNexus tasks, such as reporting. Our solution, however, is meant to be used with any AppNexus service.
As it heavily relies on the AppNexus API, we advise you to read its documentation.
This client uses models in the same way that database ORM would do, but you can also hook it to your own data representation class, or simply use Python dictionaries.
$ pip install appnexus-client
A service is an endpoint on the AppNexus API, representing an entity such as a
creative. Here is the complete list of services usable with AppNexus-client:
AccountRecovery
, AdProfile
, AdQualityRule
, AdServer
,
Advertiser
, Brand
, Broker
, Browser
, Campaign
, Carrier
,
Category
, City
, ContentCategory
, Country
, Creative
,
CreativeFormat
, Currency
, CustomModel
, CustomModelParser
,
Deal
, DealBuyerAccess
, DealFromPackage
, DemographicArea
,
DeviceMake
, DeviceModel
, DomainAuditStatus
, DomainList
,
ExternalInvCode
, InsertionOrder
, InventoryAttribute
,
InventoryResold
, IpRangeList
, Label
, Language
, LineItem
,
Lookup
, ManualOfferRanking
, MediaSubtype
, MediaType
, Member
,
MemberProfile
, MobileApp
, MobileAppInstance
,
MobileAppInstanceList
, MobileAppStore
, NativeCustomKey
,
ObjectLimit
, OperatingSystem
, OperatingSystemExtended
,
OperatingSystemFamily
, OptimizationZone
, Package
,
PackageBuyerAccess
, PaymentRule
, Pixel
, Placement
,
PlatformMember
, Profile
, ProfileSummary
, Publisher
, Region
,
ReportStatus
, Search
, Segment
, Site
, TechnicalAttribute
,
Template
, ThirdpartyPixel
, User
, UsergroupPattern
,
and VisibilityProfile
First of all, you need to connect the client to AppNexus. One simple way is to
use the connect
function with your credentials:
from appnexus import connect
connect("my-username", "my-password")
From there, you can use all the features of the library.
A model in AppNexus-client is an abstraction for a service. Most of them are already declared and you just have to import them.
You can access the fields of an AppNexus just like any object:
entity.field_name
For example, to print the name of each and every city registered in AppNexus, you could do:
from appnexus import City
for city in City.find():
print(city.name)
You can also retrieve a single result (the first one returned by the API) using
the find_one
method:
city = City.find_one(id=1337)
Sorting with AppNexus-client is easy: just give a sort
parameter with a
value indicating which field is sorted in which order (asc
or
desc
). This parameter will be supplied to the AppNexus API which will
return a sorted response.
You can filter entities using parameters of the methods find
and
find_one
. Each parameter stand as a new filter for the field it is named
after. For example, you can search for cities whose country_code field is
equal to "FR" and sort them by name:
for city in City.find(country_code="FR", sort="name.desc"):
print(city.name)
The parameters you give to the find
and find_one
methods are translated
into query parameters for the requests being send. For example, the snippet
Creative.find(state="active", advertiser_id=[1, 2, 3])
will result in a get
request on http://api.appnexus.com/creative?state=active&advertiser_id=1,2,3
Please search in the AppNexus API documentation to understand the meaning of each parameter.
By default, AppNexus-client relies on Thingy to represent data as objects.
But you can also hook your own data representation class. For this, you must use a function that exposes this signature:
function(client, service, object)
The client
argument is an AppNexusClient
instance. service
must be a
string representing the service to which the object belongs. object
is a
python dictionary containing data about an AppNexus entity. The return value of
this function will be used as the data representation.
To use this function and get the desired data representation, you must pass it
to the client as the representation
keyword argument.
For example, if you would want your data to be in the form of simple dictionaries you would do the following:
def dict_representation(client, service, object):
return object.view()
connect("username", "password", representation=dict_representation)
To run AppNexus-client tests:
- install developers requirements with
pip install -r requirements.txt
; - run
pytest
.
MIT