본 문서는 UMS-SDK를 이용하여 네이버 톡톡 광고성 메시지를 발송하는 방법을 설명합니다.
발송 전 승인된 템플릿을 확인하고, 템플릿 유형에 맞는 프로필, 파트너키, 템플릿 코드, 버튼 링크 및 치환 정보를 설정해야 합니다.
| 템플릿 유형 | 템플릿 타입 |
|---|---|
| 광고성 기본형 | BENEFIT |
| 광고성 LMS형 | BENEFIT_LMS |
| 광고성 캐러셀 커머스형 | BENEFIT_CAROUSEL_COMMERCE |
| 광고성 리스트 커머스형 | BENEFIT_LIST_COMMERCE |
| 광고성 캐러셀 피드형 | BENEFIT_CAROUSEL_FEED |
| 광고성 리스트 피드형 | BENEFIT_LIST_FEED |
| SDK 메서드 | 설명 | 필수 여부 |
|---|---|---|
setNAVER_PROFILE() |
네이버 톡톡 프로필 설정 | 필수 |
setNAVER_PARTNERKEY() |
광고성 발송용 파트너키 또는 서비스 번호 설정 | 필수 |
setNAVER_TEMPL_ID() |
승인된 템플릿 코드(TMPL_CD) 설정 |
필수 |
setNAVER_BUTTONS() |
템플릿 버튼의 실제 이동 링크 또는 앱 스킴 설정 | 조건부 필수 |
setREPLACE_VARS() |
메시지 또는 버튼 링크의 치환 변수 설정 | 조건부 필수 |
umsPotalParamVo.setNAVER_PROFILE("w5zwfn"); // [필수]
umsPotalParamVo.setNAVER_PARTNERKEY("2600113694"); // [필수]
// 매우 중요: LGCNS를 사용하는 경우 광고성 발송으로 등록된 서비스 번호여야 합니다.
중요
정보성 발송용 서비스 번호가 아닌 광고성 발송으로 등록된 서비스 번호를 사용해야 합니다.
템플릿의 BENEFIT 컬럼에 버튼이 등록되어 있고 searchResultExposure 값이 N인 경우, 해당 버튼의 링크 정보를 NAVER_BUTTONS에 반드시 설정해야 합니다.
버튼 유형에 따라 다음 값을 사용합니다.
| 버튼 유형 | 주요 필드 |
|---|---|
| 웹 링크 | buttonCode, pcUrl, mobileUrl |
| 앱 링크 | buttonCode, iOsAppScheme, aOsAppScheme |
메시지 본문 또는 버튼 링크에 #{...} 형식의 변수가 포함되어 있다면, 모든 치환값을 REPLACE_VARS에 JSON 형식으로 설정해야 합니다.
umsPotalParamVo.setREPLACE_VARS(
"{\"#{name}\":\"홍길동\"}"
);
BENEFIT
템플릿 코드: BENEFIT_TEXT_01
메시지: [테스트] #{name}님, 혜택 기본 텍스트 테스트 발송입니다2.
등록된 버튼 정보 예시:
[
{
"buttonName": "누적 포인트 확인 1",
"pcUrl": "https://ums30.morpheus.kr/admin/login",
"buttonCode": "WEB-LINK-BTN-001",
"mobileUrl": "https://ums30.morpheus.kr/admin/login",
"type": "WEB_LINK"
},
{
"buttonName": "누적 포인트 확인 2",
"aOsAppScheme": "test://aOs",
"buttonCode": "APP-LINK-BTN-002",
"iOsAppScheme": "test://iOs",
"type": "APP_LINK"
}
]
umsPotalParamVo.setNAVER_PROFILE("w5zwfn"); // [필수]
umsPotalParamVo.setNAVER_PARTNERKEY("2600113694"); // [필수]
// 매우 중요: LGCNS를 사용하는 경우 광고성 발송으로 등록된 서비스 번호여야 합니다.
umsPotalParamVo.setNAVER_TEMPL_ID("BENEFIT_TEXT_01"); // [필수] TMPL_CD
// 등록된 템플릿 내용과 버튼에 적용할 치환 정보를 설정합니다.
umsPotalParamVo.setREPLACE_VARS(
"{\"#{name}\":\"홍길동\"}"
);
BENEFIT_LMS
템플릿 코드: AD_LMS_02
메시지: [테스트] #{name}님, 혜택 기본 텍스트 테스트 발송입니다3..
등록된 버튼 정보 예시:
[
{
"buttonName": "누적 포인트 확인 1",
"pcUrl": "https://ums30.morpheus.kr/admin/login",
"buttonCode": "WEB-LINK-BTN-001",
"mobileUrl": "https://ums30.morpheus.kr/admin/login",
"type": "WEB_LINK"
},
{
"buttonName": "누적 포인트 확인 2",
"aOsAppScheme": "test://aOs",
"buttonCode": "APP-LINK-BTN-002",
"iOsAppScheme": "test://iOs",
"type": "APP_LINK"
}
]
umsPotalParamVo.setNAVER_PROFILE("w5zwfn"); // [필수]
umsPotalParamVo.setNAVER_PARTNERKEY("2600113694"); // [필수]
// 매우 중요: LGCNS를 사용하는 경우 광고성 발송으로 등록된 서비스 번호여야 합니다.
umsPotalParamVo.setNAVER_TEMPL_ID("AD_LMS_02"); // [필수] TMPL_CD
// 등록된 템플릿 내용과 버튼에 적용할 치환 정보를 설정합니다.
umsPotalParamVo.setREPLACE_VARS(
"{\"#{name}\":\"홍길동\"}"
);
BENEFIT_CAROUSEL_COMMERCE
BENEFIT_CAROUSEL_COMMERCE_20260611101918
BENEFIT 컬럼 구성 예시{
"introduction": {
"headerImageUrl": "https://ums.unless.co.kr/cdn-nav/MjAyNjA2MDFfMjU5/MDAxNzgwMjgxNDQ2Mzc5.5T2-k0TW_Dgi8fdROoPYYkbsJXVgQjHPYoMajrXhKw0g.1dxSFX1omkX-7XeGtqDxwgnqkzZHCcYB319Su-Nbzc4g.JPEG/test_700_700.jpg?type=m600",
"buttonType": "WEB_LINK",
"headerImageHashId": "mHBx-zuFNMcWxCPMAmX-Wp4BsUM4XIfX-eVwkVs8zj5JJzW1dGXtLbmVdMo6_cln",
"buttonTitle": "웹링크",
"buttonCode": "TEST_BUTTON_INTRO01",
"description": "샘플 인트로내용",
"title": "샘플 인트로타이틀"
},
"products": [
{
"buttonType": "WEB_LINK",
"originalPrice": "20000",
"imageUrl": "https://ums.unless.co.kr/cdn-nav/MjAyNjA2MDFfMjMz/MDAxNzgwMjgxNDQ5MTYz.oSx4T8vW0qJO5OL79DLGZgZWjdtNYP-69l8qsVO2B2Ag.OQ9mGnOJRr6CpEeyyIh3FzgL0Qs_JnUoqQ2maJhkaJog.JPEG/pexels-star-800800.jpg?type=m600",
"buttonCode": "TEST_PROD_BUTTON_CAROUSEL_COMMERCE_0",
"currentPrice": "10000",
"title": "상품 제목",
"imageHashId": "YUGNOUUiRrtpTrkCuz21n8naMaf_74EdXc0P-b5NUjtJJzW1dGXtLbmVdMo6_cln"
},
{
"buttonType": "WEB_LINK",
"originalPrice": "20000",
"imageUrl": "https://ums.unless.co.kr/cdn-nav/MjAyNjAzMTJfMTYy/MDAxNzczMjk5MTM1MzIz.JLekp7uRsl6VTWH192HUS6Vy_EeNby4XtJJeA_TvQmQg.9Ez7rsPsGsl8nrZWGpvzSV7LX9kNkPIXpu9Lf9CXMiIg.PNG/800800.png?type=m600",
"buttonCode": "TEST_PROD_BUTTON_CAROUSEL_COMMERCE_1",
"currentPrice": "10000",
"title": "상품 제목",
"imageHashId": "VOH7XJ6IqM5186OT_5-9axqzja-6t4lmgE26RzdCWzFJJzW1dGXtLbmVdMo6_cln"
}
]
}
umsPotalParamVo.setNAVER_PROFILE("w5zwfn"); // [필수]
umsPotalParamVo.setNAVER_PARTNERKEY("2600113694"); // [필수]
// 매우 중요: LGCNS를 사용하는 경우 광고성 발송으로 등록된 서비스 번호여야 합니다.
umsPotalParamVo.setNAVER_TEMPL_ID(
"BENEFIT_CAROUSEL_COMMERCE_20260611101918"
); // [필수] TMPL_CD
// BENEFIT에 버튼이 있고 searchResultExposure가 N이면 버튼 링크 정보가 필수입니다.
umsPotalParamVo.setNAVER_BUTTONS(
"["
+ "{"
+ "\"buttonCode\":\"TEST_BUTTON_INTRO01\","
+ "\"pcUrl\":\"https://www.naver.com\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_CAROUSEL_COMMERCE_0\","
+ "\"pcUrl\":\"https://www.naver.com/#{PRODUCT}\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_CAROUSEL_COMMERCE_1\","
+ "\"pcUrl\":\"https://www.naver.com\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "}"
+ "]"
);
// 버튼 링크에 사용된 치환값을 설정합니다.
umsPotalParamVo.setREPLACE_VARS(
"{\"#{PRODUCT}\":\"마우스\"}"
);
BENEFIT_LIST_COMMERCE
umsPotalParamVo.setNAVER_PROFILE("w5zwfn"); // [필수]
umsPotalParamVo.setNAVER_PARTNERKEY("2600113694"); // [필수]
// 매우 중요: LGCNS를 사용하는 경우 광고성 발송으로 등록된 서비스 번호여야 합니다.
umsPotalParamVo.setNAVER_TEMPL_ID(
"BENEFIT_LIST_COMMERCE_20260611102154"
); // [필수] TMPL_CD
// BENEFIT에 버튼이 있고 searchResultExposure가 N이면 버튼 링크 정보가 필수입니다.
umsPotalParamVo.setNAVER_BUTTONS(
"["
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_LIST_COMMERCE_0\","
+ "\"pcUrl\":\"https://www.naver.com\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_LIST_COMMERCE_1\","
+ "\"pcUrl\":\"https://www.naver.com/#{PRODUCT}\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_LIST_COMMERCE_2\","
+ "\"pcUrl\":\"https://www.naver.com\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "}"
+ "]"
);
// 버튼 링크에 치환키가 있으므로 치환값을 설정합니다.
umsPotalParamVo.setREPLACE_VARS(
"{\"#{PRODUCT}\":\"mouse\"}"
);
BENEFIT_CAROUSEL_FEED
umsPotalParamVo.setNAVER_PROFILE("w5zwfn"); // [필수]
umsPotalParamVo.setNAVER_PARTNERKEY("2600113694"); // [필수]
// 매우 중요: LGCNS를 사용하는 경우 광고성 발송으로 등록된 서비스 번호여야 합니다.
umsPotalParamVo.setNAVER_TEMPL_ID(
"BENEFIT_CAROUSEL_FEED_20260611102806"
); // [필수] TMPL_CD
// BENEFIT에 버튼이 있고 searchResultExposure가 N이면 버튼 링크 정보가 필수입니다.
umsPotalParamVo.setNAVER_BUTTONS(
"["
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_CAROUSEL_FEED0_0_BTN1\","
+ "\"pcUrl\":\"https://www.naver.com?prodId=#{prodid1}\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_CAROUSEL_FEED0_0_BTN2\","
+ "\"iOsAppScheme\":\"https://www.naver.com\","
+ "\"aOsAppScheme\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_CAROUSEL_FEED0_1_BTN1\","
+ "\"pcUrl\":\"https://www.naver.com\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_CAROUSEL_FEED0_1_BTN2\","
+ "\"iOsAppScheme\":\"https://www.naver.com\","
+ "\"aOsAppScheme\":\"https://m.naver.com\""
+ "}"
+ "]"
);
// 버튼 링크에 치환키가 있으므로 치환값을 설정합니다.
umsPotalParamVo.setREPLACE_VARS(
"{\"#{prodid1}\":\"uralce01\"}"
);
[
{
"buttonCode": "TEST_PROD_BUTTON_CAROUSEL_FEED0_0_BTN1",
"pcUrl": "https://www.naver.com?prodId=#{prodid1}",
"mobileUrl": "https://m.naver.com"
},
{
"buttonCode": "TEST_PROD_BUTTON_CAROUSEL_FEED0_0_BTN2",
"iOsAppScheme": "https://www.naver.com",
"aOsAppScheme": "https://m.naver.com"
},
{
"buttonCode": "TEST_PROD_BUTTON_CAROUSEL_FEED0_1_BTN1",
"pcUrl": "https://www.naver.com",
"mobileUrl": "https://m.naver.com"
},
{
"buttonCode": "TEST_PROD_BUTTON_CAROUSEL_FEED0_1_BTN2",
"iOsAppScheme": "https://www.naver.com",
"aOsAppScheme": "https://m.naver.com"
}
]
BENEFIT_LIST_FEED
umsPotalParamVo.setNAVER_PROFILE("w5zwfn"); // [필수]
umsPotalParamVo.setNAVER_PARTNERKEY("2600113694"); // [필수]
// 매우 중요: LGCNS를 사용하는 경우 광고성 발송으로 등록된 서비스 번호여야 합니다.
umsPotalParamVo.setNAVER_TEMPL_ID(
"BENEFIT_LIST_FEED_20260611102633"
); // [필수] TMPL_CD
// BENEFIT에 버튼이 있고 searchResultExposure가 N이면 버튼 링크 정보가 필수입니다.
umsPotalParamVo.setNAVER_BUTTONS(
"["
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_LIST_FEED0_0\","
+ "\"pcUrl\":\"https://www.naver.com?prodId=#{prodid1}\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "},"
+ "{"
+ "\"buttonCode\":\"TEST_PROD_BUTTON_LIST_FEED0_1\","
+ "\"pcUrl\":\"https://www.naver.com\","
+ "\"mobileUrl\":\"https://m.naver.com\""
+ "}"
+ "]"
);
// 버튼 링크에 치환키가 있으므로 치환값을 설정합니다.
umsPotalParamVo.setREPLACE_VARS(
"{\"#{prodid1}\":\"uralce01\"}"
);
[
{
"buttonCode": "TEST_PROD_BUTTON_LIST_FEED0_0",
"pcUrl": "https://www.naver.com?prodId=#{prodid1}",
"mobileUrl": "https://m.naver.com"
},
{
"buttonCode": "TEST_PROD_BUTTON_LIST_FEED0_1",
"pcUrl": "https://www.naver.com",
"mobileUrl": "https://m.naver.com"
}
]
| 템플릿 유형 | 템플릿 코드 예시 | 버튼 정보 | 치환 정보 |
|---|---|---|---|
| 광고성 기본형 | BENEFIT_TEXT_01 |
템플릿 구성에 따름 | 메시지 또는 버튼에 변수가 있으면 필수 |
| 광고성 LMS형 | AD_LMS_02 |
템플릿 구성에 따름 | 메시지 또는 버튼에 변수가 있으면 필수 |
| 광고성 캐러셀 커머스형 | BENEFIT_CAROUSEL_COMMERCE_20260611101918 |
조건부 필수 | 메시지 또는 버튼에 변수가 있으면 필수 |
| 광고성 리스트 커머스형 | BENEFIT_LIST_COMMERCE_20260611102154 |
조건부 필수 | 메시지 또는 버튼에 변수가 있으면 필수 |
| 광고성 캐러셀 피드형 | BENEFIT_CAROUSEL_FEED_20260611102806 |
조건부 필수 | 메시지 또는 버튼에 변수가 있으면 필수 |
| 광고성 리스트 피드형 | BENEFIT_LIST_FEED_20260611102633 |
조건부 필수 | 메시지 또는 버튼에 변수가 있으면 필수 |
NAVER_PROFILE이 템플릿이 등록된 프로필과 일치하는지 확인합니다.NAVER_PARTNERKEY가 광고성 발송용으로 등록된 서비스 번호인지 확인합니다.NAVER_TEMPL_ID가 승인된 템플릿의 TMPL_CD와 정확히 일치하는지 확인합니다.buttonCode는 승인된 템플릿에 등록된 값과 정확히 일치해야 합니다.pcUrl과 mobileUrl을 설정합니다.iOsAppScheme과 aOsAppScheme을 설정합니다.BENEFIT에 버튼이 있고 searchResultExposure가 N이면 버튼 링크 정보를 반드시 전달합니다.#{...} 변수의 값을 전달합니다.REPLACE_VARS 설정이 필요합니다.#{name}
#{PRODUCT}
#{prodid1}
REPLACE_VARS는 JSON 객체 형식이어야 합니다.NAVER_BUTTONS는 JSON 배열 형식이어야 합니다.\"로 이스케이프합니다.1. 광고성 발송용 서비스 번호 확인
↓
2. 승인된 광고성 템플릿 및 TMPL_CD 확인
↓
3. NAVER_PROFILE 설정
↓
4. NAVER_PARTNERKEY 설정
↓
5. NAVER_TEMPL_ID 설정
↓
6. BENEFIT의 버튼 및 searchResultExposure 확인
↓
7. 필요한 버튼 링크 또는 앱 스킴 설정
↓
8. 메시지와 버튼 링크의 치환 변수 설정
↓
9. UMS-SDK를 이용하여 광고성 메시지 발송