yadirGetKeyWordsBids {ryandexdirect}

Get KeyWords Bids

Description

Returns bids and priorities for key phrases and auto-targeting that meet specified criteria, as well as bidding data: bids and write-off prices for different traffic volumes on a search and bids to reach different audience shares in networks.

Usage

yadirGetKeyWordsBids(
    KeywordIds    = NULL,
    AdGroupIds    = NULL,
    CampaignIds   = NULL,
    AuctionBids   = c(NA, 
		                  "search", 
		          			  "network"),
    Login         = getOption("ryandexdirect.user"),
    Token         = NULL,
    AgencyAccount = getOption("ryandexdirect.agency_account"),
    TokenPath     = yadirTokenPath())

Arguments

KeywordIds

Phrase ID. Specified if you want to update the bid for an individual phrase.

AdGroupIds

Ad Group ID. Specified if you need to update bids for all group phrases.

CampaignIds

Campaign ID. Specified if you need to update bids for all campaign phrases.

AuctionBids

Data on auctions, specify information about which auctions you are requesting. The values are: NA, "search", "network"

Login

Your Yandex Login

AgencyAccount

Your agency account login, if you get statistic from client account

Token

Your Yandex API Token

TokenPath

Path to directory where you save credential data

Details

Use AuctionBids = "search" when you need traffic volume, bid on the search corresponding to the specified amount of traffi and charged price corresponding to the specified amount of traffic. Use AuctionBids = "search" when you need get frequency of the show (audience share) in networks (specified in percent from 0 to 100) and network bid that matches the frequency shown.

Value

Data Frame with keyword bids and auction data

Author(s)

Alexey Seleznev

References

KeyWord Bids API documentation KeyWord Bids get method API documentation

Examples

## Not run: 
### Please choose another TokenPath to save the Login permanently.
## Only bids for keywords with ids 123, 234, 345
bids <- yadirGetKeyWordsBids(KeywordIds = c(123, 234, 345))

### Get bids with search auction data
search_bids <- 
    yadirGetKeyWordsBids(KeywordIds = c(123, 234, 345)
	                     AuctionBids = "search")
						 
### Get bids with network auction data
network_bids <- 
    yadirGetKeyWordsBids(KeywordIds = c(123, 234, 345)
	                     AuctionBids = "network")

## End(Not run)