Gemius Direct Effect: Most-used fields#
The table below gives information about most-used fields that you can import from Gemius Direct Effect. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
CTR |
CTR |
The Click-Through Rate, calculated as clicks divided by impressions, indicating ad effectiveness. |
metric |
accumulatedClickingRealUsers |
accumulatedClickingRealUsers |
The cumulative number of unique real users who have clicked on the ad over the reporting period. |
metric |
accumulatedClickingRealUsersFlag |
accumulatedClickingRealUsersFlag |
An indicator flag for the accumulated number of unique real users who have clicked on the ad. |
dimension |
accumulatedClickingRealUsersReach |
accumulatedClickingRealUsersReach |
The cumulative reach (unique real users) that have clicked on the ad over the reporting period. |
metric |
accumulatedClickingRealUsersReachFlag |
accumulatedClickingRealUsersReachFlag |
An indicator flag for the accumulated reach of unique real users who have clicked on the ad. |
dimension |
accumulatedRealUsers |
accumulatedRealUsers |
The cumulative number of unique real users exposed to the ad over the reporting period. |
metric |
accumulatedRealUsersFlag |
accumulatedRealUsersFlag |
An indicator flag for the accumulated number of unique real users exposed to the ad. |
dimension |
accumulatedRealUsersReach |
accumulatedRealUsersReach |
The cumulative reach (unique real users) exposed to the ad over the reporting period. |
metric |
accumulatedRealUsersReachFlag |
accumulatedRealUsersReachFlag |
An indicator flag for the accumulated reach of unique real users exposed to the ad. |
dimension |
actions |
actions |
The total number of user actions, such as conversions or engagements, recorded. |
metric |
actionsAccumulated |
actionsAccumulated |
The cumulative total number of user actions recorded over the reporting period. |
metric |
campaignActionID |
campaignActionID |
A unique identifier for a specific action associated with a campaign. |
metric |
campaignID |
campaignID |
A unique identifier for the advertising campaign. |
metric |
campaignName |
campaignName |
The name of the advertising campaign. |
dimension |
clickingRealUsers |
clickingRealUsers |
The number of unique real users who have clicked on the ad. |
metric |
clickingRealUsersFlag |
clickingRealUsersFlag |
An indicator flag for the number of unique real users who have clicked on the ad. |
dimension |
clickingRealUsersFrequency |
clickingRealUsersFrequency |
The average number of times unique real users who clicked on the ad did so. |
metric |
clickingRealUsersFrequencyFlag |
clickingRealUsersFrequencyFlag |
An indicator flag for the frequency of clicks by unique real users. |
dimension |
clickingRealUsersReach |
clickingRealUsersReach |
The unique reach of real users who clicked on the ad. |
metric |
clickingRealUsersReachFlag |
clickingRealUsersReachFlag |
An indicator flag for the reach of unique real users who clicked on the ad. |
dimension |
clicks |
clicks |
The total number of clicks on the ad creative. |
metric |
clicksAccumulated |
clicksAccumulated |
The cumulative total number of clicks on the ad creative over the reporting period. |
metric |
conversionRate |
conversionRate |
The rate at which users complete a desired action (conversion) after interacting with the ad. |
metric |
cookieCTR |
cookieCTR |
The Click-Through Rate calculated based on users identified by cookies. |
metric |
cookieClicks |
cookieClicks |
The number of clicks attributed to users identified by cookies. |
metric |
cookieClicksAccumulated |
cookieClicksAccumulated |
The cumulative number of clicks attributed to users identified by cookies over the reporting period. |
metric |
cookieImpressions |
cookieImpressions |
The number of impressions attributed to users identified by cookies. |
metric |
cookieImpressionsAccumulated |
cookieImpressionsAccumulated |
The cumulative number of impressions attributed to users identified by cookies over the reporting period. |
metric |
cookieInteractions |
cookieInteractions |
The number of interactions attributed to users identified by cookies. |
metric |
cookieInteractionsAccumulated |
cookieInteractionsAccumulated |
The cumulative number of interactions attributed to users identified by cookies over the reporting period. |
metric |
creativeEventID |
creativeEventID |
A unique identifier for a specific event related to the creative (e.g., video start, completion). |
metric |
creativeFormID |
creativeFormID |
A unique identifier for the form or template used for the creative. |
metric |
creativeFormName |
creativeFormName |
The name of the form or template used for the creative. |
dimension |
creativeID |
creativeID |
A unique identifier for the ad creative. |
metric |
creativeName |
creativeName |
The name of the ad creative. |
dimension |
creativeTypeID |
creativeTypeID |
A unique identifier for the type of ad creative (e.g., banner, video). |
metric |
creativeTypeName |
creativeTypeName |
The name of the type of ad creative. |
dimension |
dwellScore |
dwellScore |
A score representing the quality or intensity of user engagement with the ad creative. |
metric |
dwellTime |
dwellTime |
The total time users spent dwelling on or engaging with the ad creative. |
metric |
dwells |
dwells |
The number of instances where users dwelled on or engaged with the ad creative. |
metric |
engagedVisits |
engagedVisits |
The total number of visits that showed a significant level of user engagement. |
metric |
engagedVisitsPostClick |
engagedVisitsPostClick |
The number of engaged visits that occurred after a click on the ad. |
metric |
engagedVisitsPostView |
engagedVisitsPostView |
The number of engaged visits that occurred after an impression (view) of the ad without a click. |
metric |
frequency |
frequency |
The average number of times a unique user was exposed to the ad. |
metric |
impressions |
impressions |
The total number of times an ad creative was displayed to users. |
metric |
impressionsAccumulated |
impressionsAccumulated |
The cumulative total number of times an ad creative was displayed to users over the reporting period. |
metric |
inscreens |
inscreens |
The number of times the ad creative was displayed fully on the user’s screen. |
metric |
interactions |
interactions |
The total number of user interactions with the ad creative (e.g., clicks, hovers, video plays). |
metric |
interactionsAccumulated |
interactionsAccumulated |
The cumulative total number of user interactions with the ad creative over the reporting period. |
metric |
leadRate |
leadRate |
The rate at which ad interactions result in leads. |
metric |
leads |
leads |
The number of leads generated by the advertising campaign. |
metric |
newUserActions |
newUserActions |
The number of actions performed by new users. |
metric |
newUserActionsAccumulated |
newUserActionsAccumulated |
The cumulative number of actions performed by new users over the reporting period. |
metric |
newUserClicks |
newUserClicks |
The number of clicks made by new users. |
metric |
newUserClicksAccumulated |
newUserClicksAccumulated |
The cumulative number of clicks made by new users over the reporting period. |
metric |
newUserInteractions |
newUserInteractions |
The number of interactions performed by new users. |
metric |
newUserInteractionsAccumulated |
newUserInteractionsAccumulated |
The cumulative number of interactions performed by new users over the reporting period. |
metric |
newUserPostClickActions |
newUserPostClickActions |
The number of post-click actions performed by new users. |
metric |
newUserPostClickActionsAccumulated |
newUserPostClickActionsAccumulated |
The cumulative number of post-click actions performed by new users over the reporting period. |
metric |
newUserPostViewActions |
newUserPostViewActions |
The number of post-view actions performed by new users. |
metric |
newUserPostViewActionsAccumulated |
newUserPostViewActionsAccumulated |
The cumulative number of post-view actions performed by new users over the reporting period. |
metric |
newUserSuccessfulClicks |
newUserSuccessfulClicks |
The number of successful clicks made by new users. |
metric |
newUserSuccessfulClicksAccumulated |
newUserSuccessfulClicksAccumulated |
The cumulative number of successful clicks made by new users over the reporting period. |
metric |
newUsers |
newUsers |
The total number of new, unique users exposed to the ad. |
metric |
newUsersAccumulated |
newUsersAccumulated |
The cumulative total number of new, unique users exposed to the ad over the reporting period. |
metric |
nonCookieClicks |
nonCookieClicks |
The number of clicks by users not identified by cookies. |
metric |
nonCookieClicksAccumulated |
nonCookieClicksAccumulated |
The cumulative number of clicks by users not identified by cookies over the reporting period. |
metric |
nonCookieImpressions |
nonCookieImpressions |
The number of impressions for users not identified by cookies. |
metric |
nonCookieImpressionsAccumulated |
nonCookieImpressionsAccumulated |
The cumulative number of impressions for users not identified by cookies over the reporting period. |
metric |
nonCookieInteractions |
nonCookieInteractions |
The number of interactions by users not identified by cookies. |
metric |
nonCookieInteractionsAccumulated |
nonCookieInteractionsAccumulated |
The cumulative number of interactions by users not identified by cookies over the reporting period. |
metric |
nonEngagedVisits |
nonEngagedVisits |
The total number of visits that did not show a significant level of user engagement. |
metric |
nonEngagedVisitsPostClick |
nonEngagedVisitsPostClick |
The number of non-engaged visits that occurred after a click on the ad. |
metric |
nonEngagedVisitsPostView |
nonEngagedVisitsPostView |
The number of non-engaged visits that occurred after an impression (view) of the ad without a click. |
metric |
oldUserActions |
oldUserActions |
The number of actions performed by returning users. |
metric |
oldUserClicks |
oldUserClicks |
The number of clicks made by returning users. |
metric |
oldUserInteractions |
oldUserInteractions |
The number of interactions performed by returning users. |
metric |
oldUserPostClickActions |
oldUserPostClickActions |
The number of post-click actions performed by returning users. |
metric |
oldUserPostViewActions |
oldUserPostViewActions |
The number of post-view actions performed by returning users. |
metric |
oldUserSuccessfulClicks |
oldUserSuccessfulClicks |
The number of successful clicks made by returning users. |
metric |
oldUsers |
oldUsers |
The total number of returning, unique users exposed to the ad. |
metric |
orderID |
orderID |
A unique identifier for the ad order. |
metric |
orderName |
orderName |
The name of the ad order. |
dimension |
pageViewDuration |
pageViewDuration |
The total duration of page views. |
metric |
pageViewDurationPostClick |
pageViewDurationPostClick |
The total duration of page views that occurred after a click on the ad. |
metric |
pageViewDurationPostView |
pageViewDurationPostView |
The total duration of page views that occurred after an impression (view) of the ad without a click. |
metric |
pagesPerVisit |
pagesPerVisit |
The average number of pages viewed per visit. |
metric |
pagesPerVisitPostClick |
pagesPerVisitPostClick |
The average number of pages viewed per visit that occurred after a click on the ad. |
metric |
pagesPerVisitPostView |
pagesPerVisitPostView |
The average number of pages viewed per visit that occurred after an impression (view) of the ad without a click. |
metric |
pagesPerVisitor |
pagesPerVisitor |
The average number of pages viewed per unique visitor. |
metric |
pagesPerVisitorPostClick |
pagesPerVisitorPostClick |
The average number of pages viewed per unique visitor that occurred after a click on the ad. |
metric |
pagesPerVisitorPostView |
pagesPerVisitorPostView |
The average number of pages viewed per unique visitor that occurred after an impression (view) of the ad without a click. |
metric |
period |
period |
The time period for which the data is reported (e.g., day, week, month). |
dimension |
periodName |
periodName |
The name of the time period for which the data is reported. |
dimension |
placementCategoryID |
placementCategoryID |
A unique identifier for the category of the ad placement. |
metric |
placementCategoryName |
placementCategoryName |
The name of the category of the ad placement. |
dimension |
placementFullName |
placementFullName |
The full, descriptive name of the ad placement where the creative was displayed. |
dimension |
placementID |
placementID |
A unique identifier for the ad placement. |
metric |
placementName |
placementName |
The name of the ad placement. |
dimension |
platformID |
platformID |
A unique identifier for the platform where the ad was displayed (e.g., desktop, mobile). |
metric |
platformName |
platformName |
The name of the platform where the ad was displayed. |
dimension |
postClickActions |
postClickActions |
The number of user actions that occurred after a click on the ad creative. |
metric |
postClickActionsAccumulated |
postClickActionsAccumulated |
The cumulative number of user actions that occurred after a click on the ad creative over the reporting period. |
metric |
postClickLeads |
postClickLeads |
The number of leads generated specifically after a click on the ad. |
metric |
postViewActions |
postViewActions |
The number of user actions that occurred after an impression (view) of the ad creative without a click. |
metric |
postViewActionsAccumulated |
postViewActionsAccumulated |
The cumulative number of user actions that occurred after an impression (view) of the ad creative without a click over the reporting period. |
metric |
postViewLeads |
postViewLeads |
The number of leads generated specifically after an impression (view) of the ad without a click. |
metric |
primaryClicks |
primaryClicks |
This field captures the initial or “first” click made by a user on an advertisement, crucial for understanding primary engagement. |
metric |
primaryClicksAccumulated |
primaryClicksAccumulated |
The cumulative number of primary clicks on the ad creative over the reporting period. |
metric |
primaryCookieInteractions |
primaryCookieInteractions |
The number of primary interactions attributed to users identified by cookies. |
metric |
primaryInteractions |
primaryInteractions |
The number of primary interactions with the ad creative, indicating key engagement points. |
metric |
publisherID |
publisherID |
A unique identifier for the publisher website or app. |
metric |
publisherName |
publisherName |
The name of the publisher website or app. |
dimension |
realUsers |
realUsers |
The total number of unique real users exposed to the ad. |
metric |
realUsersCTR |
realUsersCTR |
The Click-Through Rate calculated based on unique real users. |
metric |
realUsersCTRFlag |
realUsersCTRFlag |
An indicator flag for the Click-Through Rate based on unique real users. |
dimension |
realUsersFlag |
realUsersFlag |
An indicator flag for the number of unique real users. |
dimension |
realUsersFrequency |
realUsersFrequency |
The average number of times unique real users were exposed to the ad. |
metric |
realUsersFrequencyFlag |
realUsersFrequencyFlag |
An indicator flag for the frequency of exposure for unique real users. |
dimension |
realUsersReach |
realUsersReach |
The unique reach of real users exposed to the ad. |
metric |
realUsersReachFlag |
realUsersReachFlag |
An indicator flag for the reach of unique real users. |
dimension |
secondaryClicks |
secondaryClicks |
The number of secondary clicks on the ad creative, often supplementary interactions. |
metric |
secondaryClicksAccumulated |
secondaryClicksAccumulated |
The cumulative number of secondary clicks on the ad creative over the reporting period. |
metric |
secondaryInteractions |
secondaryInteractions |
The number of secondary interactions with the ad creative. |
metric |
successfulClicks |
successfulClicks |
The number of clicks that successfully led to the intended destination. |
metric |
successfulClicksAccumulated |
successfulClicksAccumulated |
The cumulative number of successful clicks over the reporting period. |
metric |
timeToAction |
timeToAction |
The average time taken from ad exposure to a user action. |
metric |
timeToClick |
timeToClick |
The average time taken from ad exposure to a user click. |
metric |
timeToInteraction |
timeToInteraction |
The average time taken from ad exposure to a user interaction. |
metric |
timeToPostClickAction |
timeToPostClickAction |
The average time taken from a click to a subsequent user action. |
metric |
timeToPostViewAction |
timeToPostViewAction |
The average time taken from an impression (view) to a subsequent user action without a click. |
metric |
uniqueConversionRate |
uniqueConversionRate |
The rate of unique users completing a desired action (conversion). |
metric |
uniqueCookies |
uniqueCookies |
The number of unique cookies recorded. |
metric |
uniqueLeadRate |
uniqueLeadRate |
The rate at which unique users become leads after interacting with the ad. |
metric |
userActions |
userActions |
The total number of actions performed by users. |
metric |
userClicks |
userClicks |
The number of clicks attributed to specific users. |
metric |
userInteractions |
userInteractions |
The total number of interactions performed by users. |
metric |
userLeads |
userLeads |
The number of leads generated from users. |
metric |
userPostClickActions |
userPostClickActions |
The number of post-click actions performed by users. |
metric |
userPostClickLeads |
userPostClickLeads |
The number of leads generated from users after a click. |
metric |
userPostViewActions |
userPostViewActions |
The number of post-view actions performed by users. |
metric |
userPostViewLeads |
userPostViewLeads |
The number of leads generated from users after an impression (view) without a click. |
metric |
userPrimaryInteractions |
userPrimaryInteractions |
The number of primary interactions performed by users. |
metric |
userSecondaryInteractions |
userSecondaryInteractions |
The number of secondary interactions performed by users. |
metric |
userSuccessfulClicks |
userSuccessfulClicks |
The number of successful clicks made by users. |
metric |
visitBounceRate |
visitBounceRate |
The percentage of single-page visits where the user left without interacting further. |
metric |
visitTimeSpent |
visitTimeSpent |
The total time spent by users during their visits. |
metric |
visitTimeSpentPostClick |
visitTimeSpentPostClick |
The total time spent by users during visits that occurred after a click on the ad. |
metric |
visitTimeSpentPostView |
visitTimeSpentPostView |
The total time spent by users during visits that occurred after an impression (view) of the ad without a click. |
metric |
visitorBounceRate |
visitorBounceRate |
The percentage of visitors who initiated only a single page view and left without further interaction. |
metric |
visitorTimeSpent |
visitorTimeSpent |
The total time spent by unique visitors on the site. |
metric |
visitorTimeSpentPostClick |
visitorTimeSpentPostClick |
The total time spent by unique visitors on the site after a click on the ad. |
metric |
visitorTimeSpentPostView |
visitorTimeSpentPostView |
The total time spent by unique visitors on the site after an impression (view) of the ad without a click. |
metric |
visitors |
visitors |
The total number of unique visitors. |
metric |
visitorsPostClick |
visitorsPostClick |
The number of unique visitors who engaged after clicking on the ad. |
metric |
visitorsPostView |
visitorsPostView |
The number of unique visitors who engaged after viewing the ad without clicking. |
metric |
visits |
visits |
The total number of visits to the site. |
metric |
visitsPerVisitor |
visitsPerVisitor |
The average number of visits per unique visitor. |
metric |
visitsPerVisitorPostClick |
visitsPerVisitorPostClick |
The average number of visits per unique visitor that occurred after a click on the ad. |
metric |
visitsPerVisitorPostView |
visitsPerVisitorPostView |
The average number of visits per unique visitor that occurred after an impression (view) of the ad without a click. |
metric |
visitsPostClick |
visitsPostClick |
The number of visits that occurred after a click on the ad. |
metric |
visitsPostView |
visitsPostView |
The number of visits that occurred after an impression (view) of the ad without a click. |
metric |