yadirSetKeyWordsBids: Set KeyWords Bids

Description

Assigns fixed bids and priorities for keyword phrases and auto-targeting.

Usage

yadirSetKeyWordsBids(
    KeywordIds       = NULL,
    AdGroupIds       = NULL,
    CampaignIds      = NULL,
    StrategyPriority = c(NA,
                        "LOW",
                        "NORMAL",
                        "HIGH"),
    SearchBid        = NULL,
    NetworkBid       = NULL,
    Login            = getOption("ryandexdirect.user"),
    Token            = NULL,
    AgencyAccount    = getOption("ryandexdirect.agency_account"),
    TokenPath        = yadirTokenPath())

Value

List with result data, object ids, warnings and errors.

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.
StrategyPriority: The priority of the phrase: LOW, NORMAL or HIGH. Only for automatic strategy.
SearchBid: Bid on search.
NetworkBid: Bid on 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.

Author

Alexey Seleznev

Details

You can set a bet or priority:

for a separate keyword phrase or autotarget.
for all keyword phrases and autotargeting in an ad group.
for all keyword phrases and autotargets in the campaign.

You can set a bid or priority depending on which display strategy is selected in the campaign:

if the display strategy is selected on the HIGHEST_POSITION search, you can specify the SearchBid parameter.
if you selected a display strategy on MAXIMUM_COVERAGE or MANUAL_CPM networks, you can specify the NetworkBid parameter.
if the automatic strategy is selected, you can specify the StrategyPriority parameter: phrases with a higher priority receive as much traffic as possible, and in case of a budget deficit, they are turned off last.

If the element of the input array contains parameters that do not correspond to the strategy, the values of these parameters will not be changed:

If the input array element contains both parameters corresponding to the strategy and parameters that do not correspond to the strategy (for example, both the bid and priority), then as a result of the operation, the values of only the parameters corresponding to the strategy will be changed and a warning will be issued.
If the input array element contains only parameters that do not correspond to the strategy (for example, only the priority for a manual strategy), the operation will fail and an error will be returned.

References

Examples

Run this code

if (FALSE) {
# loading keywords list
kw <- yadirGetKeyWords()
# set bid on search
setbid <- yadirSetKeyWordsBids(KeywordIds = kw$Id,
                               SearchBid  = 9)
}

Run the code above in your browser using DataLab