Field | Type | Description |
---|---|---|
AdTitle |
STRING | Title of an advertisement |
AdTitle2 |
STRING | The additional title of an advertisement |
AdGroupName |
STRING |
Name of an advertisement group. Note: The field value will be empty for campaigns created via Yandex.Direct's Campaign Wizard. |
Keyword |
STRING | The keyword for which the ad was displayed (Text & Image Ads or Ads for Mobile Apps). keyword text without negative keywords |
Device |
STRING | Device type on which impression was made. Transferred value: desktop — desktop, mobile — mobile phone, tablet — tablet |
Clicks |
INTEGER | The number of clicks. |
Cost |
FLOAT | The cost of clicks. |
AccountCurrency |
STRING | The currency used to display ad costs in the ad account. For example: USD, EUR. |
Impressions |
INTEGER | Number of impressions. |
CriteriaType |
STRING | The type of targeting criteria set by the advertiser: KEYWORD — Keyword AUTOTARGETING — Autotargeting AUDIENCE_TARGET — Audience target DYNAMIC_TEXT_AD_TARGET — Audience target for dynamic ads or the filter for dynamic ads SMART_BANNER_FILTER — Filter for smart banners |
CampaignType |
STRING | The type of campaign: TEXT_CAMPAIGN SMART_CAMPAIGN* DYNAMIC_TEXT_CAMPAIG MOBILE_APP_CAMPAIGN MCBANNER_CAMPAIGN CPM_BANNER_CAMPAIGN CPM_DEALS_CAMPAIGN CPM_FRONTPAGE_CAMPAIGN Read more *Starting December 2, 2019, the Yandex.Direct API uses the new SMART_CAMPAIGN value instead of the deprecated SMART_BANNER_CAMPAIGN |
PhraseId |
STRING | The phrase ID. |
CampaignName |
STRING | The campaign name. |
UserParam1 |
STRING | Special parameter. The value equal to the dynamic parameter {param1} |
UserParam2 |
STRING | Special parameter. The value equal to the dynamic parameter {param1} |
MatchType |
STRING | Keyword match type: RELATED_KEYWORD — Impression for a related keyword. SYNONYM — Impression for a keyword synonym. NONE — All other cases. |
CampaignId |
STRING | The campaign ID. |
AdId |
STRING |
The ad ID. Note: The field value will be empty for campaigns created via Yandex.Direct's Campaign Wizard. |
Slot |
STRING | The ad display place: PREMIUMBLOCK — Premium Placement. OTHER — Other ad blocks. |
AdNetworkType |
STRING | The type of advertising place where the ad is shown: SEARCH — In search results. AD_NETWORK — On ad networks. |
Age * |
STRING | The user's age group: one of the values AGE_0_17, AGE_18_24, AGE_25_34, AGE_35_44, AGE_45 or UNKNOWN. * — currently, this field is unavailable for export. If you need to export the user age data, write to us at bi@owox.com and we'll process your request. |
CarrierType |
STRING | The type of connection: CELLULAR — Mobile connection. STATIONARY — Wi-Fi or wired internet access. UNKNOWN — The type couldn't be detected. |
Date |
DATE | The data statistics are provided for, in the format YYYY-MM-DD. |
ExternalNetworkName |
STRING | The name of the ad exchange (SSP). |
Gender |
STRING | The user's gender: GENDER_MALE, GENDER_FEMALE or UNKNOWN. |
MobilePlatform |
STRING | OS type: ANDROID, IOS, OTHER or UNKNOWN. |
AvgClickPosition |
STRING | Average position where the ad was clicked. Calculated using only clicks on the first page of Yandex search results. The top position is assigned the number 1. |
AvgCpc |
STRING | Average cost per click rounded in micro currency (original value x 1,000,000). To get the original value, divide the value of this field by 1,000,000. |
AvgImpressionPosition |
STRING | Average display position of the ad. Calculated using only displays on the first page of Yandex search results. The top position is assigned the number 1. |
AvgPageviews |
STRING | The average session depth on the site, meaning the number of pages viewed (according to Yandex.Metrica data). |
BounceRate |
STRING | The percentage of bounces in the total number of sessions (according to Yandex.Metrica data). |
Bounces |
STRING | The number of bounces (according to Yandex.Metrica data). |
ConversionRate |
STRING | Conversions as a percent of the total number of sessions (according to Yandex.Metrica data). |
Conversions |
STRING |
The number of conversions (according to Yandex.Metrica data). Data in this field is based on the Last Click attribution. Changing the attribution settings is not supported. |
CostPerConversion |
STRING | The average cost of reaching a goal (according to Yandex.Metrica data): the ratio of the cost of clicks to the number of conversions. |
Ctr |
STRING | CTR as a percent. |
GoalsRoi |
STRING | The return on investment in advertising, up to two decimal places (according to Yandex.Metrica data). |
Revenue |
STRING | Revenue (according to Yandex.Metrica data). |
Sessions |
STRING | Number of sessions (according to Yandex.Metrica data). For mobile app ads, the number of clicks is shown as the number of visits. |
utm |
RECORD | utm-tags |
utm.utm_content |
STRING | The value of utm_content |
utm.utm_campaign |
STRING | The value of utm_campaign |
utm.utm_medium |
STRING | The value of utm_medium |
utm.utm_term |
STRING | The value of utm_term |
utm.utm_source |
STRING | The value of utm_source |
Retargetings |
RECORD | Retargeting lists |
Retargetings.Id |
INTEGER | ID of the retargeting list.. |
Retargetings.IsAvailable |
STRING | YES — All the goals and segments in the retargeting list are available; NO — The retargeting list has a goal or segment that is unavailable, so ad displays and bid adjustments aren't possible for this retargeting list. A goal or segment becomes unavailable if it is deleted, or if the owner revokes access. |
Retargetings.Name |
STRING | Name of the retargeting list (maximum of 250 characters). |
Retargetings.Scope |
STRING | Scope of the retargeting list. See the section Scope. |
DynamicTextAdTarget |
RECORD | Targeting conditions for dynamic ads. |
DynamicTextAdTarget.Id |
INTEGER | ID of the targeting condition. |
DynamicTextAdTarget.Bid |
FLOAT | Bid in search results. |
DynamicTextAdTarget.ContextBid |
FLOAT | This parameter is reserved for future use. |
DynamicTextAdTarget.StrategyPriority |
STRING | The priority of the targeting condition: LOW, NORMAL or HIGH. |
DynamicTextAdTarget.State |
STRING | State of a targeting condition. |
DynamicTextAdTarget.StatusClarification |
STRING | Text explanation of the state.. |
DynamicTextAdTarget.ConditionType |
STRING | Type of targeting condition. |
RlAdjustmentId |
STRING | ID of a retargeting list used for applying bid adjustments for website users. |
ImpressionShare |
STRING | The percentage of auctions won out of the total number of auctions that the ad materials participated in. Data is only available for smart banners. |
CriterionId |
STRING |
The ID of the targeting criteria set by the advertiser: Note: The field value will be empty for campaigns created via Yandex.Direct's Campaign Wizard. |
AdGroupId |
STRING |
ID of the ad group. Note: The field value will be empty for campaigns created via Yandex.Direct's Campaign Wizard. |
Placement |
STRING | Name of the site where the ad is being displayed. |
LocationOfPresenceName |
STRING | Name of the region where the user is located. |
LocationOfPresenceId |
STRING | ID of the region where the user is located. |
Criterion |
STRING | The name or text of the targeting criteria set by the advertiser: For targeting a keyword or synonym – the keyword text. For displays for a related keyword – the keyword text, or the value “automatically added phrase” if the keyword couldn't be determined. For autotargeting – the “---autotargeting” value. For targeting an audience target – the name of the retargeting list, or the name of a mobile app category. For showing a dynamic ad – the name of the audience target for dynamic ads, or the name of the filter. For showing smart banners – the name of the filter. |
Href |
STRING | ads url |
AdAccount |
STRING | Yandex.Direct account ID |
DebugInfo |
STRUCT | Additional data upload info |
Yandex.Direct → Google BigQuery: data schema
Have more questions? Submit a request
Please sign in to leave a comment.
0 Comments