# 문자 메시지 발송하기

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FCjqggOxaIGtx3aMUd6FT%2F24.%20%E1%84%86%E1%85%AE%E1%86%AB%E1%84%8C%E1%85%A1%20%E1%84%86%E1%85%A6%E1%84%89%E1%85%B5%E1%84%8C%E1%85%B5%20%E1%84%83%E1%85%A2%E1%84%91%E1%85%AD%20%E1%84%8B%E1%85%B5%E1%84%86%E1%85%B5%E1%84%8C%E1%85%B5.png?alt=media&#x26;token=d4dfafa0-d9ae-40d1-ad12-498095795853" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
본문 내 *<mark style="color:red;background-color:yellow;">**마케팅 수신 관련 필독 사항**</mark>*&#xC744; 반드시 참고해주시기 바랍니다.
{% endhint %}

## **1회성 문자 발송 방법**

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FQk97YAdUbNnlOKgHjALZ%2F25.%E1%84%92%E1%85%A1%E1%86%AB%20%E1%84%87%E1%85%A5%E1%86%AB%20%E1%84%87%E1%85%A1%E1%86%AF%E1%84%89%E1%85%A9%E1%86%BC%20%E1%84%80%E1%85%B5%E1%84%87%E1%85%A1%E1%86%AB%20%E1%84%83%E1%85%A2%E1%84%91%E1%85%AD%20%E1%84%8B%E1%85%B5%E1%84%86%E1%85%B5%E1%84%8C%E1%85%B5.png?alt=media&#x26;token=328e7bf6-8da0-4b4f-874f-1e3fa2632b6d" alt=""><figcaption></figcaption></figure>

타겟 고객에게 원하는 시점에 1회 메시지를 발송하는 기능입니다.

1. '+ 캠페인 생성' 버튼을 클릭합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FxqPhnpQG7sruKCpLK7K4%2Fimage.png?alt=media&#x26;token=4bb5ad8e-28d8-431f-a3e2-36acd3329564" alt=""><figcaption></figcaption></figure>

2. 발송 타입을 ‘한 번 발송’으로 선택합니다.\
   단문 SMS, 장문 LMS, 장문 MMS 중 목적에 따라 문자메시지 타입을 선택합니다.
3. 생성 페이지 상단에서 발신번호를 선택합니다.\
   발신번호 프로필을 미리 등록하지 않은 경우 캠페인을 생성할 수 없습니다.
4. 메시지 본문을 작성합니다.

{% hint style="info" %}
***개인화 변수 활용법***

‘{  }’ 버튼을 클릭하셔서 입력하실 수 있습니다.\
개인화 변수 값이 없을 경우 대체 문구(기본값)를 입력해주시기 바랍니다.\
유저 정보가 없는 경우 대체 문구를 통해 고정된 문구가 전송됩니다.<br>

* **개인화 변수 입력시**\
  : (이름)님, 안녕하세요.
* **수집된 개인화 변수 값이 없어 대체 문구(설정한 기본값)로 노출될 경우**\
  : (설정한 기본값)님, 안녕하세요.
* **'한 번 발송' 타입 선택 시**\
  : 특정 이벤트가 트리거되지 않기 때문에 이벤트 속성으로 개인화 변수를 선택할 수 없으며, 유저 프로필 속성만 지원됩니다.\
  \
  \&#xNAN;***개인화 변수 지원 데이터 타입***

  <table><thead><tr><th width="148">구분</th><th width="204">지원 형식</th><th>지원 값</th></tr></thead><tbody><tr><td>String</td><td>-</td><td>-</td></tr><tr><td>Long</td><td>-</td><td>-</td></tr><tr><td>Double</td><td>-</td><td>-</td></tr><tr><td>Date</td><td>날짜 형식</td><td><p>YYYY-MM-DD<br>YY-MM-DD<br>YYYY-MM<br>DD/MM/YYYY</p><p>DD/MM/YY</p><p>MM/YYYY</p></td></tr><tr><td>Datetime</td><td>날짜 형식 &#x26; 시간</td><td><p>YYYY-MM-DD<br>YY-MM-DD<br>YYYY-MM<br>DD/MM/YYYY</p><p>DD/MM/YY</p><p>MM/YYYY<br><br>[시간]<br>표기 안 함<br>hh:mm</p><p>hh:mm:ss</p><p>hh</p></td></tr></tbody></table>

