Kakao Moment: Most-used fields#
The table below gives information about most-used fields that you can import from Kakao Moment. 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 |
|---|---|---|---|
account_config |
account_config |
The operational status of the ad account, such as ‘ON’, ‘OFF’, or ‘DEL’ (deleted). |
dimension |
account_id |
account_id |
Unique identifier for an ad account, which is the organizational unit for running advertisements on the Kakao Moment platform. |
dimension |
account_name |
account_name |
The name of the ad account. |
dimension |
ad_group_adminStop |
ad_group_adminStop |
This field is deprecated and indicates whether the ad group’s administrator had suspended the ad group. It has been replaced by ‘systemConfig’. |
dimension |
ad_group_bidAmount |
ad_group_bidAmount |
The maximum bid amount set for an ad group, applicable for manual bidding strategies. This value cannot exceed 50% of the daily budget or 100,000 KRW. |
dimension |
ad_group_config |
ad_group_config |
The user-defined status of the ad group, such as ‘ON’, ‘OFF’, or ‘DEL’ (deleted). |
dimension |
ad_group_createdDate |
ad_group_createdDate |
The date and time when the ad group was created, in ‘yyyy-MM-dd’T’HH:mm:ss’ format. |
dimension |
ad_group_creativeOptimization |
ad_group_creativeOptimization |
This field was removed and previously indicated if creative optimization was enabled for the ad group. |
dimension |
ad_group_dailyBudgetAmount |
ad_group_dailyBudgetAmount |
The maximum amount allocated to be spent by the ad group each day, ranging from 10,000 to 500 million KRW. |
dimension |
ad_group_deviceTypes |
ad_group_deviceTypes |
The types of devices (e.g., ANDROID, IOS, PC) on which ads within this ad group are displayed. |
dimension |
ad_group_dynamicTarget |
ad_group_dynamicTarget |
This field was removed and previously indicated if dynamic targeting was enabled for the ad group. |
dimension |
ad_group_id |
ad_group_id |
Unique identifier for an ad group, which contains detailed strategies such as targeting, delivery settings, bid amount, and period within a campaign. |
dimension |
ad_group_lastModifiedDate |
ad_group_lastModifiedDate |
The date and time when the ad group was last modified, in ‘yyyy-MM-dd’T’HH:mm:ss’ format. |
dimension |
ad_group_name |
ad_group_name |
The name of the ad group. |
dimension |
ad_group_placements |
ad_group_placements |
The specific locations or platforms (e.g., KAKAO_SERVICE, KAKAO_TALK, DAUM, NETWORK) where ads in this ad group can be displayed. |
dimension |
ad_group_profileId |
ad_group_profileId |
For Message ad groups, this represents the Kakao Talk Channel’s profile ID associated with the ad group. |
dimension |
ad_group_smartMessage |
ad_group_smartMessage |
Indicates whether the Smart Message feature is used, which optimizes ad delivery by finding lookalike audiences based on real-time data. |
dimension |
ad_group_status |
ad_group_status |
The current operational status of the ad group, which can include states like ‘LIVE’ (operating), ‘OFF’ (user-paused), or ‘DELETED’. |
dimension |
ad_group_statusDescription |
ad_group_statusDescription |
A descriptive text for the current status of the ad group. |
dimension |
ad_group_systemConfig |
ad_group_systemConfig |
The system-controlled status of the ad group, indicating if it’s ‘ON’ (available to run ads), ‘ADMIN_STOP’ (suspended by administrator), or ‘EXTERNAL_SERVICE_STOP’ (linked service restricted). |
dimension |
ad_group_targeting |
ad_group_targeting |
Defines the audience targeting settings for the ad group, including demographics (age, gender, location), interests, and custom audiences. |
dimension |
campaign_config |
campaign_config |
The user-defined status of the campaign, such as ‘ON’, ‘OFF’, or ‘DEL’ (deleted). |
dimension |
campaign_dailyBudgetAmount |
campaign_dailyBudgetAmount |
The maximum amount allocated to be spent by the campaign each day. If not specified, there is no limitation on the budget. |
dimension |
campaign_goal |
campaign_goal |
The primary objective or goal of the campaign, such as ‘Visit’, ‘Conversion’, or ‘Reach’. |
dimension |
campaign_id |
campaign_id |
Unique identifier for a campaign, which defines the advertising goal and sending method for ads. Multiple ad groups can be part of a single campaign. |
dimension |
campaign_name |
campaign_name |
The name of the campaign. |
dimension |
campaign_objective |
campaign_objective |
The specific objective of the advertising goal, relevant for certain campaign types. |
dimension |
campaign_status |
campaign_status |
The current operational status of the campaign. This is an array of strings representing various states like ‘LIVE’. |
dimension |
campaign_statusDescription |
campaign_statusDescription |
A descriptive text for the current status of the campaign. This status is determined by the campaign’s configuration and whether the daily budget is exceeded. |
dimension |
campaign_systemConfig |
campaign_systemConfig |
The system-controlled status of the campaign, indicating if it’s ‘ON’ (available to run ads), ‘ADMIN_STOP’ (suspended by administrator), or ‘EXTERNAL_SERVICE_STOP’ (linked service restricted). |
dimension |
campaign_type |
campaign_type |
The type of campaign, such as ‘DISPLAY’, ‘VIDEO’, or ‘TALK_CHANNEL’. |
dimension |
creative_actionButton |
creative_actionButton |
The text displayed on the call-to-action button for creatives like Image Native or Video Native. |
dimension |
creative_ageVerification |
creative_ageVerification |
Indicates whether age verification messages are used for the creative. |
dimension |
creative_altText |
creative_altText |
Alternative text for image-based creatives, used for accessibility or when the image cannot be displayed. |
dimension |
creative_assetGroups |
creative_assetGroups |
Refers to slide items for certain creative types. Note: The assetGroups field was renamed to slides and will be unavailable after September 30, 2025. |
dimension |
creative_config |
creative_config |
Represents the operational status of the creative, indicating whether it is active (ON), inactive (OFF), or deleted (DEL). |
dimension |
creative_createdDate |
creative_createdDate |
The date and time when the creative was created, in ‘yyyy-MM-dd’T’HH:mm:ss’ format. |
dimension |
creative_creativeId |
creative_creativeId |
The unique identifier for the creative. This ID may change if the creative is modified and requires a new review. |
dimension |
creative_creativeStatus |
creative_creativeStatus |
The operational status of the creative, such as ‘OPERATING’, ‘UNAPPROVED’, ‘OFF’ (user-paused), or ‘DELETED’. |
dimension |
creative_description |
creative_description |
The promotional text or description for creatives like Image Native or Video Native. |
dimension |
creative_format |
creative_format |
The specific type or format of the creative, such as ‘IMAGE_BANNER’, ‘IMAGE_NATIVE’, ‘VIDEO_NATIVE’, or various message types. |
dimension |
creative_frequencyCap |
creative_frequencyCap |
The maximum number of times an ad creative can be shown to a single user within a specific period. |
dimension |
creative_frequencyCapType |
creative_frequencyCapType |
The automatic setting type for frequency capping (e.g., ‘DAY_IMP’). |
dimension |
creative_hasExpandable |
creative_hasExpandable |
Indicates whether the creative includes an expandable component. |
dimension |
creative_id |
creative_id |
Unique identifier for a creative, which represents the ad content such as native, banner, video, or message types. |
dimension |
creative_image |
creative_image |
Information about the main image used in image or video creatives, including URL, file name, width, height, and size. |
dimension |
creative_landingInfo |
creative_landingInfo |
Specifies data related to the landing page or destination of the creative, including the landing type. |
dimension |
creative_lastModifiedDate |
creative_lastModifiedDate |
The date and time when the creative was last modified, in ‘yyyy-MM-dd’T’HH:mm:ss’ format. |
dimension |
creative_messageElement |
creative_messageElement |
Detailed information specific to a Message creative, such as message content and elements. |
dimension |
creative_mobileLandingUrl |
creative_mobileLandingUrl |
The URL for the mobile landing page associated with the creative. This URL is used when the ad is displayed on mobile devices. Must be a valid URL with http:// or https:// scheme. |
dimension |
creative_name |
creative_name |
The name of the creative. |
dimension |
creative_opinion |
creative_opinion |
Opinion provided for ad verification, typically related to content review. |
dimension |
creative_opinionProof |
creative_opinionProof |
A list of materials submitted for ad verification, providing evidence for the creative’s content. |
dimension |
creative_pcLandingUrl |
creative_pcLandingUrl |
The URL for the PC landing page associated with the creative. This URL is used when the ad is displayed on desktop or PC devices. |
dimension |
creative_profileImage |
creative_profileImage |
The URL or details of the profile image uploaded for creatives like Image Native or Video Native. |
dimension |
creative_profileName |
creative_profileName |
The profile name displayed for creatives like Image Native or Video Native. |
dimension |
creative_rejectedReason |
creative_rejectedReason |
A list of reasons why the creative was rejected during the review process, including titles and content of rejection. |
dimension |
creative_reviewStatus |
creative_reviewStatus |
The current review status of the creative, such as ‘APPROVED’, ‘WAITING’, or ‘REJECTED’. |
dimension |
creative_rspvLandingUrl |
creative_rspvLandingUrl |
The responsive landing URL associated with the creative. This URL is designed to adapt to various screen sizes and devices. Must be a valid URL with http:// or https:// scheme. |
dimension |
creative_statusDescription |
creative_statusDescription |
A descriptive text for the current status of the creative. |
dimension |
creative_systemConfig |
creative_systemConfig |
The system-controlled status of the creative, indicating if it’s ‘ON’ (normal operation) or ‘ADMIN_STOP’ (admin suspended). |
dimension |
creative_thumbnailImage |
creative_thumbnailImage |
The uploaded custom thumbnail image for a video creative. |
dimension |
creative_title |
creative_title |
The title of the creative, applicable to types like Image Native or Video Native. |
dimension |
creative_video |
creative_video |
Information about the video asset used in video creatives, including its details and format. |
dimension |