GetEventsLog (Live)
Returns entries from the events log.
Yandex Direct automatically registers events related to shared accounts, campaigns and ads, such as moderation results, new credits to the account balance, and others. The events log is separate for each user. The GetEventsLog method returns entries from the events log for the specified period of time.
New in the Live 4 version
The Currency input parameter is required.
Added the Currency input parameter and the Currency output parameter.
Added the AccountIDS input parameter and the AccountID output parameter.
Input data
The input data structure in JSON is shown below.
{
"method": "GetEventsLog",
"param": {
/* GetEventsLogRequest */
"TimestampFrom": (string),
"TimestampTo": (string),
"LastEventOnly": (string),
"WithTextDescription": (string),
"Currency": (string),
"Logins": [
(string)
...
],
"Filter": {
/* GetEventsLogFilter */
"CampaignIDS": [
(int)
...
],
"BannerIDS": [
(long)
...
],
"PhraseIDS": [
(long)
...
],
"AccountIDS": [
(int)
...
],
"EventType": [
(string)
...
]
},
"Limit": (int),
"Offset": (int)
}
}
Parameters are described below.
Parameter | Description | Required |
GetEventsLogRequest object | ||
---|---|---|
TimestampFrom | The time at which to start recording events. Specified in ISO 8601 format, for example: | Yes |
TimestampTo | The time at which to stop recording events. Specified in ISO 8601 format, for example: If the parameter is omitted, all entries are returned up to the current time. | No |
LastEventOnly | Get only the last entry for each type of event — Yes/No. If omitted, returns all entries for the specified time period. | No |
WithTextDescription | Output event descriptions to the response — Yes/No. If the parameter is omitted, descriptions are not output. | No |
Currency | The currency to use for monetary values (minimum price, remaining funds, amount credited) in the response. Acceptable values: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. | Yes |
Logins | Array of usernames belonging to advertising agency clients. The method returns entries of events for the specified clients. If omitted, it returns entries of events for the user who made the request. | Advertising agencies only |
Filter | The GetEventsLogFilter object with filtering conditions for event entries. If omitted, filtering is not applied, and the method returns all entries for the specified time period. | No |
Limit | The number of events to return (page size). You can combine this with the Offset parameter to set up paginated selections. The list of events, sorted by time. If omitted, all events are returned. | No |
Offset | The number of events to skip when getting the selection. It is ignored if Limit is not defined. | No |
GetEventsLogFilter object | ||
CampaignIDS | IDs of campaigns that you need to get event entries for. | No |
BannerIDS | IDs of ads that you need to get event entries for. | No |
PhraseIDS | IDs of keywords that you want to get event entries for. | No |
AccountIDS | Identifiers of shared accounts that you need to get event entries for. | No |
EventType | Types of events to get entries for. Acceptable values are shown below:
| No |
Parameter | Description | Required |
GetEventsLogRequest object | ||
---|---|---|
TimestampFrom | The time at which to start recording events. Specified in ISO 8601 format, for example: | Yes |
TimestampTo | The time at which to stop recording events. Specified in ISO 8601 format, for example: If the parameter is omitted, all entries are returned up to the current time. | No |
LastEventOnly | Get only the last entry for each type of event — Yes/No. If omitted, returns all entries for the specified time period. | No |
WithTextDescription | Output event descriptions to the response — Yes/No. If the parameter is omitted, descriptions are not output. | No |
Currency | The currency to use for monetary values (minimum price, remaining funds, amount credited) in the response. Acceptable values: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. | Yes |
Logins | Array of usernames belonging to advertising agency clients. The method returns entries of events for the specified clients. If omitted, it returns entries of events for the user who made the request. | Advertising agencies only |
Filter | The GetEventsLogFilter object with filtering conditions for event entries. If omitted, filtering is not applied, and the method returns all entries for the specified time period. | No |
Limit | The number of events to return (page size). You can combine this with the Offset parameter to set up paginated selections. The list of events, sorted by time. If omitted, all events are returned. | No |
Offset | The number of events to skip when getting the selection. It is ignored if Limit is not defined. | No |
GetEventsLogFilter object | ||
CampaignIDS | IDs of campaigns that you need to get event entries for. | No |
BannerIDS | IDs of ads that you need to get event entries for. | No |
PhraseIDS | IDs of keywords that you want to get event entries for. | No |
AccountIDS | Identifiers of shared accounts that you need to get event entries for. | No |
EventType | Types of events to get entries for. Acceptable values are shown below:
| No |
Output data
The method returns an array of EventsLogItem objects, each of which represents a single event entry. The output data structure in JSON is shown below.
{
"data": [
{ /* EventsLogItem */
"AccountID": (int),
"CampaignID": (int),
"BannerID": (long),
"PhraseID": (long),
"TextDescription": (string),
"EventType": (string),
"Timestamp": (string),
"EventName": (string),
"Attributes": {
/* EventsLogItemAttributes */
"ModerationResult": (string),
"MinPrice": (float),
"Rest": (float),
"Payed": (float),
"FinishDate": (date),
"OldPlace": (string),
"IsEditedByModerator": (string),
"StopTime": (string),
"Currency": (string)
}
}
...
]
}
Parameters are described below.
Parameter | Description |
EventsLogItem object | |
---|---|
AccountID | Identifier of the shared account that the event is related to. May be omitted. |
CampaignID | ID of the campaign that the event is associated with. May be omitted. |
BannerID | ID of the ad that the event is associated with. May be omitted. |
PhraseID | ID of the keyword that the event is associated with. May be omitted. |
TextDescription | Description of the event. |
EventType | Type of event. One of these values:
|
Timestamp | Time when the event was registered (ISO 8601 format), for example: 2011-05-25T23:59:59Z . |
EventName | Brief description of the event. |
Attributes | EventsLogItemAttributes object with event parameters. The set of parameters depends on EventType. |
EventsLogItemAttributes object | |
ModerationResult | Moderation results. Output for the BannerModerated event. |
MinPrice | The actual minimum CPC. Output for the WarnMinPrice event. The value is converted to the currency specified in the Currency parameter and rounded up to the nearest bid increment in this currency. |
Rest | Remaining funds on the campaign balance. Output for the MoneyWarning event. The value is converted to the currency specified in the Currency parameter and mathematically rounded to the second decimal point. If the value is expressed in a real currency, it does not include VAT. |
Payed | Amount of funds credited. Output for the MoneyIn event. The value is converted to the currency specified in the Currency parameter and mathematically rounded to the second decimal point. If the value is expressed in a real currency, it does not include VAT. |
FinishDate | Date when the campaign was stopped. Output for the CampaignFinished event. |
OldPlace | Previous display position of the ad. Output for the WarnPlace event. |
IsEditedByModerator | Indicates whether the ad was changed by the moderator (Yes/No). Output for the BannerModerated event. |
StopTime | The date and time when the campaign was stopped. Output for the PausedByDayBudget event. |
Currency | The currency that monetary values are shown in. Acceptable values: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. |
Parameter | Description |
EventsLogItem object | |
---|---|
AccountID | Identifier of the shared account that the event is related to. May be omitted. |
CampaignID | ID of the campaign that the event is associated with. May be omitted. |
BannerID | ID of the ad that the event is associated with. May be omitted. |
PhraseID | ID of the keyword that the event is associated with. May be omitted. |
TextDescription | Description of the event. |
EventType | Type of event. One of these values:
|
Timestamp | Time when the event was registered (ISO 8601 format), for example: 2011-05-25T23:59:59Z . |
EventName | Brief description of the event. |
Attributes | EventsLogItemAttributes object with event parameters. The set of parameters depends on EventType. |
EventsLogItemAttributes object | |
ModerationResult | Moderation results. Output for the BannerModerated event. |
MinPrice | The actual minimum CPC. Output for the WarnMinPrice event. The value is converted to the currency specified in the Currency parameter and rounded up to the nearest bid increment in this currency. |
Rest | Remaining funds on the campaign balance. Output for the MoneyWarning event. The value is converted to the currency specified in the Currency parameter and mathematically rounded to the second decimal point. If the value is expressed in a real currency, it does not include VAT. |
Payed | Amount of funds credited. Output for the MoneyIn event. The value is converted to the currency specified in the Currency parameter and mathematically rounded to the second decimal point. If the value is expressed in a real currency, it does not include VAT. |
FinishDate | Date when the campaign was stopped. Output for the CampaignFinished event. |
OldPlace | Previous display position of the ad. Output for the WarnPlace event. |
IsEditedByModerator | Indicates whether the ad was changed by the moderator (Yes/No). Output for the BannerModerated event. |
StopTime | The date and time when the campaign was stopped. Output for the PausedByDayBudget event. |
Currency | The currency that monetary values are shown in. Acceptable values: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. |
Examples of input data
Python
{
'TimestampFrom': '2012-02-15T23:59:59Z',
'TimestampTo': '2012-02-18T23:59:59Z',
'Filter': {
'CampaignIDS': [3193279],
'EventType': ['MoneyIn', 'CampaignFinished']
}
}
PHP
array(
'TimestampFrom' => '2012-02-15T23:59:59Z',
'TimestampTo' => '2012-02-18T23:59:59Z',
'Filter' => array(
'CampaignIDS' => array(3193279),
'EventType' => array('MoneyIn', 'CampaignFinished')
)
)
Perl
{
'TimestampFrom' => '2012-02-15T23:59:59Z',
'TimestampTo' => '2012-02-18T23:59:59Z',
'Filter' => {
'CampaignIDS' => [3193279],
'EventType' => ['MoneyIn', 'CampaignFinished']
}
}