페이지 이동경로
  • Docs>
  • Kakao Moment>
  • Engagement targeting management

Kakao Moment

Engagement targeting management

This document describes how to use the engagement targeting management APIs.

The engagement targeting can be used as targeting information when creating or editing an ad group. The targeting information is created based on a combination of clicks, plays, and engagement data to your ads, which can be applied to all campaigns running through Kakao Moment.

The Kakao Moment Ads provide a variety of engagement data according to your campaign's goal and type. Depending on users' choices, various engagement data is collected and used to run ads. The types of engagement data that you can use may vary depending on your campaign's type.

Engagement criteria by campaign type
Type Display Kakao Bizboard/
Daum Shopping
Kakao Talk Channel
Play(재생) - - Users who have played the video of the mssage for 3 seconds or longer.
Click(클릭) Users who have clicked at least one area in clickable areas of the ad. Users who have clicked at least one area in clickable areas of the ad. Users who have clicked at least one area in clickable areas of the message the users have viewed.
Conversion(전환) 1) Users whose conversion is detected by the Kakao Pixel & SDK, except for the case that the ad goal is set to 'Kakao Talk Channel' among the Display X Conversion(전환) type of campaigns.
2) If the ad goal is set to 'Kakao Talk Channel' among the Display X Conversion(전환) type of campaigns, users who have added Kakao Talk Channel through the ad.
Users whose conversion is detected by the Kakao Pixel & SDK. -
Open(열람) - - Users who opened the Kakao Talk Channel's chat and read a message.

Available operation and engagement types by Type X Goal
Type X Goal Click(All) Conversion(All) Click-Conversion
Display X Conversion(전환),

Display X Visit(방문)
operation : ONLY
firstIndicator: CLICK
operation : ONLY
firstIndicator: CONVERSION
operation : MINUS
firstIndicator: CLICK
secondIndicator: CONVERSION
Type X Goal Click/Play/Conversion(All) Click-Play/Play-Click/
Click-Conversion
Play & Click
Kakao Bizboard X Conversion(전환),

Kakao Bizboard X Visit(방문)
Click
operation : ONLY
firstIndicator: CLICK

Play
operation : ONLY
firstIndicator: PLAY

Conversion
operation : ONLY
firstIndicator: CONVERSION
Click-Play
operation : MINUS
firstIndicator: CLICK
secondIndicator: PLAY

Play-Click
operation : MINUS
firstIndicator: PLAY
secondIndicator: CLICK

Click-Conversion
operation : MINUS
firstIndicator: CLICK
secondIndicator : CONVERSION
operation : AND
firstIndicator: PLAY
secondIndicator: CLICK
Type X Goal Open/Click/Play(All) Open-Click-Play/
Click-Play/Play-Click
Click & Play
Kakao Talk Channel X Reach(도달) Open
operation : ONLY
firstIndicator: OPEN

Click
operation : ONLY
firstIndicator: CLICK

Play
operation : ONLY
firstIndicator: PLAY
Open-Click-Play
operation : MINUS
firstIndicator: OPEN
secondIndicator : CLICK
thirdIndicator : PLAY

Click-Play
operation : MINUS
firstIndicator : CLICK
secondIndicator : PLAY

Play-Click
operation : MINUS
firstIndicator : PLAY
secondIndicator : CLICK
operation : AND
firstIndicator: CLICK
secondIndicator: PLAY

View list of engagement targets

This API enables you to retrieve a list of engagement targets you can use as a targeting option when creating or editing an ad group.

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the list of engagement targets. If failed, refer to Error code to figure out its failure cause.

