Kakao Moment: Setup guide

On this page

This guide explains how to collect data from Kakao Moment.

Introduction

For a list of the fields that you can collect from Kakao Moment, see Kakao Moment.

Creating a datastream to collect data from Kakao Moment

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Kakao Moment.

Authorization: Allow Adverity to access Kakao Moment

You can authorize Adverity to access Kakao Moment using one of the following methods:

Business Access Token: Use a Business Access Token provided by your organization.
OAuth2: Use your own Kakao Moment app credentials to authenticate through OAuth2.

Business Access Token

Before creating an authorization to give Adverity access to Kakao Moment using a Business Access Token, perform the following actions:

Obtain your Business Access Token from your Kakao Moment account.

To set up a new authorization using a Business Access Token, follow these steps:

In the Authorization step of the datastream wizard, click Access Kakao Moment using your Business Access Token.
Click Next.
In Business Access Token, enter your Kakao Moment Business Access Token.
Click Authorize.

OAuth2

Before creating an authorization to give Adverity access to Kakao Moment using OAuth2, perform the following actions:

In your Kakao Moment app settings, locate your REST API Key, Redirect URI, and Client Secret.

To set up a new authorization using OAuth2, follow these steps:

In the Authorization step of the datastream wizard, click Access Kakao Moment using OAuth2.
Click Next.
In REST API Key, enter your Kakao Moment REST API Key.
In Redirect URI, enter your Kakao Moment Redirect URI.
In Client Secret, enter your Kakao Moment Client Secret.
Click Authorize.

Configuration: Choose the data you want to collect from Kakao Moment

To choose what data to collect and customize the Kakao Moment datastream configuration, follow these steps:

(Optional) Rename your datastream.
In Ad Account, select the ad accounts for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.
In Report type, select the type of data to collect from Kakao Moment. For a description of each report type, see Report types below.
In Report Level, select the level of detail for the report. For a description of each report level, see Report levels below.
In Breakdown, select how to break down the report data. This field applies to the Ad Stats report type only.

Note
Age Band, Gender, Age Band + Gender, Location, Device Type, and Placement breakdowns are only supported for the Display campaign type.
In Metrics Group, select the groups of metrics to include in the report. This field applies to the Ad Stats report type only.

Note
Display campaigns do not support Message basic metrics, Message additional metrics, or Message click metrics. Message campaigns do not support Basic metrics, Additional metrics, Pixel & SDK conversion metrics, or Video metrics.
In Metadata fields, select the metadata fields to include in the report. This field applies to the Metadata report type only.
(Optional) Select the Include deleted ad groups and creatives checkbox to include deleted ad groups and creatives in your metadata requests. This field applies to the Metadata report type only.

What’s next?

Apply Data Mapping to your collected data to harmonize data collected from different sources in Adverity.
Transform your data to meet your needs by creating and applying transformations to your datastream.
Load your data into a warehouse to continue working with your data in Adverity.
Load your data into an external destination of your choice.

Advanced Kakao Moment tips

Report types

To select the type of data to collect from Kakao Moment, choose from the following report types:

Ad Stats: Provides advertising performance metrics for the selected ad accounts, report level, and breakdown.
Metadata: Provides structural data about ad accounts, campaigns, ad groups, and creatives, including configuration and status information.

Report levels

To select the level of detail for the report, choose from the following report levels:

Ad account: Returns data aggregated at the ad account level.
Campaign: Returns data at the campaign level.
Ad group: Returns data at the ad group level.
Creative: Returns data at the creative level.

Rate limits

The following rate limits apply to the Kakao Moment reporting API:

Scroll horizontally to see the full table.

Report level	Limit
Ad account	1 request per 5 seconds
Campaign	1 request per 5 seconds
Ad group	1 request per 1 second
Creative	1 request per 5 seconds