티켓 하나가 들어옵니다. “확인 메일에 Apple Wallet 버튼을 추가해 주세요.” 간단해 보이지만 막상 찾아보면 Apple의 배지 규정, 서명이 필요한 .pkpass 파일, 그리고 그 버튼이 대체 어디로 연결되어야 하는지에 대한 질문에 부딪히게 됩니다. 버튼 자체는 어렵지 않습니다. 진짜 작업은 실제 패스와 연결하고 위치를 제대로 잡는 일입니다.
한국 시장에서는 여기에 질문이 하나 더 붙습니다. 패스를 저장할 때 발생하는 데이터가 어디에서 처리되느냐입니다. EU 인프라에서 운영되고 GDPR 을 준수하는 설치 링크라면 법무팀이나 보안 담당자가 묻기 전에 답을 미리 준비해 둘 수 있습니다. 이 글은 버튼을 실제로 출시해야 하는 담당자를 위한 실무 가이드입니다. 이메일·웹·앱에서 버튼이 있어야 할 위치, Apple 과 Google 이 강제하는 규칙, 그리고 실제로 패스를 저장하는 살아있는 설치 링크와 연결하는 방법을 다룹니다. 제대로 구현하면 이 버튼은 템플릿 안에서 방치되는 대신 설치율을 실질적으로 끌어올립니다.
버튼이 실제로 있어야 할 위치 (이메일, 웹, 앱)
버튼은 세 곳에서 작동하며, 각각 패스가 가치를 갖는 순간과 맞닿아 있는 자리가 있습니다.
이메일에서는 확인 메일이나 혜택 안내 메일에 넣습니다. 주문 확인, 티켓 확인, 멤버십 가입 완료 메일이 대표적입니다. 한 가지 주의할 점은, 고객이 이메일을 데스크톱에서 먼저 열어볼 수 있다는 것입니다. 이 경우 버튼이 작동하지 않으므로 “아이폰에서 이 메일을 열어 패스를 추가하세요” 같은 문구를 함께 넣어야 합니다.
웹에서는 확인 페이지나 혜택 페이지, 즉 저장 대상이 되는 콘텐츠 근처에 배치합니다. 결제 직후, 예약 확인 페이지, 전용 쿠폰 페이지가 여기에 해당합니다.
앱 안에서는 패스 정보가 이미 표시되는 지점, 즉 패스를 생성하는 행동(구매, 가입, 티켓 발급) 직후에 배치합니다. 네이티브 앱에서는 이미지 대신 Apple 자체의 버튼 컨트롤을 사용합니다.
Apple 의 공식 버튼 가이드라인
Apple 은 이 배지를 상표로 등록된 아트워크로 취급하기 때문에 규정이 엄격하며, App Review 반려나 어색해 보이는 버튼을 피하려면 규칙을 지키는 편이 낫습니다.
웹과 이메일에는 Apple 이 제공하는 다운로드 가능한 SVG 를, QR 코드가 들어간 인쇄물에는 EPS 버전을 사용하세요. 자체 버전을 만들지 말고, 배지의 색상을 바꾸거나 회전시키거나 애니메이션을 넣거나 그림자를 추가하지 마세요. 네이티브 앱에서는 언어와 모양을 자동으로 올바르게 렌더링하는 PKAddPassButton 컨트롤을 사용합니다.
레이아웃에서는 배지 높이의 10 분의 1 이상을 여백으로 확보하고, 흰색이나 밝은 배경 위에 배치합니다. 어두운 배경에는 Apple 이 제공하는 아웃라인 버전을 사용합니다. 배지는 항상 메인 콘텐츠보다 부차적인 위치를 유지해야 하며, 레이아웃을 압도해서는 안 됩니다.
명칭 표기에서는 처음 언급할 때 “Apple Wallet”, 이후에는 “Wallet”으로 표기하고, 법적 고지가 들어가는 곳에는 Apple 의 상표 크레딧 라인을 함께 넣습니다. 이 명명 규칙도 Apple 심사 항목에 포함됩니다.
몇 가지 실수는 버튼을 반려시키거나 조용히 작동하지 않게 만듭니다. 공식 배지 대신 직접 디자인한 배지를 쓰면 심사에서 탈락하고, 목적이 불분명하게 숨겨진 배지는 그냥 무시당합니다.
서명되지 않았거나 손상된 패스로 연결된 링크는 탭해도 아무 일도 일어나지 않으며, “아이폰 월렛에 저장” 같은 일관되지 않은 표기는 브랜드 규정을 위반합니다. 이런 문제는 제공된 아트워크와 올바르게 서명된 패스만 있으면 모두 피할 수 있습니다.
Add to Google Wallet 버튼: 같은 목적, 다른 규칙
두 월렛을 모두 지원한다면(대부분의 소비자 대상 비즈니스가 그래야 합니다) Apple 버튼 옆에 Google 버튼을 배치하게 됩니다. 목적은 같지만 세부 규정은 다릅니다.
한국 시장은 안드로이드 점유율이 여전히 높지만, 아이폰 사용자 비중이 20~30 대와 수도권을 중심으로 꾸준히 늘고 있어 두 버튼을 함께 제공하는 편이 특정 플랫폼에 치우치지 않고 전체 고객층을 포괄하는 방법입니다. 참고로 카카오톡은 월렛 저장 방식이 아니라 설치 링크나 QR 코드를 고객에게 전달하는 채널로 활용하기에 적합한데, 이는 별도의 앱 설치 없이도 링크 하나로 도달률을 높일 수 있기 때문입니다.
Google 의 버튼은 Android XML, SVG, PNG 형식으로 제공되며 검정색 한 가지에 기본형과 압축형 두 종류가 있습니다. 여백은 사방 8dp 로 고정되어 있고, 버튼의 최소 높이는 48dp 입니다. 놓치기 쉬운 규칙이 하나 있는데, 같은 페이지에 다른 버튼이 함께 있다면 Add to Google Wallet 버튼은 그보다 작아서는 안 되고 같거나 커야 합니다.
버튼은 Google Wallet API 플로우를 호출해야 하며, 이 플로우가 Google Wallet 앱을 열어 사용자가 안드로이드 기기와 Google 계정에 패스를 저장할 수 있게 합니다. 명칭 표기에서는 “Google Wallet”을 대문자 G 와 W 로 표기하고, 자체 문구 대신 Google 이 제공하는 현지화된 버튼 텍스트를 사용합니다.
결국 템플릿 한 자리에 두 개의 버튼과 두 개의 규정집이 존재하는 셈입니다. 두 표준에 맞춰 패스를 만들고 두 배지를 나란히 배치하면, 나머지는 고객의 기기가 알아서 처리합니다.
버튼을 실제 설치 링크와 연결하기
배지는 실제로 서명된 패스를 가리키기 전까지는 그저 이미지일 뿐입니다. 고객이 실제로 저장할 수 있는 무언가와 연결하려면 세 가지가 필요합니다.
-
1
사용자별 설치 링크 생성
버튼은 서명된 패스로 연결되는 설치 URL에 링크됩니다. 이 패스는 두 가지 방식으로 만들 수 있습니다. Apple 의 PassKit 프레임워크로 직접 구축해 .pkpass 를 생성·서명하고 링크 호스팅 서비스까지 직접 운영하거나, 서명과 호스팅을 대신 처리해 주는 패스 플랫폼을 이용하는 방법입니다. 전자는 완전한 통제권을 주는 대신 백엔드 리소스가 있는 팀에 적합하고, 후자는 대부분의 마케팅·프로덕트 팀에게 더 빠른 방법입니다. 일반 쿠폰처럼 공유되는 패스라면 링크 하나로 모두를 처리할 수 있습니다. 특정 고객의 포인트가 담긴 멤버십 카드처럼 개인화된 패스라면 사용자별로 고유한 링크를 생성해 저장된 패스에 해당 고객의 데이터가 담기도록 해야 합니다. Pushwoosh Wallet Passes 같은 플랫폼을 쓰면 패스를 한 번만 만들고 이 설치 링크를 생성하면 되며, .pkpass 서명 작업을 직접 처리할 필요가 없습니다. 관련 데이터는 EU 인프라에서 처리됩니다.
-
2
이메일 템플릿에 버튼 삽입
이메일 플랫폼에서 Apple SVG 배지(두 월렛을 모두 지원한다면 Google 버튼도 함께)를 배치하고 링크를 설치 URL 로 설정합니다. 사용자별 패스라면 대부분의 이메일 플랫폼에서 고유 링크를 개인화 변수로 삽입할 수 있어, 수신자마다 버튼이 각자의 패스로 연결됩니다. “아이폰에서 열어주세요” 안내 문구를 추가하고, Apple 규정에 따라 배지를 밝은 배경 위에 유지하세요.
-
3
클릭이 아니라 저장을 추적
배지를 클릭했다고 저장이 완료된 것은 아닙니다. 고객이 패스 추가를 한 번 더 확인해야 합니다. 클릭률이 아니라 설치율을 측정할 수 있도록 실제 저장 완료를 별도 이벤트로 추적하세요. 이 수치가 배치와 혜택이 실제로 효과가 있는지를 보여주며, 결국 최적화해야 할 지표는 이것입니다. 폰에 남는 패스가 진짜 저장된 패스이기 때문입니다.
링크 하나, 모든 채널
사용자마다 고유한 설치 링크를 생성해 채널마다 수작업으로 붙여 넣는 방식은 캠페인 몇 개를 넘어서는 순간 한계에 부딪힙니다. 이 링크는 이메일이든 푸시 알림이든 SMS 든 결국 같은 자산이므로, 한 번만 생성해 모든 곳에서 재사용하는 편이 효율적입니다.
Pushwoosh Wallet Passes 를 사용하면 패스를 만들고 설치 링크를 생성한 뒤, 이를 푸시·이메일·SMS 에 걸쳐 하나의 화면에서 배포할 수 있습니다. 관련 데이터 처리는 EU 인프라에서 이루어집니다. Apple 과 Google 버튼은 같은 패스를 가리키므로, .pkpass 파일을 건드리지 않고도 저장과 업데이트를 관리할 수 있습니다.
Pushwoosh 로 월렛 패스 설치율 높이기
버튼은 한 번만 만들고 링크는 계속 재사용하세요. Pushwoosh Wallet Passes 는 Apple 과 Google Wallet 용 설치 링크를 생성하고, 하나의 대시보드에서 푸시·이메일·SMS 로 배포합니다. ISO 27001:2022 및 SOC 2 Type I 인증을 획득했으며 GDPR 을 준수하는 EU 인프라에서 데이터를 처리합니다.
FAQ
웹과 이메일에는 Apple 이 제공하는 SVG 배지를 수정 없이 사용하세요. 색상 변경, 회전, 애니메이션, 효과 추가는 모두 금지입니다. 배지 높이의 최소 10 분의 1을 여백으로 확보하고, 흰색이나 밝은 배경에 배치하거나(어두운 배경에는 아웃라인 버전) 메인 콘텐츠보다 부차적인 위치를 유지하세요. 앱에서는 이미지 대신 PKAddPassButton 컨트롤을 사용하고, 처음에는 “Apple Wallet”, 이후에는 “Wallet”으로 표기합니다.
아니요. Apple 과 Google 은 각자 버튼 아트워크와 규정을 제공하며 서로 대체할 수 없습니다. 두 월렛을 모두 지원한다면 두 배지를 각각 배치하고, 각각 해당 패스 형식으로 연결하세요. Google 버튼은 검정색 한 가지이며 고정 8dp 여백과 최소 48dp 높이가 필요하고, Google Wallet API 플로우를 호출해야 합니다.
둘 다 가능합니다. Apple 의 SVG 배지와 Google 의 버튼은 이메일과 웹페이지 모두에 맞춰 설계되어 있습니다. 이메일에서 유일하게 주의할 점은, 호환 기기에서 메일을 열었을 때만 패스가 추가된다는 것입니다. 그러니 수신자에게 휴대폰에서 메일을 열어달라는 짧은 안내를 함께 넣으세요.
Pushwoosh Wallet Passes 같은 플랫폼을 사용하면 설치 링크의 생성과 호스팅이 EU 인프라에서 이루어지며, GDPR 을 준수하고 ISO 27001:2022 및 SOC 2 Type I 인증을 받았습니다. 링크에 포인트나 회원 번호 같은 개인화된 고객 데이터가 담기는 순간부터 이 부분이 중요해집니다. 참고로 한국 개인정보보호법에 특화된 별도 인증은 없지만, GDPR·ISO 27001 수준의 보호 체계를 적용합니다.