Request
URL
GET /openapi/v4/targetings/cohort/list HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Response
Name Type Description
- CohortTarget[] List of engagement targets.
CohortTarget
Name Type Description
id Long Engagement target's ID.
audienceType String Engagement target's type.
Either DISPLAY or MESSAGE.
When you create or edit an ad group or Audience, you need to use the available Audience type between Display and Message according to its campaign Type X Goal.
name String Engagement target's name.
baseAds BaseAd[] List of engagement data.
collectDuration Integer Collecting period.
User data collected during this period from today is used for the ad targeting.
If no one responded to your ad during this period, data may not exist even though you have run ads before.
cohortStatus String Status of target population.
One of the followings:
WAITING: Preparing for extracting target population
AVAILABLE_ERROR: Error in extracting target population
AVAILABLE: Target population has been extracted from a customer file
SEED_NOT_ENOUGH: Insufficient target population
DELETE: Deleted or deleting
ERROR: Other errors
score Long Target population that is normally extracted when target population's status is AVAILABLE.
Extracted on the next day after requesting to create an engagement target with the estimated number of users who responded to the selected ad.,
Newly updated every day according to the designated collecting period.
If a target population's status is WAITING, you cannot use the target population for targeting because extracting parameter is not completed.
createdDate String Date and time of creation in yyyy-MM-dd'T'HH:mm:ss format.
lastModifiedDate String Date and time of modification in yyyy-MM-dd'T'HH:mm:ss format.
Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/list" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "adAccountId": 1234,
        "id": 1,
        "audienceType": "MESSAGE",
        "name": "first_engagement_target",
        "baseAds": [
            {
                "campaign": {
                    "id": 5678,
                    "name": "first_campaign",
                    "campaignTypeGoal": {
                        "campaignType": "TALK_CHANNEL",
                        "goal": "REACH"
                    }
                },
                "adGroup": {
                    "id": 20425,
                    "name": "first_ad_group"
                },
                "operation": "ONLY",
                "firstIndicator": "OPEN"
            }
        ],
        "collectDuration": 90,
        "cohortStatus": "AVAILABLE",
        "createdDate": "2020-01-01 00:00:00",
        "lastModifiedDate": "2020-01-01 00:00:00"
    }
]

View engagement target

This API enables you to retrieve detailed information of the specified engagement target.

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. You must pass the engagement target's ID to be retrieved when you request. If the request is successful, this API returns the detailed information and status of the requested engagement target in JSON format. If failed, refer to Error code to figure out its failure cause.

Request
URL
GET /openapi/v4/targetings/cohort/{id} HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
id Long Engagement target's ID. O
Response
Name Type Description
id Long Engagement target's ID.
audienceType String Engagement target's type.
Either DISPLAY or MESSAGE.
When you create or edit an ad group or Audience, you need to use the available Audience type between Display and Message according to its campaign Type X Goal.
adAccountId Long Ad account's ID.
name String Engagement target's name.
baseAds BaseAd[] List of engagement data.
collectDuration Integer Collecting period.
User data collected during this period from today is used for the ad targeting.
If no one responded to your ad during this period, data may not exist even though you have run ads before.
cohortStatus String Status of target population.
One of the followings:
WAITING: Preparing for extracting target population
AVAILABLE_ERROR: Error in extracting target population
AVAILABLE: Target population has been extracted from a customer file
SEED_NOT_ENOUGH: Insufficient target population
DELETE: Deleted or deleting
ERROR: Other errors
createdDate String Date and time of creation in yyyy-MM-dd'T'HH:mm:ss format.
lastModifiedDate String Date and time of modification in yyyy-MM-dd'T'HH:mm:ss format.
Sample
Request
curl -X GET 'https://apis.moment.kakao.com/openapi/v4/targetings/cohort/{id}' \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "name": "first_engagement_target",
    "baseAds": [
        {
            "campaign": {
                "id": 5678,
                "name": "first_campaign",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 9012,
                "name": "first_ad_group"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "collectDuration": 90,
    "cohortStatus": "AVAILABLE",
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 00:00:00"
}

View creatable engagement targets

This API enables you to retrieve the list of information about ad groups and campaigns under an ad account required when you create engagement target.

For campaigns, you can retrieve only the following combinations of the campaign's Type X Goal:

  • Kakao Bizboard X Visit(방문)
  • Kakao Bizboard X Conversion(전환)
  • Display X Visit(방문)
  • Display X Conversion(전환)
  • Daum Shopping X Reach(도달)
  • Video X View(조회)
  • Kakao Talk Channel X Reach(도달)

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. You must pass the type, goal, and name of the campaign to be retrieved when you request. If the request is successful, this API returns the detailed information of each ad group and campaign in JSON format. If failed, refer to Error code to figure out its failure cause.

Request
URL
GET /openapi/v4/targetings/cohort/creatables HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
campaignTypeGoal CampaignTypeGoal Campaign's Type X Goal you want to retrieve. O
searchKeyword String Campaign's name you want to retrieve. O
CampaignTypeGoal
Name Type Description Required
campaignType CampaignType Campaign type.
Either TALK_BIZ_BOARD(Kakao Bizboard) or DISPLAY.
O
goal Goal Campaign goal.
Either VISITING or CONVERSION.
O
Response
Name Type Description
- AdGroupAndCampaign[] List of ad groups and campaigns.
AdGroupAndCampaign
Name Type Description
adGroup AdGroup Ad group.
campaign Campaign Campaign.
Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/creatables" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "campaignTypeGoal": {
                "campaignType": "DISPLAY",
                "goal": "VISITING"
            },
            "searchKeyword":"HG"
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "campaign": {
            "id": 1234,
            "name": "first_campaign",
            "campaignTypeGoal": {
                "campaignType": "DISPLAY",
                "goal": "VISITING"
            }
        },
        "adGroup": [
            {
                "id": 56,
                "name": "first_ad_group"
            },
            {
                "id": 78,
                "name": "second_ad_group"
            }
        ]
    }
]