{% endhint %}

{% hint style="info" %}
***단축 URL 삽입***

단축 url 삽입을 통해 단순히 url을 단축하는 것을 넘어 **클릭, 전환 데이터 추적**이 가능합니다.\
이 때 url과 url 이외의 텍스트는 띄어쓰기로 반드시 분리되어야 합니다.\
![](https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FpoEfoLCbUbxrIimo5uj2%2Fimage.png?alt=media\&token=9a7383f3-1053-4a00-8db1-5c0b4193cd9e)
{% endhint %}

5. 광고성 메시지를 발송하실 경우 우측 상단 ‘광고성 메시지’ 토글을 활성화해주시기 바랍니다.

{% hint style="info" %}
[**정보성 VS 광고성 메시지 안내사항**](https://docs.dfinery.ai/user-guide/action/off-site-campaign/info-vs-ads)
{% endhint %}

6. 스케줄(캠페인 운영 기간)을 입력합니다.\
   해당 단계에서 피로도 관리(글로벌 피로도 설정) 적용 여부도 활성, 비활성화할 수 있습니다.

7. 오디언스를 선택하거나 타겟 필터링 기능을 활용하여 타겟을 설정할 수 있으며, 광고 수신 동의 설정 옵션을 선택할 수 있습니다.<br>

<table data-header-hidden><thead><tr><th width="227"></th><th></th></tr></thead><tbody><tr><td><strong>오디언스 활용 케이스</strong></td><td><p><strong>고도화된 조건을 사용하여 섬세한 타겟 설정 가능</strong></p><ul><li>마케팅 수신을 동의한 유저에게만 메시지가 발송될 수 있도록 오디언스 설정 시 유저 프로필 조건에서 마케팅 수신 동의를 <mark style="color:blue;"><strong>true</strong></mark>로 설정해주시기 바랍니다.</li></ul></td></tr><tr><td><strong>타겟 필터링 케이스</strong></td><td><p><strong>반복적으로 사용되지 않거나 빠르게 캠페인 타겟을 설정할 때 적합한 기능으로, 비교적 단순한 필터 지원</strong></p><ul><li>오디언스 생성 시와 마찬가지로 유저 프로필에서 마케팅 수신 동의 여부를 <mark style="color:blue;"><strong>true</strong></mark>로 설정해주시기 바랍니다.</li></ul></td></tr></tbody></table>

| **수신 동의 유저** | 광고성 메시지 수신에 ‘동의한 유저(true)’만 발송됩니다.                               |
| ------------ | ---------------------------------------------------------------- |
| **전체 유저**    | 광고성 메시지 수신에 ‘동의한 유저(true) 혹은 수신 동의 여부를 알 수 없는 유저(null)’에게 발송됩니다. |

{% hint style="danger" %}
**(필독) 마케팅 수신 동의 참고**

* 기본적으로 수신 동의 값이 true일 때 발송 가능하며, 발송 옵션에 따라 null을 포함하여 발송 가능합니다.
* 수신 동의 값이 false일 경우 발송이 불가합니다.
* *<mark style="color:red;background-color:yellow;">**수신 동의 값이 없을 경우(null) 메시지가 발송될 수 있으므로,**</mark>*\
  *<mark style="color:red;background-color:yellow;">**값(true 또는 false)을 디파이너리로 정확히 전달해주어야 합니다.**</mark>*
* 마케팅 수신 동의 여부 값은 API를 통해 최신화된 상태를 유지해주시기 바랍니다.
* 오프라인 데이터 연동 시에도 마케팅 수신 동의 값에 유의해주시기 바랍니다.
* 연동 시에도 관련 개발 문서를 반드시 참고하여 진행해주시기 바랍니다.\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(Android)**</mark>](https://docs.dfinery.ai/developer-guide/platform/android/user-profile#consent)\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(iOS)**</mark>](https://docs.dfinery.ai/developer-guide/platform/ios/user-profile#undefined-5)\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(Web)**</mark>](https://docs.dfinery.ai/developer-guide/platform/web/user_profile#consent)
  {% endhint %}

8. 구매 전환 및 커스텀 전환 추적을 설정합니다.\
   전환 추적을 위해서는 메시지 설정에서 하나 이상의 클릭 액션을 지정해야 합니다.\
   본문에 링크를 삽입하거나 버튼 또는 이미지에 링크를 추가해 주시기 바랍니다.\
   \
   구매 전환 추적과 관련한 자세한 내용은 [구매 전환 기간 설정](https://docs.dfinery.ai/user-guide/action/conversion_setting) 문서를 참고해주시기 바랍니다.\
   \
   **커스텀 전환 추적**\
   구매와 별개로 전환을 추적하고 싶은 이벤트를 최대 4개까지 추가할 수 있는 기능으로, 필요 시 선택적으로 이벤트를 추가해주시기 바랍니다.\
   커스텀 전환 추적은 글로벌 설정의 영향을 받지 않으며, 다른 캠페인들과 경합하지 않습니다.\
   따라서 클릭 액션 발생 시 모두 집계되어 상세 데이터 화면에 보여집니다.\ <img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FrBAfVGF32OdHOVgj8onQ%2Fimage.png?alt=media&#x26;token=500e33ef-d36c-4569-9576-5da5f214e2ac" alt="" data-size="original">

9. 마지막으로 캠페인 이름을 설정하고 캠페인을 생성합니다.

## **트리거 기반 문자 발송 방법**

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2Fb7efLaYohRC6rjyxVMh7%2F25.%E1%84%90%E1%85%B3%E1%84%85%E1%85%B5%E1%84%80%E1%85%A5%20%E1%84%80%E1%85%B5%E1%84%87%E1%85%A1%E1%86%AB%20%E1%84%83%E1%85%A2%E1%84%91%E1%85%AD%20%E1%84%8B%E1%85%B5%E1%84%86%E1%85%B5%E1%84%8C%E1%85%B5.png?alt=media&#x26;token=51a0a945-c382-45cf-8e7f-63fde5a4616b" alt=""><figcaption></figcaption></figure>

설정된 타겟에게 특정 이벤트가 발생하면 메시지가 발송됩니다.

1. '캠페인 생성' 버튼을 클릭합니다.

<figure><img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FJ9cFFwiuRcmsLtnqonv7%2Fimage.png?alt=media&#x26;token=67b8d80d-843d-4774-ad2d-79c73caad28d" alt=""><figcaption></figcaption></figure>

2. 발송 타입을 ‘트리거 발송’으로 선택합니다.

{% hint style="info" %}
***개인화 변수 활용법***

‘{ }’ 버튼 클릭 시 개인화 문구 설정 팝업이 노출됩니다.\
실제 메시지 발송 시 개인화 값이 없을 경우, 설정한 대체 문구가 노출됩니다.\
대체 문구는 테스트 발송 시에도 적용되어 노출됩니다.<br>

**개인화 변수 \[이름] 입력 예시**\
기본값 : '고객'으로 입력시

* **유저 정보 있을 때**\
  : {&치환된 이름명}님, 안녕하세요.
* **유저 정보 없을 때**\
  : 고객님, 안녕하세요.
* **트리거 기반 발송 타입 선택시**\
  : 특정 이벤트가 트리거되면 메시지가 발송되므로, 유저 프로필 속성과 트리거 이벤트로 설정할 이벤트의 하위 속성을 사용해 개인화 변수를 설정할 수 있습니다.\
  개인화 변수로 유저 프로필 속성, 이벤트 속성을 모두 지원합니다.\
  \
  ※ **`상품명(df_items) 속성` 개인화 문구 표현 방식**\
  디파이너리에서 `상품명(df_items)` 속성은 `구매(df_purchase)` 이벤트의 하위 속성으로, 각 상품의 정보를 담고 있는 배열입니다.\
  `상품명(df_items)` 속성을 활용하실 경우 상품의 수가 2개 이상이면 '**{첫 번째 상품명}외 n- 1개**'로 표기됩니다.\
  따라서 구매 이벤트를 트리거로 설정한 경우, 개인화 설정 시 '상품명' 또는 `df_items`의 커스텀 속성을 사용할 수 있으며, 고객이 특정 상품을 1개 구매한 경우와 2개 이상 구매한 경우에 따른 표기 방식을 설정할 수 있습니다.\
  \
  **예시)**
  * **고객 A**가 특정 상품을 1개 구매한 경우
    * **개인화 메시지 예시** :\
      감사합니다, 고객님! 당신의 **'스마트폰'** 주문이 완료되었습니다. 더 많은 상품을 확인해보세요!
  * **고객 B**가 2개 이상의 상품을 함께 구매한 경우
    * **개인화 메시지 예시 :**\
      감사합니다, 고객님! 당신의 **'스마트폰' 외 1개** 주문이 완료되었습니다. 더 많은 상품을 확인해보세요!
      {% endhint %}

3. 이후 본문 관련 설정은 “한 번 발송” 타입과 동일합니다.

4. 스케줄(캠페인 운영 기간)을 입력합니다.\
   \
   메시지 발송을 위해 유저가 충족할 조건(트리거)을 시작 이벤트와 이벤트 속성으로 설정합니다.\
   발송 대기 시간 동안 (이벤트가) 발생할 경우 캠페인을 발송하지 않는 성격의 종료 이벤트 또한 시작 이벤트와 같이 설정합니다.\
   \
   해당 단계에서 피로도 관리(글로벌 피로도 설정) 적용 여부도 활성, 비활성화할 수 있습니다.

{% hint style="info" %}
**발송 대기 시간**

* 유저가 특정 조건을 달성시 발송하고자 하는 해당 푸시메시지의 대기 시간을 입력합니다.
* 대기 시간 동안 종료 이벤트를 수행한 유저에게는 캠페인이 발송되지 않습니다.

**방해 금지 시간**

* 방해 금지 시간이 있을 경우 입력하고, 방해 금지 시간 동안 메시지를 발송하지 않거나 방해 금지 시간이 지나고 발송할지 여부를 선택합니다.
  {% endhint %}

5. 문자 캠페인의 타겟을 설정합니다.\
   마케팅 수신을 동의한 유저에게만 메시지가 발송될 수 있도록 오디언스 설정 시 유저 프로필 조건에서 마케팅 수신 동의를 <mark style="color:blue;">**true**</mark>로 설정해주시기 바랍니다.

{% hint style="danger" %}
**(필독) 마케팅 수신 동의 참고**

* 기본적으로 수신 동의 값이 true일 때 발송 가능하며, 발송 옵션에 따라 null을 포함하여 발송 가능합니다.
* 수신 동의 값이 false일 경우 발송이 불가합니다.
* *<mark style="color:red;background-color:yellow;">**수신 동의 값이 없을 경우(null) 메시지가 발송될 수 있으므로,**</mark>*\
  *<mark style="color:red;background-color:yellow;">**값(true 또는 false)을 디파이너리로 정확히 전달해주어야 합니다.**</mark>*
* 마케팅 수신 동의 여부 값은 API를 통해 최신화된 상태를 유지해주시기 바랍니다.
* 오프라인 데이터 연동 시에도 마케팅 수신 동의 값에 유의해주시기 바랍니다.
* 연동 시에도 관련 개발 문서를 반드시 참고하여 진행해주시기 바랍니다.\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(Android)**</mark>](https://docs.dfinery.ai/developer-guide/platform/android/user-profile#consent)\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(iOS)**</mark>](https://docs.dfinery.ai/developer-guide/platform/ios/user-profile#undefined-5)\
  [<mark style="color:blue;">**- 알림 수신 동의 정보 설정하기(Web)**</mark>](https://docs.dfinery.ai/developer-guide/platform/web/user_profile#consent)
  {% endhint %}

6. 구매 전환 및 커스텀 전환 추적을 설정합니다.\
   전환 추적을 위해서는 메시지 설정에서 하나 이상의 클릭 액션을 지정해야 합니다.\
   본문에 링크를 삽입하거나 버튼 또는 이미지에 링크를 추가해 주시기 바랍니다.\
   \
   구매 전환 추적과 관련한 자세한 내용은 [구매 전환 기간 설정](https://docs.dfinery.ai/user-guide/action/conversion_setting) 문서를 참고해주시기 바랍니다.\
   \
   **커스텀 전환 추적**\
   구매와 별개로 전환을 추적하고 싶은 이벤트를 최대 4개까지 추가할 수 있는 기능으로, 필요 시 선택적으로 이벤트를 추가해주시기 바랍니다.\
   커스텀 전환 추적은 글로벌 설정의 영향을 받지 않으며, 다른 캠페인들과 경합하지 않습니다.\
   따라서 클릭 액션 발생 시 모두 집계되어 상세 데이터 화면에 보여집니다.\ <img src="https://851339439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw80cM0G3UdX6uGwQB5zz%2Fuploads%2FrBAfVGF32OdHOVgj8onQ%2Fimage.png?alt=media&#x26;token=500e33ef-d36c-4569-9576-5da5f214e2ac" alt="" data-size="original">

7. 마지막으로 캠페인 이름을 설정하고 캠페인을 생성합니다.

## **광고성 메시지 발송**

{% hint style="warning" %}
정보성 메시지에 대한 자세한 내용은 아래 문서를 통해 확인해 주세요.\
[**정보성 VS 광고성**](https://docs.dfinery.ai/user-guide/action/off-site-campaign/info-vs-ads) **아티클 바로가기**
{% endhint %}

1. 광고성 메시지를 발송하실 경우 우측 상단 ‘광고성 메시지’ 토글을 활성화해주시기 바랍니다.
2. 국가 별 발신번호 프로필 설정에 따른 광고성 메시지 타임존

<table><thead><tr><th width="143"></th><th>한국 발신번호 프로필 선택</th><th>해외 발신번호 프로필 선택</th></tr></thead><tbody><tr><td>서비스 타임존<br><mark style="color:red;"><code>UTC+9</code></mark></td><td>20:00~08:00 설정 불가</td><td>서비스 타임존과 발신번호의 타임존 다름<br>광고성 메시지에 대한 법적인 제한사항 검토 후 시간 설정 필요</td></tr><tr><td>그외 타임존</td><td>서비스 타임존과 발신번호의 타임존 다름<br>광고성 메시지에 대한 법적인 제한사항 검토 후 시간 설정 필요</td><td>서비스 타임존과 발신번호의 타임존 다름<br>광고성 메시지에 대한 법적인 제한사항 검토 후 시간 설정 필요</td></tr></tbody></table>

## **테스트 발송**

우측 상단 '테스트 발송' 기능을 통해 휴대전화 번호를 입력하고 테스트 메시지를 발송하여 실제 환경에서 메시지가 어떻게 노출되는지 확인할 수 있습니다.

{% hint style="info" %}
테스트 발송 실패시 계속된 재시도에도 문제가 발생한다면 고객센터를 통해 문의해 주세요.
{% endhint %}

* 수신 동의 여부와 무관하게 발송됩니다.
* 개인화 문구는 설정한 대체 문구(기본값)으로 치환되어 발송됩니다.
* 단축 url 포함 테스트 발송시 전환 추적 데이터는 쌓이지 않습니다.

## **캠페인 상태**

<table><thead><tr><th width="135">상태</th><th width="401">설명</th><th>비고</th></tr></thead><tbody><tr><td>초안</td><td>Publish 하기 전 작성 중인 캠페인 상태</td><td>캠페인 내용 수정 가능</td></tr><tr><td>대기</td><td>캠페인 Publish 상태 / 초안으로 복구 가능</td><td><mark style="color:blue;"><strong><code>초안</code></strong></mark> 상태로 변경 가능</td></tr><tr><td>운영 준비 중</td><td>오디언스 스케줄에 따라 모수를 미리 온보딩하는 과정</td><td>캠페인 <mark style="color:red;"><strong><code>취소</code></strong></mark> 가능</td></tr><tr><td>운영 중</td><td>오디언스 온보딩이 완료되고 운영 시작 시간이 되어 캠페인이 활성화 된 상태</td><td>캠페인 <mark style="color:red;"><strong><code>취소</code></strong></mark> 가능</td></tr><tr><td>종료</td><td>종료 시간이 되거나 고객이 직접 콘솔에서 종료한 상태</td><td></td></tr><tr><td>에러</td><td>내부 서버 문제로 캠페인 집행이 진행되지 않은 상태</td><td></td></tr><tr><td>운영취소</td><td>운영 준비 중, 운영 중 상태에서 캠페인 취소 가능</td><td></td></tr><tr><td>삭제</td><td>콘솔에서 캠페인을 삭제한 상태</td><td></td></tr></tbody></table>