캘린더에 추가 링크
이벤트, 세일 또는 약속을 홍보할 때, 이메일에 “캘린더에 추가” 링크를 추가하면 사용자가 쉽게 캘린더에 이벤트를 저장할 수 있습니다.
이를 위해 이메일을 작성하고 링크를 배치할 위치를 결정합니다. 그런 다음 두 가지 옵션을 추가합니다: 하나는 Google 캘린더용이고 다른 하나는 기타 캘린더(iCal 또는 Outlook 등)용입니다. 예를 들어, “Google 캘린더에 추가”와 “iCal 또는 Outlook에 추가”입니다.

URL 형식
다음 URL을 링크에 추가하고 플레이스홀더를 교체합니다. 이 두 URL의 유일한 차이점은 Google 캘린더에 추가 매개변수 &format=gcal이 필요하다는 것입니다.
1
https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION&format=gcal
1
https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION
다음을 교체합니다:
EVENT_SUBJECT: 이벤트 제목EVENT_LOCATION: 이벤트 위치START_TIME: ISO 8601 형식(YYYY-MM-DDTHH:MM:SSZ)의 UTC 기준 이벤트 시작 시간END_TIME: ISO 8601 형식(YYYY-MM-DDTHH:MM:SSZ)의 UTC 기준 이벤트 종료 시간EVENT_DESCRIPTION: 이벤트 설명
공백은 HTML 이스케이프 코드 %20으로 교체합니다. 예를 들어, “Meet Braze”라는 제목은 “Meet%20Braze”가 됩니다.
다음은 “Google 캘린더에 추가” URL의 예시입니다:
1
https://ics.agical.io/?subject=Meet%20Braze&location=114%20Sansome%20Street&dtstart=2021-06-24T15:00:00Z&dtend=2021-06-24T16:00:00Z&description=Braze%20Party&format=gcal
추가 매개변수
다음 매개변수는 선택 사항이며 이벤트의 추가 속성을 정의하는 데 사용할 수 있습니다.
- 주최자 이름:
&organizer=name - 이벤트 관련 URL 첨부:
&attach=http://www.example.com/ - 기간:
duration=30M, 이벤트 종료 시간(dtend) 대신 1H 또는 30M과 같은 기간을 지정할 수 있습니다 - 알림 시간(분 단위):
&reminder=15 - 종일 이벤트:
&allday=1 - UID: 이벤트의 고유 식별자를 하드코딩하는 선택적 매개변수로, 일부 캘린더 앱에서 시간이 지남에 따라 이벤트를 업데이트할 수 있게 합니다. 문자열 @ics.agical.io가 값에 자동으로 추가됩니다.
반복 이벤트를 위한 추가 매개변수도 사용할 수 있습니다:
- 주간 이벤트:
&recur=weekly - 월간 이벤트:
&recur=monthly - 반복 종료:
&recuruntil=END_DATE, 여기서END_DATE는 ISO 8601 형식(YYYY-MM-DDTHH:MM:SSZ)의 UTC 기준 반복 종료 날짜 및 시간입니다
링크 동작
사용자가 링크를 클릭하면, 캘린더가 URL의 UTC 타임스탬프를 사용자의 캘린더에 설정된 시간대에 맞게 자동으로 변환합니다.
예를 들어, “Google 캘린더에 추가” 예시 링크를 열고 캘린더가 CST로 설정되어 있다면, 이벤트 시간은 오후 3시 UTC가 CST에서 해당하는 시간(오전 10시)으로 미리 채워집니다.
Google 캘린더
클릭하면 Google 캘린더가 새 탭 또는 창에서 열리며, 이벤트 세부 정보가 초대에 미리 채워져 사용자가 바로 저장할 수 있습니다. 이는 모바일과 데스크탑 모두에서 동일하게 작동합니다.

iCal 또는 Outlook
데스크탑에서 클릭하면 ICS 파일이 다운로드됩니다. 사용자가 ICS 파일을 열면 iCal 또는 Outlook이 열리고 캘린더에 이벤트를 추가하라는 메시지가 표시됩니다.


모바일에서는 사용자가 링크를 길게 누르면 캘린더에 추가하라는 메시지가 표시됩니다.

자세한 내용은 다음을 참조하세요: