ads-platform-tools
Tools and utilities for the Twitter Ads Platform.
Also useful, see https://github.com/twitterdev/ton-upload for using the TON API.
Installation
Clone the repository:
$ git clone https://github.com/twitterdev/ads-platform-tools.git
$ cd ads-platform-tools/
If using the Python tools, install the following packages:
$ pip install -r python/requirements.pip
Usage
The following examples assume ads-platform-tools/ is the working directory.
hash_tailored_audience_file
Sample tools to hash data for tailored audience uploads, in either Python or
Perl. Details on these normalization rules can be found
here or
here.
Data types supported:
- MOBILEDEVICEID
- IDFA
- ADID
- ANDROID
- PHONE
- TWITTERID
- TWITTERSCREENNAME
Python:
$ python python/hash_tailored_audience_file.py --type EMAIL --infile path/to/emails_source.txt --outfile path/to/emails_hashed.txt
Perl:
$ perl perl/hash_tailored_audience_file.pl EMAIL path/to/emails_source.txt
hash_mact_device
Sample script to debug the HMAC hashing of MACT device_ids. Input is a single, unhashed normalized device_id and output will include both the hashed device id and the hashed extra device id.
Python:
$ python python/hash_mact_device.py --env prod --value abc123456789
fetch_stats
Sample script implementing best practices for pulling ads analytics for an advertiser account.
Python:
$ python python/fetch_stats.py -a abc1
Params:
-a abc1 # the :account_id to run the stats fetcher on
-s # pull segmented stats
-v # output avg query costs
-vv # output stats API calls made
Sample output:
Best practices stats check for :account_id abc1
-----------------------------------------------
Current time: 2015-04-16 02:32:16.815510
Start time: 2015-04-09 02:00:00
End time: 2015-04-16 01:59:59
-----------------------------------------------
Pre-filtered data: 2
Funding instruments: 1
Pre-filtered data: 15381
Campaigns: 67
Pre-filtered data: 14768
Line items: 37
Pre-filtered data: 11518
Promoted Tweets: 33
fetching stats for 37 line items
fetching stats for 33 promoted tweets
-----------------------------------------------
Total Stats Queries: 4
Total Stats Request Cost: 2780
Queries Rate Limited: 0
-----------------------------------------------
Time elapsed: 11.44861