Project

bing-ads-reporting

0.02
No release in over 3 years
Low commit activity in last 3 years
bing-ads-reportingforward3d/bing-ads-reportingHomepageDocumentationSource CodeBug TrackerWiki
Bing Ads Reports
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
22,575
Stars
9
Forks
11
Watchers
23
 Releases
Current version
1.3.0
Total releases
6
First release
2013-10-21
Latest release
2017-10-27
 Issues
Open Issues
4
Closed Issues
1
Total Issues
5
Issue Closure Rate
20%
 Pull Requests
Open Pull Requests
6
Closed Pull Requests
28
Merged Pull Requests
13
Pull Request Acceptance Rate
27%
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2019-12-02
Reverse Dependencies
0

 Dependencies

Runtime

curb
>= 0
datebox
>= 0
savon
>= 0
 Project Readme

Bing Ads Reports

Installation

gem install bing-ads-reporting

Usage

Initializing service.

All Reporting Service - Bing Ads Reference for Reporting Service 

service = BingAdsReporting::ReportingService.new({
  developerToken: '',
  applicationToken: '',
  authenticationToken: '',
  :accountId: '',
  customerId: ''})

Bulk Service - Bing Ads API reference for Bulk Service 

service = BingAdsReporting::BulkService.new({
  developerToken: '',
  applicationToken: '',
  authenticationToken: '',
  :accountId: '',
  customerId: ''
})

Create report and get it's ID

Reporting Service

period = Datebox::Period.new('2013-07-01', '2013-07-03')
id = service.generate_report({report_type: 'KeywordPerformance',
                              report_format: 'Tsv',
                              aggregation: 'Daily',
                              aggregation_period: 'ReportAggregation::Daily',
                              columns: %w[AccountId AccountName CampaignId CampaignName AdGroupId AdGroupName KeywordId Keyword DestinationUrl DeliveredMatchType AverageCpc CurrentMaxCpc AdDistribution CurrencyCode Impressions Clicks Ctr CostPerConversion Spend AveragePosition TimePeriod CampaignStatus AdGroupStatus DeviceType]},
                              {period: period})

Bulk Service

id = service.generate_report({report_type: 'DownloadCampaignsByAccountIds'
                              report_format: 'Tsv',
                              data_scope: 'EntityData'
                              download_entities: ['Keywords']},
                              {})

Get Report

Get report URL for download by report ID if it's ready

service.report_url(id) if service.report_ready?(id)

or get its content by ID (also once ready)

service.report_body(id) if service.report_ready?(id)