서명 마케팅 캠페인 실행하기
캠페인은 지정된 시간 동안 할당된 서명 아래에 렌더링되는 배너입니다. 초안으로 생성되며, 예약되기 전까지는 아무 작업도 수행하지 않습니다.
만들기
- **
get_content_schema**를 먼저 호출하여content를 작성합니다. 캠페인의 콘텐츠는 서명의draft_content와 동일한 엄격한 블록 트리입니다 (자식이 블록인stack루트). 반환된example을 참고하세요. 형식을 추측하지 마십시오. - **
create_marketing_campaign**에는name,start_time,end_time(ISO-8601) 및time_zone(IANA, 예:Europe/Paris)이 필요합니다. 하나라도 누락되면 422 오류가 발생합니다. 선택 사항:content, 타겟팅 필드smart_fields_conditions및signature_template_ids. - **
preview_marketing_campaign**은 배너를 HTML로 렌더링하며, 추적 없이 플레이스홀더 값을 사용합니다. 예약하기 전에 이를 읽고 레이아웃을 확인하십시오.html이 비어 있으면 캠페인에 콘텐츠가 아직 없음을 의미합니다. - **
update_marketing_campaign**은 부분 업데이트입니다 (생략하면 변경되지 않음,content: null은 콘텐츠를 지움).status는 읽기 전용입니다. 아래 수명 주기 도구를 통해서만 변경됩니다.
실행하기
| 작업 | 도구 | 거부하는 경우 |
|---|---|---|
| 초안 또는 일시 중지된 캠페인 활성화 | schedule_marketing_campaign | 예약 불가능한 경우 409 (예: 종료 시간이 지남); 캠페인이 없는 요금제는 403 |
| 활성 캠페인 일시 중지 | pause_marketing_campaign | 활성 상태가 아닌 경우 409 |
| 일시 중지된 캠페인 재개 | resume_marketing_campaign | 일시 중지되지 않은 경우 409; 요금제 문제 시 403 |
| 삭제 | delete_marketing_campaign | 먼저 활성 캠페인을 중지합니다 |
예약된 캠페인은 start_time이 이미 지난 경우 즉시 활성화되고, 그렇지 않으면 해당 시간까지 대기합니다. 사용자와 확인 후 예약하세요. 예약하면 발신 회사 이메일에 배너가 표시됩니다.
타겟팅하기
signature_template_ids는 캠페인을 특정 서명으로 범위를 지정합니다.smart_fields_conditions는 팀원 속성에 따라 범위를 지정합니다 (서명 수신자 규칙과 동일한 OR-of-ANDs 형식).- 둘 다 비워 두면 전체 작업 공간에 적용됩니다.
- 서명 변형은
show_marketing_campaigns설정을 통해 배너를 선택 해제할 수 있습니다.
측정하기
캠페인의 ID를 get_analytics_views 및 get_analytics_clicks에 marketing_campaign_id로 전달하여 자체 조회수, 클릭수 및 클릭률을 확인합니다. group_by: "marketing_campaign"는 캠페인 간 순위를 매깁니다. get_analytics_events_summary는 다운스트림 전환 이벤트를 귀속시킵니다. 자세한 내용은 signature-analytics 스킬을 참조하세요.