# AI Assistant 프롬프트 라이브러리
명확하고 구체적인 프롬프트를 작성하면 [AI Assistant](/ko/product/pushwoosh-ai/ai-assistant/)가 정확하고 관련성 있으며 실행 가능한 응답을 제공하는 데 도움이 됩니다. 다음 전략과 예시를 사용하여 결과를 개선하세요. 예시 프롬프트는 새 대화의 제안 프롬프트와 같은 방식으로 작업별로 그룹화되어 있습니다: **생성(Creation)**, **분석(Analysis)**, **구성(Configuration)**.
## 프롬프트 전략 및 모범 사례
| 권장 | 비권장 | 이유 |
| :---- | :---- | :---- |
| 원하는 것을 구체적으로 설명하세요 | 모호한 지시를 내리기 | 명확한 요청이 정확한 결과를 얻습니다 |
| 식별자(애플리케이션 코드, 캠페인 이름, Journey UUID, 세그먼트 이름)를 포함하세요 | 리소스를 모호하게 언급하기 | AI Assistant가 올바른 객체를 대상으로 삼을 수 있습니다 |
| 배경, 결과, 제약 조건을 포함한 상세한 프롬프트를 작성하세요 | 한 줄짜리 요청하기 | 컨텍스트가 많을수록 후속 질문이 줄어듭니다 |
| 이벤트, Journey, 태그, 캠페인에 일관된 이름을 사용하세요 | 이름 규칙을 섞어 쓰기 | AI Assistant가 항목을 찾을 때 혼동을 피합니다 |
| 사용자 정의 이벤트, 세그먼트, 태그에 명확한 설명을 추가하세요 | 설명 없이 두기 | AI Assistant가 이를 올바르게 해석하는 데 도움이 됩니다 |
| 모든 작업이나 응답 후에 결과를 확인하세요 | 작동했다고 가정하기 | 실수가 쌓이기 전에 발견합니다 |
| 특히 영구적인 변경의 경우 다음으로 넘어가기 전에 각 단계를 읽으세요 | 여러 단계의 작업을 서둘러 진행하기 | 영구적인 변경은 실행 전에 검토가 필요합니다 |
| 승인하기 전에 결정 카드의 이유를 검토하세요 | 읽지 않고 승인하기 | 카드는 실수를 잡을 수 있는 마지막 기회입니다 |
### 효과적인 프롬프트와 덜 효과적인 프롬프트
| 효과적인 프롬프트 | 덜 효과적인 프롬프트 |
| :---- | :---- |
| *"지난 7일 동안 장바구니를 포기한 사용자를 위한 세그먼트를 만드세요."* | *"내 푸시를 고쳐줘."* |
| *"6월 1일부터 15일까지 '여름 세일' 캠페인에 대한 푸시 알림 통계를 보여주세요."* | *"통계 보여줘."* |
| *"내 iOS 푸시 알림이 전송되지 않는 이유를 디버깅하는 데 도움을 주세요."* | *"뭔가 잘못됐어."* |
| *"'환영 플로우' Journey(UUID: abc-123)가 어제 오후 3시에 이메일 전송을 중단했습니다."* | *"내 Journey가 작동하지 않아."* |
| *"지난 14일 동안 제품을 봤지만 구매하지 않은 사용자를 위한 세그먼트를 만드세요. 목표는 후속 이메일로 그들을 타겟팅하는 것입니다."* | *"사용자 타겟팅을 도와줘."* |
## 생성
새로운 것을 만듭니다. 이 카테고리에 대한 채팅의 시작 프롬프트: *"완전한 마케팅 전략 구축"*, *"온보딩 Journey 생성"*, *"재참여 푸시 캠페인 생성"*.
### 세그먼트 및 오디언스
> *"지난 30일 동안 앱을 열지 않았고 과거에 최소 한 번 이상 구매했으며 알림 수신을 거부한 사용자를 제외한 사용자 세그먼트를 만드세요."*
**AI Assistant가 하는 일:** 설명된 필터 조건으로 세그먼트를 구축합니다.
**이후 확인 사항:** 세그먼트 크기가 합리적인지, 제외 대상 사용자(여기서는 수신 거부 사용자)가 실제로 제외되었는지 확인합니다.
### Customer Journey
##### 설명으로 Journey 구축
> *"고객이 장바구니에 신발을 추가하고 구매하지 않고 떠났을 때 시작되는 Journey를 만드세요.*
>
> *1시간 기다렸다가 구매가 발생하는지 확인하세요. 구매가 발생하면 감사 메시지를 보내고 Journey를 종료하세요. 그렇지 않으면 첫 번째 알림을 보내고 23시간 더 기다리세요.*
>
> *이 기간 동안 고객이 구매를 완료하면 감사 메시지를 보내고 종료하세요. 여전히 구매하지 않았다면 할인과 함께 두 번째 알림을 보내고 1시간 더 기다린 다음 Journey를 종료하세요."*
**AI Assistant가 하는 일:** 설명된 분기 로직으로 전체 Journey를 구축합니다.
**이후 확인 사항:** 활성화하기 전에 빌더에서 Journey를 열고 분기, 지연, 메시지가 의도와 일치하는지 확인합니다.
##### 이미 생성한 Journey 편집
같은 대화에서 Journey 변경을 요청하세요. AI Assistant는 새로 만드는 대신 기존 Journey와 그 메시지를 편집합니다.
> *"이제 두 번째 알림의 할인을 10%에서 15%로 변경하세요."*
**AI Assistant가 하는 일:** 정확히 무엇이 변경되는지(푸시 제목, 푸시 텍스트, 단계 이름)를 변경 전/후 표로 보여주는 결정 카드를 표시하고, 확인할 사항을 알려줍니다: 새 할인 코드가 스토어에 존재해야 하며, 할인이 클수록 주문당 마진이 줄어듭니다. 승인하기 전까지는 아무것도 변경되지 않습니다.
**이후 확인 사항:** Journey를 열고 여전히 같은 두 개의 메시지가 있으며 두 번째 메시지의 콘텐츠만 변경되었는지 확인합니다.
Journey가 이미 실행 중이라면 먼저 일시 중지하세요. AI Assistant는 실행 중인 Journey를 편집할 수 없으며, 일시 중지된 동안에는 사용자에게 아무것도 전달되지 않으므로 한가한 시간에 편집을 계획하세요.
### 콘텐츠
##### 이메일 템플릿 생성
> *"할인이나 독점 제공과 같은 특별 인센티브를 제공하여 이전 구매자를 재활성화하는 것을 목표로 하는 온라인 스토어용 이메일 콘텐츠를 만드세요. 목표는 반복 구매를 장려하고 최근에 쇼핑하지 않은 고객을 다시 참여시키는 것입니다. 제안의 가치를 강조하고 강력한 행동 유도 문구를 포함하는 명확하고 설득력 있는 메시지에 집중하세요."*
**AI Assistant가 하는 일:** 생성된 이메일을 템플릿으로 저장하고 이메일 편집기에서 열 수 있는 링크로 회신합니다. 이미지를 직접 추가하지는 않지만, 편집기에서 이미지 블록의 **Generate with AI** 패널에 짧은 설명을 작성하면 이미지를 추가할 수 있습니다.
**이후 확인 사항:** 테스트를 보내기 전에 편집기에서 문구, 이미지, 링크를 검토합니다.
##### 기존 이메일 템플릿 편집
템플릿이 존재하면 변경을 위해 처음부터 다시 만들 필요가 없습니다. AI Assistant에 특정 부분(콘텐츠 블록, 제목, 프리헤더, 발신자 또는 팔레트)을 편집하도록 요청하면 저장된 템플릿이 제자리에서 업데이트됩니다.
> *"'Win-back: 20% off for returning customers' 이메일 템플릿에서 제목 줄이 20% 할인을 더 직접적으로 언급하도록 변경하고, 'Free gift wrapping' 카드를 간편하고 번거로움 없는 반품에 관한 새 카드로 교체하세요."*
**AI Assistant가 하는 일:** 두 가지 변경 사항을 하나의 결정 카드로 제안하며, 이전 및 새 제목 줄과 교체되는 카드의 텍스트를 자세히 보여줍니다. 승인하면 템플릿이 업데이트됩니다. 나머지 콘텐츠는 그대로 유지됩니다.
**이후 확인 사항:** 제목 줄과 교체된 카드가 올바르게 보이는지, 템플릿의 다른 부분은 변경되지 않았는지 확인합니다.
### 인앱 메시지 및 리치 미디어
> *"앱 실행 시 표시되는 인앱 메시지를 만드세요. 헤드라인은 'Welcome back!'이고, 닫기 버튼과 앱 홈 화면으로 연결되는 'See what's new' 레이블의 CTA 버튼 하나를 포함하세요."*
**AI Assistant가 하는 일:** 전체 콘텐츠와 레이아웃이 포함된 결정 카드를 제안하며, 추정한 값(예: 딥 링크)은 확인할 수 있도록 표시합니다. 승인하면 인앱이 저장됩니다. Journey의 앱 실행 이벤트와 같은 트리거에도 연결해야 누군가에게 표시됩니다. AI Assistant는 인앱에 이미지를 추가하지 않습니다. 편집기의 Image 필드는 URL 또는 미디어 스토어의 파일만 허용하며, 기본 제공 생성기는 없습니다.
**이후 확인 사항:** 콘텐츠와 링크가 올바른지 확인한 다음, 사용자에게 도달할 수 있도록 트리거에 연결합니다.
### 바우처 및 프로모션 코드
> *"만료일이 없는 일회용 프로모션 코드 10개로 'Spring Sale'이라는 바우처 풀을 만드세요."*
**AI Assistant가 하는 일:** 결정 카드 없이 풀을 직접 생성합니다. AI Assistant가 코드를 직접 작성하거나(또는 프롬프트에 나열한 코드를 사용하거나) 그 결과와 아직 사용되지 않은 코드 수를 함께 알려줍니다. Pushwoosh는 각 코드가 한 명의 사용자에게만 전달되도록 보장합니다. 코드가 실제로 사용되었는지는 추적하지 않으므로, 1회 사용 제한은 자체 결제 시스템이나 백엔드에서 적용해야 합니다.
**이후 확인 사항:** 메시지나 Journey에서 사용하기 전에 풀에 예상한 수의 코드가 있는지 확인합니다.
### 지오존
> *"[위도], [경도]를 중심으로 반경 500미터의 'Downtown Store'라는 원형 지오존을 만드세요."*
**AI Assistant가 하는 일:** 결정 카드 없이 지오존을 직접 생성하고 상태와 범위를 알려줍니다. 메시지는 선택 사항입니다. 메시지가 없으면 기기가 지오존에 진입할 때 지오존이 `PW_GeozoneEntered` 이벤트를 발생시킵니다. 이 이벤트로 Journey를 시작하고, 메시지와 오디언스는 그곳에서 선택하세요. 반복 진입 사이의 최소 간격(쿨다운)은 API에서 필수이며 기본값이 없습니다. 지정하지 않으면 AI Assistant가 값을 비워 두지 않고 직접 선택하므로, 지오존 경계 근처에 머무는 사람이 반복적으로 트리거하지 않습니다.
**이후 확인 사항:** 위치와 반경이 의도와 일치하는지, 앱에 위치 권한이 있고 SDK의 위치 기능이 활성화되어 있는지 확인합니다. 정확히 0인 좌표(적도 또는 본초 자오선 위의 지점)는 현재 누락된 값으로 처리되어 거부됩니다.
## 분석
데이터를 조사합니다. 시작 프롬프트: *"성과가 저조한 캠페인 진단"*, *"세그먼트 및 채널별 수익 분석"*, *"사용자 Journey의 이탈 지점 찾기"*.
### 분석 및 대시보드
##### 캠페인 성과 보고서 받기
> *"이 앱에서 시작된 모든 푸시 알림 캠페인에 대한 메시지 전송률, 열람률 및 클릭률에 대한 포괄적인 보고서를 캠페인 유형 및 메시지 콘텐츠별로 세분화하여 생성하세요."*
**AI Assistant가 하는 일:** 캠페인 유형과 메시지 콘텐츠별로 나눈 보고서를 각각의 전송률, 열람률, 클릭률과 함께 반환하며, 그 과정에서 발견한 데이터 품질 관련 주의 사항을 알려줍니다. 예를 들어 푸시 클릭률이 열람 수를 기준으로 계산된다는 점(Pushwoosh에는 별도의 푸시 클릭 수가 없음)이나, iOS 설정 누락으로 전송 수가 실제보다 적게 보고된다는 점 등입니다.
**이후 확인 사항:** 이미 알고 있는 수치와 몇몇 캠페인을 대조해 봅니다.
##### 대시보드 구축
> *"이 인앱 캠페인만을 위한 대시보드를 만드세요: 노출 수, 하단 버튼 클릭 수, 고유 사용자 기준 이벤트 X 완료 수."*
**AI Assistant가 하는 일:** 어떤 인앱을 의미하는지, 또는 실제 이벤트 이름이 누락된 경우 이를 묻고, 대시보드는 인앱별로 직접 필터링하거나 단일 버튼의 클릭 수를 집계할 수 없다는 점을 알린 다음, 가장 근접한 대시보드를 구축합니다: 요청된 세 가지 지표를 위젯으로(버튼 클릭 지표는 "상호작용"을 대체 지표로 사용) 구성하고 추세 차트를 추가합니다.
**이후 확인 사항:** 대시보드가 이 인앱만을 대상으로 하는지, 상호작용 위젯이 정확한 버튼 클릭 수로 이중 집계되지 않는지 확인합니다.
##### 세그먼트 재계산
> *"'High-value churners' 세그먼트를 재계산하고 현재 일치하는 사용자 수를 알려주세요."*
**AI Assistant가 하는 일:** 재계산을 시작하고 준비되면 업데이트된 사용자 수를 알려줍니다.
**이후 확인 사항:** 최근 활동을 고려할 때 예상되는 수치와 새 수치를 비교합니다.
### 수익 분석
##### 주간 성장률 계산
> *"지난 30일 동안의 전송 및 수익 수치를 가져와 주간 성장률을 계산하세요."*
**AI Assistant가 하는 일:** 계정에 성장률을 계산할 수익 데이터가 있으면 해당 기간의 전송 및 수익 합계와 주간 성장률을 반환합니다. 추적되는 것이 없으면(연결된 결제 제공업체가 없거나 수익을 포함하는 이벤트가 발생하지 않는 경우) 비율을 보고하는 대신 그 사실을 알려줍니다.
**이후 확인 사항:** 날짜 범위가 요청한 것과 일치하는지 확인합니다.
##### Journey와 컨트롤 그룹 비교
> *"이 Journey의 수익을 컨트롤 그룹과 비교하세요."*
**AI Assistant가 하는 일:** Journey에 자체 홀드아웃 분할이 있는지, 수익을 포함하는 이벤트가 설정되어 있는지 확인합니다. 둘 중 하나라도 없으면 결과를 추측하는 대신 무엇을 추가해야 하는지 정확히 설명합니다. 계정에 계정 전체 컨트롤 그룹만 있는 경우, 해당 그룹은 모든 마케팅을 한꺼번에 측정하므로 Journey 수준의 홀드아웃을 대체할 수 없다고 알려줍니다.
**이후 확인 사항:** 홀드아웃 비율과, 계정 전체 컨트롤 그룹에만 의존하지 않고 Journey 자체에 연결되어 있는지 확인합니다.
##### 수익이 없는 캠페인 찾기
> *"지난 30일 동안 수익을 전혀 창출하지 않은 캠페인을 찾으세요."*
**AI Assistant가 하는 일:** 답변하기 전에 수익이 추적되고 있는지부터 확인합니다. 추적되지 않으면 모든 캠페인이 당연히 해당되므로, 의미 없는 "모든 캠페인" 목록 대신 추적 공백과 계정의 실제 전송 활동을 보고합니다.
**이후 확인 사항:** 수익 추적이 이미 설정되어 있다면 날짜 범위를 확인하고, 요청하지 않은 한 일시 중지되었거나 초안 상태인 캠페인이 포함되지 않았는지 확인합니다.
### 계정 전략
> *"내 계정을 분석하고 수익 중심 계획을 제안하세요: 타겟 세그먼트, 채널, 캠페인 일정."*
**AI Assistant가 하는 일:** 계획을 세우기 전에 수익을 가로막을 수 있는 요소(추적 공백, 도달할 수 없는 오디언스, 빈 세그먼트)를 계정에서 점검합니다. 여기서처럼 점검 결과에 문제가 없으면 바로 어떤 세그먼트를 타겟팅할지, 어떤 채널을 사용할지, 캠페인 일정은 어떻게 할지로 넘어가며, 실행하기 전에 검토할 수 있도록 제시합니다.
**이후 확인 사항:** 제안된 세그먼트와 일정이 현재 캠페인에 적합한지 확인하고, 이후 수치를 신뢰하기 전에 점검에서 지적된 데이터 공백을 해결합니다.
## 구성
무언가를 설정합니다. 시작 프롬프트: *"모바일 SDK 설정(iOS/Android)"*, *"웹 SDK 설정"*, *"이메일 전송 설정"*.
### 전송 설정
> *"이 앱의 푸시 Frequency capping을 사용자당 주 1회 메시지로 설정하세요."*
**AI Assistant가 하는 일:** 애플리케이션 전체에 대한 새 푸시 Frequency capping 한도를 결정 카드로 제안합니다. 승인하면 한도가 변경됩니다. Frequency capping은 세그먼트나 캠페인별이 아니라 애플리케이션 및 채널별로 적용됩니다.
**이후 확인 사항:** 애플리케이션의 Frequency capping 설정에서 새 한도를 확인하고, 이 한도 때문에 여러 단계로 된 Journey의 후반 메시지가 전송되지 못하는 일이 없는지 확인합니다.
### 테스트 기기
> *"iOS 푸시 테스트를 위해 내 휴대폰을 테스트 기기로 등록하세요."*
**AI Assistant가 하는 일:** **Test Devices** 페이지에서 **Add test devices from the app**을 1시간 동안 켭니다. 남은 시간은 토글 옆에 표시됩니다. 이 옵션이 켜져 있는 동안 앱을 여는 것만으로는 충분하지 않습니다: 30초 이내에 앱을 백그라운드로 보냈다가 포그라운드로 다시 가져오기를 6번 반복하면 휴대폰이 자동으로 등록됩니다. 휴대폰의 푸시 토큰이나 기기 ID(HWID)를 이미 알고 있다면 프롬프트에 추가하세요. AI Assistant가 기기를 직접 등록합니다.
**이후 확인 사항:** 새 기기가 올바른 플랫폼으로 테스트 기기 목록에 나타나는지 확인합니다.
### 연동
> *"메시지가 전송될 때 [서버 URL]로 게시하는 웹훅 연동을 만드세요."*
**AI Assistant가 하는 일:** 각 앱에는 웹훅이 하나만 있고 새로 만들면 기존 웹훅이 대체되므로, 먼저 앱의 현재 웹훅 설정을 확인합니다. 그런 다음 대상 URL, 대상 이벤트, 인증 헤더 상태가 포함된 결정 카드를 제안합니다. 기존 설정을 덮어쓰게 되는 경우 카드에 그 사실이 표시됩니다. 연동은 승인한 후에만 작동을 시작합니다.
**이후 확인 사항:** 대상 URL, 대상 이벤트, 범위(모든 메시지 또는 특정 메시지)가 의도와 일치하는지 확인하고, 서버에서 호출이 실제로 Pushwoosh에서 온 것인지 검증해야 한다면 인증 헤더를 추가합니다.
### 사용자 및 액세스
> *"[이메일]을 [그룹] 액세스 권한으로 이 계정에 초대하세요."*
**AI Assistant가 하는 일:** 초대로 할당되는 그룹을 명시한 결정 카드를 제안합니다. 권한은 그룹별로 지정되며, 각 그룹은 애플리케이션별로 See, Modify, Send push 권한을 가집니다. 그룹은 기능이 고정된 역할이 아니므로, 그룹이 실제로 할 수 있는 작업은 계정에서 그룹을 어떻게 구성했는지에 따라 달라집니다. 초대 이메일은 승인한 후에만 발송됩니다.
**이후 확인 사항:** 그룹의 권한을 열고(위 스크린샷 참조) 이 사용자에 대해 See, Modify, Send push가 애플리케이션별로 원하는 대로 설정되어 있는지 확인합니다.
### 지원
> *"이 문제에 대한 지원 티켓을 열고 이 대화의 세부 정보를 포함하세요."*
**AI Assistant가 하는 일:** [Pushwoosh 지원](https://help.pushwoosh.com/hc/en-us/requests/new)으로 직접 이동하는 대신 지원 티켓을 생성하고 제출되면 확인해 줍니다.
**이후 확인 사항:** 티켓 번호를 기록해 두세요. 이후에는 Pushwoosh 지원팀이 후속 조치를 진행합니다.
## 관련 문서
멈춘 Journey나 실패한 전송과 같은 특정 문제를 진단하려면 문제 유형별로 정리된 프롬프트 템플릿이 있는 [AI Assistant로 문제 해결하기](/ko/product/pushwoosh-ai/troubleshoot-with-ai/)를 참조하세요.