FastOG 플랫폼 가이드
FastOG는 누군가가 여러분의 페이지 중 하나를 공유할 때 표시되는 이미지를 생성합니다. 상품 페이지, 카테고리 페이지, 홈 페이지, 블로그 게시글이 모두 해당됩니다. 정적인 기본 이미지를 실시간 커버로 대체하며, 여기에는 상품 사진, 현재 가격, 평점, 로고, 그리고 여러분이 선택한 헤드라인이 포함됩니다.
이 가이드는 지도 역할을 합니다. 각 기능이 무엇을 하는지, 각 플랫폼에서 어디를 변경해야 하는지, 그리고 어떤 요금제에 해당 기능이 포함되는지를 다룹니다. API, HMAC 서명, 프레임워크 튜토리얼은 API 레퍼런스에서 시작하십시오.
FastOG가 실행되는 위치
| 플랫폼 | 앱이 위치한 곳 | 판매자가 여는 항목 |
|---|---|---|
| WooCommerce | WordPress 관리자 → FastOG | 커버를 편집하는 Studio, 요금제를 변경하는 Plan, 티켓을 위한 Support, 연결을 위한 Tools |
| Shopify | Shopify 관리자 → Apps → FastOG | Covers, Plan, Support; 고급 연결 세부 정보는 앱 하단에 있습니다 |
| Wix | Wix 대시보드 → Apps → FastOG | Covers, Customize, Plans |
앱을 처음 열면 간단한 설정을 안내합니다. 어떤 페이지 유형에 커버를 적용할지 선택하고 시작 디자인을 고르면 됩니다. 두 가지 모두 나중에 변경할 수 있으며, 설정에서 영구적으로 고정되는 항목은 없습니다.
커버가 선택되는 방식
FastOG는 공유되는 페이지에 대해 URL에 서명합니다. 요청에는 스토어와 페이지 유형이 포함되며, 서버는 해당 페이지 유형에 저장된 규칙을 적용합니다:
- 페이지 유형 규칙 — 제품, 컬렉션/카테고리, 홈 또는 블로그 게시물에 대해 Covers에서 편집한 커버입니다.
- 더 구체적인 규칙이 일치하는 경우 — 태그, 카테고리, 벤더 또는 컬렉션에 대한 규칙이 페이지 유형 규칙보다 우선합니다.
- 제품별 커버가 저장된 경우 — 가장 구체적인 규칙이며, Pro 이상에서 사용할 수 있습니다.
어느 것도 일치하지 않으면 페이지는 테마의 이미지를 유지합니다. 모든 플랫폼은 각 페이지 유형에 고유한 커버를 제공하므로, 제품 커버를 변경해도 홈 페이지에는 영향을 주지 않습니다.
커버와 페이지 유형
Covers(Shopify, Wix) 또는 FastOG → Studio(WooCommerce)를 열고 미리보기 위에서 페이지 유형을 선택합니다.
| 플랫폼 | 페이지 유형 |
|---|---|
| WooCommerce | 상품, 카테고리, 홈, 블로그 글 |
| Shopify | 상품, 컬렉션, 홈, 블로그 글 |
| Wix | 상품, 컬렉션, 홈, 블로그 글, 사이트 페이지 |
각 탭은 고유한 디자인, 고유한 문구, 고유한 라이브 스위치를 가집니다. 한 페이지 유형을 저장해도 다른 페이지 유형은 절대 변경되지 않습니다. 미리보기는 실제 커버입니다. 라이브 페이지가 사용할 것과 동일한 템플릿과 props로 렌더링됩니다.
WooCommerce는 상품 편집 화면에도 작은 커버 패널을 표시하므로, 상품 화면을 벗어나지 않고도 커버를 확인하고 변경할 수 있습니다. Shopify는 같은 이유로 관리자 화면의 상품 페이지에 FastOG 블록을 표시합니다. Wix는 모든 것을 앱 안에서 유지합니다.
디자인 선택
디자인은 커버가 그리는 레이아웃, 즉 템플릿입니다. 선택기에는 전체 카탈로그가 표시되며, 잠긴 디자인은 이를 해제하는 플랜과 함께 표시됩니다.
| 플랜 | 디자인 |
|---|---|
| Community | 무료 세트 |
| Starter | 엄선된 Starter 세트 |
| Pro | 모든 템플릿 |
| Scale | 모든 템플릿 및 우선 렌더링 |
잠긴 디자인은 선택지가 아니라 진열창입니다. 미리 볼 수는 있으며, 업그레이드 안내에는 이를 해제하는 플랜이 명시됩니다. 저장은 서버 측에서 거부되므로 미리보기와 실제 커버가 서로 다를 수 없습니다.
동일한 선택기가 설정 마법사에서 시작할 때도 사용되며, 다른 페이지 유형은 건드리지 않고 한 페이지 유형의 디자인만 변경할 수 있습니다.
문구와 스타일
디자인 다음으로, 편집기에는 두 그룹의 필드가 있습니다:
- 콘텐츠 — 헤드라인, 부제목, 배지, 기능 항목, 이미지 및 해당 템플릿이 출력하는 그 밖의 모든 것. 비워 둔 필드는 템플릿이 채울 수 있을 때 스토어 자체 데이터로 대체됩니다.
- 스타일 — 테마, 색상, 글꼴, 패턴 및 마감. 스타일은 템플릿별로 적용됩니다: 한 레이아웃에서 의미 있는 값이 다른 레이아웃에 강제로 적용되지 않습니다.
WooCommerce 및 Shopify에서는 모든 요금제에서 스토어 전체 규칙의 문구와 스타일을 편집할 수 있습니다. Wix에서는 자유 형식 콘텐츠 및 스타일 필드가 Pro 커스텀 빌더입니다: Starter는 디자인을 선택하며, 프리셋의 고정 필드는 자유롭게 편집되지 않고 표시됩니다.
Pro 전용 제품별 편집기는 동일한 필드를 하나의 항목에 적용한 것(아래 참조)에 로고 재정의를 더한 것입니다.
절대 채울 수 없음으로 표시된 필드는 FastOG가 임의로 만들어내지 않는 필드입니다. 평점이 일반적인 예입니다: 빈 별 행은 가짜 평균으로 채워지지 않습니다.
라이브 신호
라이브 신호는 직접 입력하는 문구가 아니라 내부의 스위치입니다. 이 스위치는 공유 시점에 FastOG가 이미 알고 있는 값을 커버에 표시할지 여부를 결정합니다:
| 신호 | 표시 내용 | 플랜 |
|---|---|---|
| 가격 | 현재 가격. 상품이 할인 중이면 비교가 취소선을 포함합니다 | 모든 플랜 |
| 세일 | 세일 리본 / 비교가 표시 방식 | 모든 플랜 |
| 재고 | 재고 부족("Only 3 left") 및 품절 | 모든 플랜 |
| 평점 및 리뷰 수 | 스토어의 실제 평균 평점과 리뷰 수 | Starter 이상 |
| 평점 하한 | 최소 평점 또는 리뷰 수 미만이면 별점 행을 완전히 숨깁니다 | Pro 이상 |
이 스위치의 핵심은 레이아웃에 필드를 유지하되 데이터가 빈약할 때는 숨길 수 있게 하는 것입니다. 리뷰가 두 개뿐인 평점 3.1점 상품은 가격 옆에 빈약한 별점 행을 두는 것보다 별점 행을 아예 표시하지 않는 편이 보통 더 낫습니다.
신호를 끄더라도 아무것도 삭제되지 않습니다. 값은 여전히 스토어에서 읽어오며, 커버가 이를 출력하지 않을 뿐입니다. 다시 켜면 다음 렌더링에서 다시 표시됩니다.
제품별 및 항목별 커버
제품별 커버는 하나의 항목에 대해 저장된 커버로, 페이지 유형 규칙 위에 덧씌워집니다. 이는 Pro 및 Scale 기능입니다.
| 플랫폼 | 여는 위치 |
|---|---|
| WooCommerce | 제품 편집 화면 → FastOG cover 패널 → Customize cover |
| Shopify | Shopify 관리자에서 제품 열기 → FastOG 제품 블록 → Customize cover |
| Wix | 아직 항목별로 사용할 수 없습니다. 페이지 유형 커버를 사용하거나 모든 제품에 잘 어울리는 룩을 사용하십시오 |
Pro에서는 해당 제품 하나에 대해 룩, 문구, 배지, 스타일을 변경할 수 있습니다. 오버라이드가 없는 제품은 계속 페이지 유형 규칙을 사용합니다. 제품에서 오버라이드를 해제하면 공유 커버가 복원되며, 저장된 선택은 나중에 플랜이 변경되더라도 삭제되지 않고 유지됩니다.
제품 패널은 Studio로도 연결되므로, 제품에 자체 커버가 필요하지 않을 때 스토어 전체 규칙으로 한 번의 클릭으로 이동할 수 있습니다.
제품 라인별 규칙
범위 지정 규칙(scoped rule)은 제품 그룹, 즉 태그, 카테고리, 제품 유형, 컬렉션(Shopify) 또는 벤더에 대한 제품 커버를 세분화합니다. 이 기능은 Scale 요금제 기능입니다.
Covers → Covers for specific products를 엽니다(제목은 WooCommerce와 Shopify에서 동일합니다). 규칙을 추가하고 범위와 디자인을 선택한 뒤 저장합니다. 일치하는 제품은 해당 규칙의 디자인과 문구를 사용하며, 그 외의 제품은 페이지 유형 커버를 유지합니다.
가장 구체적으로 일치하는 규칙이 우선 적용되므로 순서를 관리할 필요가 없습니다. 규칙 카운터는 요금제에서 허용된 수량 중 사용한 수를 보여주며, 규칙은 언제든지 삭제할 수 있습니다. Wix는 아직 범위 지정 규칙을 지원하지 않습니다.
캠페인과 예약 복귀
예약 복귀는 캠페인의 안전한 절반입니다. 지금 블랙 프라이데이 또는 시즌 커버를 게시하고, 이전에 게시되어 있던 커버로 되돌아갈 날짜와 시간을 선택합니다. 복귀 절반은 Community를 포함한 모든 플랜에서 사용할 수 있습니다.
예약 시작은 Scale의 절반입니다. Scale에서는 캠페인 커버가 게시될 날짜도 설정할 수 있습니다. Scale 미만에서는 시작이 일시 중지되며, 디자인과 날짜는 유지되어 업그레이드 시 재개할 수 있습니다. 두 전환 모두 5분마다 확인되며, 시간은 필드 아래에 표시된 시간대를 사용합니다.
두 절반 모두 끝이 필요합니다. 시작은 있지만 끝이 없는 캠페인은 절대 내려오지 않으므로, 양식에서 이를 거부합니다. 끝을 지우면 캠페인이 취소됩니다. 플랜이 만료되어도 삭제되는 것은 없으며, 날짜와 디자인은 유지됩니다.
PNG 내보내기
Download PNG 작업은 현재 보고 있는 커버를 1200×630 크기로 렌더링하여 다운로드합니다. 이 기능은 WooCommerce와 Shopify에서 Pro 및 Scale 기능이며, Wix에서는 아직 제공되지 않습니다.
파일은 편집기 자체의 템플릿과 props로 생성되므로 별도의 내보내기 템플릿이 아니라 미리보기와 일치합니다. 라이브 URL을 사용할 수 없는 마켓플레이스 등록, 발표 자료 또는 수동 게시물에 사용하십시오.
플랜, 커버리지 및 한도
FastOG는 렌더 크레딧이 아니라 커버리지를 판매합니다. 플랜은 자체 카탈로그 항목 수와 기능 집합을 커버하며, 렌더 수에는 제한이 없습니다.
| Community | Starter | Pro | Scale | |
|---|---|---|---|---|
| 가격 | 무료 | $19 / 월 | $49 / 월 | $119 / 월 |
| 커버 항목 | 100 | 250 | 1,000 | 무제한 |
| 페이지 유형 | 전체 | 전체 | 전체 | 전체 |
| 룩 | 무료 세트 | 큐레이션 세트 | 전체 | 전체 |
| 가격, 할인 및 재고 | 예 | 예 | 예 | 예 |
| 평점 (별점 + 개수) | — | 예 | 예 | 예 |
| 평점 하한 | — | — | 예 | 예 |
| 제품별 커버 | — | — | 예 | 예 |
| 메타필드 매핑 | — | — | 예 | 예 |
| PNG 내보내기 | — | — | 예 | 예 |
| 제품 라인 규칙 | — | — | — | 예 |
| 캠페인 시작 | — | — | — | 예 |
| 예약 반환 | 예 | 예 | 예 | 예 |
| 우선 렌더링 | — | — | — | 예 |
커버리지 패널은 플랜이 커버하는 항목 수를 제품, 카테고리, 홈 및 블로그 게시물별로 분류하여 보여줍니다. 카탈로그가 한도를 초과하면 패널에 다음 플랜과 해당 한도가 표시되며, 렌더링이 조용히 중단되지는 않습니다. Plan(WooCommerce, Shopify) 또는 Plans(Wix)에서 업그레이드하십시오.
연간 결제는 동일한 등급을 12개월 기준 10개월 요금으로 제공합니다. Wix는 Wix를 통해 청구되며, WooCommerce와 Shopify는 앱 내 플랜 화면을 통해 청구됩니다.
Wix는 동일한 단계를 사용하지만 아직 제품별 재정의, 범위 지정 규칙 또는 PNG 내보내기를 제공하지 않습니다. 해당 플랫폼에서도 플랜은 커버리지, 룩, 평점 및 사용자 정의 빌더를 제어합니다.
상태 확인 및 캐시 새로 고침
앱은 짧은 상태 확인을 실행하며 전체 목록은 세부 정보 / 확인한 항목 뒤에 표시합니다. 이는 미리보기를 실제로 망가뜨리는 질문들에 답합니다:
- FastOG가 이 스토어의 데이터와 카탈로그를 읽을 수 있습니까?
- 스토어프론트의
og:image가 FastOG를 가리키고 있습니까, 아니면 테마나 SEO 플러그인이 우선하고 있습니까? - 샘플 제품이 실제 제품이며, 미리보기가 이를 사용하고 있습니까?
- 서명 키와 연결이 여전히 유효합니까?
각 발견 항목에는 해결 방법이 존재하는 경우 함께 제공됩니다. report는 지원 메시지에 복사할 블록이며, 해석하기 위한 것이 아니라 붙여넣기 위한 것입니다.
커버가 변경되었다고 해서 항상 플랫폼이 다시 읽은 커버인 것은 아닙니다. 서명된 URL은 결정적이므로 이미지 자체는 업데이트됩니다. 캐시되는 것은 플랫폼이 보관하는 페이지 미리보기 사본입니다. 다시 스크레이프하거나 플랫폼의 캐시가 만료될 때까지 기다리십시오. 캐시 가이드와 Facebook 새로 고침 강제하기를 참조하십시오. 페이지의 og:image가 여전히 테마의 것이라면, 상태 확인에서 다른 플러그인이나 테마가 우선하고 있음이 표시됩니다.
지원
설정, 커버 전달, 결제 또는 제품 문제에는 지원을 사용하십시오. 영향을 받은 페이지나 제품, 기대한 동작과 실제로 발생한 일을 포함해 주십시오. 상태 보고서(health report)가 가장 빠른 첨부 자료입니다. 이는 실시간 채팅이나 일반 상담이 아닌 비동기 제품 지원입니다.
티켓을 열기 전에 상태 점검(health check)을 시도해 보십시오. 상태 점검은 흔한 원인(연결되지 않음, 커버를 제공하지 않음, SEO 플러그인이 og:image을 재정의함, 오래된 플랫폼 캐시)을 잡아냅니다.
한 페이지로 보는 문제 해결
| 증상 | 먼저 확인할 것 |
|---|---|
| 공유 링크에 이미지가 없습니다 | 상태 확인 → 스토어프론트가 og:image FastOG의 것인가요? 페이지 유형이 지원되나요? |
| 미리보기에 이전 가격이 표시됩니다 | 플랫폼의 캐시입니다. 라이브 URL은 렌더링마다 서명됩니다. 페이지를 다시 스크레이핑하세요 |
| 커버가 잘못된 모양입니다 | 페이지 유형 규칙, 범위 지정 규칙 또는 제품별 재정의입니다(가장 구체적인 것이 우선합니다) |
| 잠긴 모양이 저장되지 않습니다 | 상위 플랜에 속해 있습니다. 선택기에 플랜 이름이 표시됩니다 |
| 평점이 누락되었습니다 | 제품에 아직 리뷰가 없거나, 플랜이 Starter 미만이거나, 평점 스위치가 꺼져 있습니다 |
| 제품별 변경이 아무 효과가 없습니다 | 제품별 커버는 Pro/Scale이며, 그 미만에서는 서버가 저장을 거부합니다 |
| WhatsApp에서 커버가 흐릿합니다 | OG 이미지 크기 및 WhatsApp 미리보기를 참조하세요 |