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
23,203
Stars
10
Forks
11
Watchers
24
 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)