Kakao Moment: Most-used fields

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