Create engagement target

This API enables you to create a new engagement target. You can create up to 50 engagement targets per ad account. Engagement targeting can be used as targeting information when creating or editing an ad group. The targeting information is created based on a combination of clicks, plays, and engagement data to your ads.

Send a POST request with the issued access token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the created engagement target. If failed, refer to Error code to figure out its failure cause.

Request
URL
POST /openapi/v4/targetings/cohort HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
audienceType String Engagement target's type.
Either DISPLAY or MESSAGE.
O
name String Engagement target's name.

Allowed characters: Korean, English, special characters, space
Character limits: 50 characters
O
baseAds BaseAd[] List of engagement data. O
Available 'Type X Goal' of campaign by type
Engagement target type Available Campaign Type X Goal
DISPLAY Kakao Bizboard X Conversion(전환)
Kakao Bizboard X Visit(방문)
Display X Conversion(전환)
Display X Visit(방문)
Daum Shopping X Reach(도달)
Video X View(조회)
MESSAGE Kakao Talk Channel X Reach(도달)
BaseAd
Name Type Description Required
adGroup AdGroup Information of the ad group. O
campaign Campaign Information of the campaign. O
operation Operation Operation type.
Refer to Available operation and engagement types by Type X Goal.
O
firstIndicator Indicator First response type.
Refer to Available operation and engagement types by Type X Goal.
O
secondIndicator Indicator Second response type.
Refer to Available operation and engagement types by Type X Goal.
X
thirdIndicator Indicator Third response type.
Refer to Available operation and engagement types by Type X Goal.
X
Response
Name Type Description
id Long Engagement target's ID.
adAccountId Long Ad account's ID.
name String Engagement target's name.
collectDuration Integer Collecting period.
User data collected during this period from today is used for the ad targeting.
If no one responded to your ad during this period, data may not exist even though you have run ads before.
baseAds BaseAd[] List of engagement data.
cohortStatus String Status of target population.
One of the followings:
WAITING: Preparing for extracting target population
AVAILABLE_ERROR: Error in extracting target population
AVAILABLE: Target population has been extracted from a customer file
SEED_NOT_ENOUGH: Insufficient target population
DELETE: Deleted or deleting
ERROR: Other errors
createdDate String Date and time of creation in yyyy-MM-dd'T'HH:mm:ss format.
lastModifiedDate String Date and time of modification in yyyy-MM-dd'T'HH:mm:ss format.
Sample
Request
curl -X POST "https://apis.moment.kakao.com/openapi/v4/targetings/cohort" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "name": "first_ad_response",
            "audienceType": "MESSAGE",
            "baseAds": [
                {
                    "campaign": {
                        "id": 56,
                        "campaignTypeGoal": {
                            "campaignType": "TALK_CHANNEL"
                        }
                    },
                    "adGroup": {
                        "id": 78
                    },
                    "firstIndicator": "OPEN",
                    "operation": "ONLY"
                }
            ]
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "collectDuration": 90,
    "cohortStatus": "WAITING",
    "name": "first_ad_response",
    "baseAds": [
        {
            "campaign": {
                "id": 56,
                "name": "first_campaign",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 78,
                "name": "first_ad_group"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 00:00:00"
}

Edit name of engagement target

This API enables you to edit the name of the engagement target. If the engagement target has already been deleted or the name is already being used, you cannot edit its name.

Send a PUT request with the issued access token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the changed information of the engagement target in JSON format. If failed, refer to Error code to figure out its failure cause.

This API limits the number of calls you can make to every 10 seconds per user account.

Request
URL
PUT /openapi/v4/targetings/cohort/name HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
id Long Engagement target's ID. O
name String Engagement target's name.

Allowed characters: Korean, English, special characters, space
Character limits: 50 characters
O
Response
Name Type Description
adAccountId Long Ad account's ID.
id Long Engagement target's ID.
audienceType String Engagement target's type.
Either DISPLAY or MESSAGE.
When you create or edit an ad group or Audience, you need to use the available Audience type between Display and Message according to its campaign Type X Goal.
name String Engagement target's name.
collectDuration Integer Collecting period.
User data collected during this period from today is used for the ad targeting.
If no one responded to your ad during this period, data may not exist even though you have run ads before.
baseAds BaseAd[] List of engagement data.
cohortStatus String Status of target population.
One of the followings:
WAITING: Preparing for extracting target population
AVAILABLE_ERROR: Error in extracting target population
AVAILABLE: Target population has been extracted from a customer file
SEED_NOT_ENOUGH: Insufficient target population
DELETE: Deleted or deleting
ERROR: Other errors
createdDate String Date and time of creation in yyyy-MM-dd'T'HH:mm:ss format.
lastModifiedDate String Date and time of modification in yyyy-MM-dd'T'HH:mm:ss format.
Sample
Request
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/name" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "id": 1,
            "name": "edit_engagement_target_name"
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "collectDuration": 90,
    "cohortStatus": "WAITING",
    "name": "edit_engagement_target_name",
    "baseAds": [
        {
            "campaign": {
                "id": 56,
                "name": "first_campaign",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 78,
                "name": "first_ad_group"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 12:00:00"
}

Edit data of engagement target

This API enables you to edit the data of the engagement target. You cannot edit the engagement target's name with this API. After retrieving the information on the existing engagement target through the Viewing engagement target API, you must pass the fields to be edited and not to be edited together when requesting this API. You must also pass the existing values of the fields you do not want to edit to retain the existing information of the engagement target.

Send a PUT request with the issued access token and an ad account ID (adAccountId) in the request header. If the request is successful, this API returns the changed information of the engagement target in JSON format. If failed, refer to Error code to figure out its failure cause.

IMPORTANT

If you request to edit the engagement data, it takes a day for a new target to be applied.

Request
URL
PUT /openapi/v4/targetings/cohort HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
id Long Engagement target's ID. O
baseAds BaseAd[] List of engagement data. O
BaseAd
Name Type Description Required
adGroup AdGroup Information of the ad group. O
campaign Campaign Information of the campaign. O
operation Operation Operation type.
One of ONLY,MINUS, or AND.
Refer to Available operation and engagement types by Type X Goal.
O
firstIndicator Indicator First response type.
One of PLAY, CLICK, OPEN, or CONVERSION.
Refer to Available operation and engagement types by Type X Goal.
O
secondIndicator Indicator Second response type.
One of PLAY, CLICK, or CONVERSION.
Refer to Available operation and engagement types by Type X Goal.
X
Response
Name Type Description
id Long Engagement target's ID.
audienceType String Engagement target's type.
Either DISPLAY or MESSAGE.
When you create or edit an ad group or Audience, you need to use the available Audience type between Display and Message according to its campaign Type X Goal.
adAccountId Long Ad account's ID.
name String Engagement target's name.
collectDuration Integer Collecting period.
User data collected during this period from today is used for the ad targeting.
If no one responded to your ad during this period, data may not exist even though you have run ads before.
baseAds BaseAd[] List of engagement data.
cohortStatus String Status of target population.
One of the followings:
WAITING: Preparing for extracting target population
AVAILABLE_ERROR: Error in extracting target population
AVAILABLE: Target population has been extracted from a customer file
SEED_NOT_ENOUGH: Insufficient target population
DELETE: Deleted or deleting
ERROR: Other errors
createdDate String Date and time of creation in yyyy-MM-dd'T'HH:mm:ss format.
lastModifiedDate String Date and time of modification in yyyy-MM-dd'T'HH:mm:ss format.
Sample
Request
curl -X PUT "https://apis.moment.kakao.com/openapi/v4/targetings/cohort" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}" \
    -d '{
            "id": 1234,
            "name": "edit_engagement_target_data",
            "baseAds": [
                {
                    "campaign": {
                        "id": 56,
                        "campaignTypeGoal": {
                            "campaignType": "TALK_CHANNEL"
                        }
                    },
                    "adGroup": {
                        "id": 78
                    },
                    "firstIndicator": "OPEN",
                    "operation": "ONLY"
                }
            ]
        }'
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "adAccountId": 1234,
    "id": 1,
    "audienceType": "MESSAGE",
    "collectDuration": 90,
    "cohortStatus": "WAITING",
    "name": "edit_engagement_target_data",
    "baseAds": [
        {
            "campaign": {
                "id": 56,
                "name": "first_campaign",
                "campaignTypeGoal": {
                    "campaignType": "TALK_CHANNEL",
                    "goal": "REACH"
                }
            },
            "adGroup": {
                "id": 78,
                "name": "first_ad_group"
            },
            "operation": "ONLY",
            "firstIndicator": "OPEN"
        }
    ],
    "createdDate": "2020-01-01 00:00:00",
    "lastModifiedDate": "2020-01-01 15:00:00"
}

Delete engagement target

This API enables you to delete an engagement target. You cannot delete the engagement target that has already been deleted or is being used.

Send a DELETE request with the issued access token and an ad account ID (adAccountId) in the request header. You must pass the engagement target's ID as a parameter when you request. If the request is successful, this API returns the HTTP status code 200 without the response body. If failed, refer to Error code to figure out its failure cause.

This API limits the number of calls you can make to every second per user account.

Request
URL
DELETE /openapi/v4/targetings/cohort/{id} HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
id Long Engagement target's ID. O
Sample
Request
curl -X DELETE "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/{id}" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

Delete multiple engagement targes

This API enables you to delete multiple engagement targets at once. You cannot delete the engagement target that has already been deleted or is being used.

Send a DELETE request with the issued access token and an ad account ID (adAccountId) in the request header. You must pass the engagement target's IDs as a parameter when you request. If the request is successful, this API returns the HTTP status code 200 without the response body. If failed, refer to Error code to figure out its failure cause.

This API limits the number of calls you can make to every second per user account.

Request
URL
DELETE /openapi/v4/targetings/cohort?cohortIds=${cohortIds} HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
cohortIds String Engagement target's ID.
To pass multiple Engagement target IDs, separate them with a comma(,).
O
Sample
Request
curl -X DELETE "https://apis.moment.kakao.com/openapi/v4/targetings/cohort?cohortIds= ${cohortIds},${cohortIds}" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: ${adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "successCount": 1,
    "failCount": 1,
    "errorMessages": [
        "타겟을 사용 중인 오디언스가 있습니다."
    ]
}

View usage of engagement target

This API enables you to retrieve the list of ad groups and campaigns that use the designated engagement target.

Send a GET request with the issued access token and an ad account ID (adAccountId) in the request header. You must pass the engagement target's ID as a parameter when you request. If the request is successful, this API returns the list of ad groups and campaigns that use the requested engagement target for targeting in JSON format. If failed, refer to Error code to figure out its failure cause.

Request
URL
GET /openapi/v4/targetings/cohort/usages/{id} HTTP/1.1
Host: apis.moment.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}
Header
Name Type Description Required
Authorization String Pass an access token in Bearer ${ACCESS_TOKEN} format. O
adAccountId Long Ad account's ID. O
Parameter
Name Type Description Required
id Long Engagement target's ID. O
Response
Name Type Description
- AdGroupAndCampaign[] List of ad groups and campaigns using the engagement target.
AdGroupAndCampaign
Name Type Description
adGroup AdGroup Information of the ad group.
campaign Campaign Information of the campaign.
Sample
Request
curl -X GET "https://apis.moment.kakao.com/openapi/v4/targetings/cohort/usages/{id}" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "adAccountId: {adAccountId}"
Response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[
    {
        "adGroup": {
            "id": 1234,
            "name": "first_ad_group",
            "adGroupStatus": [
                "LIVE"
            ],
            "adGroupType": "DISPLAY"
        },
        "campaign": {
            "id": 5678,
            "name": "first_campaign",
            "campaignTypeGoal": {
                "campaignType": "DISPLAY",
                "goal": "VISITING"
            }
        }
    }
]

See more