요금제 및 추가 기능
Listings 및 Social 등급, 각 등급에 포함된 항목, 모든 추가 기능의 가격, 일할 계산 방식, 셀프서비스 계정의 추가 확장을 제한하는 상한을 설명합니다.
Listings API는 2가지 제품을 판매합니다. Listings는 사업장과 해당 사업장의 디렉터리 등록 현황을 관리합니다. Social은 브랜드를 관리하고 해당 브랜드의 소셜 계정에 콘텐츠를 게시합니다. 두 제품은 가격, 청구, 상한이 각각 별도로 적용됩니다.
Listings
Listings 등급의 가격은 보유할 수 있는 사업장 수를 기준으로 책정됩니다.
요금제에 속한 모든 사업장에서 전체 디렉터리 네트워크, 리뷰 관리, 게시물 및 분석 기능을 이용할 수 있습니다. 등급에 따라 달라지는 것은 보유할 수 있는 사업장 수와 요청 허용량이며, 호출할 수 있는 엔드포인트는 달라지지 않습니다.
Social
Social 등급의 가격은 보유할 수 있는 연결 수를 기준으로 책정됩니다. 연결은 연결 링크를 통해 하나의 네트워크에서 하나의 브랜드에 연결된 소셜 계정 1개를 의미하며, Facebook 페이지, Instagram 비즈니스 계정, X 계정, LinkedIn 조직, Pinterest 보드 등이 이에 해당합니다.
모든 등급에서 브랜드 수는 무제한이며 사용량으로 집계되지 않습니다. 브랜드는 연결된 계정과 해당 계정에서 게시한 게시물을 담는 컨테이너일 뿐이며, 생성 비용이 없고 상한 때문에 생성이 거부되는 일도 없습니다. API 요금제에서는 POST /social/brands에 브랜드 수 제한이 없습니다.
구매하는 대상은 연결입니다. 지원되는 네트워크가 5개이므로 모든 네트워크에 연결된 브랜드 1개는 연결 5개를 사용하며, 따라서 연결 20개는 모든 네트워크에 연결된 브랜드 약 4개, 연결 125개는 약 25개에 해당하지만, 반드시 이렇게 배분해야 하는 것은 아닙니다. 연결 125개를 브랜드 60개에 각각 네트워크 2개씩 연결하는 식으로 분산하거나, 소수의 브랜드에 집중할 수 있습니다.
추가 기능
추가 기능은 가격이 공개되어 있으며, 등급을 변경하지 않고도 언제든지 구매할 수 있습니다.
연결 팩은 여러 개를 구매해 누적할 수 있습니다. 수량 단위로 구매하므로, 2팩은 월 $50에 연결 10개를 추가하고, 3팩은 월 $75에 연결 15개를 추가하는 식입니다. 브랜드별 추가 기능은 없으며 연결 1개만 구매할 수도 없습니다. 구매 단위는 5개입니다. 팩에는 유형 구분이 없습니다. 전체 연결 풀에 연결 5개가 추가되며, 어떤 네트워크와 브랜드에 할당할지는 직접 결정합니다.
연결은 계정 전체에서 공유하는 풀입니다
연결은 브랜드별로 할당되지 않습니다. 요금제 등급과 팩을 합산하여 계정 전체에서 공유하는 하나의 풀을 구성하며, 모든 브랜드가 이 풀을 사용할 수 있습니다:
maxConnections = tier connections + (5 × connection packs)Social Growth에서 팩 2개를 사용하면 계정에서 125 + 10 = 135개의 연결을 사용할 수 있으며, 한 브랜드가 그중 12개를 보유하고 다른 브랜드가 1개를 보유할 수 있습니다. 브랜드별 연결 한도는 없으며, 풀의 한도만 적용됩니다.
슬롯은 연결된 동안에만 사용 처리되는 것이 아니라 청구 기간 전체에 걸쳐 사용 처리됩니다. 풀 사용량은 현재 기간 동안 계정에서 사용한 고유한 연결 수를 기준으로 측정되므로, 채널 연결을 해제하면 즉시 오프라인 상태가 되지만 해당 슬롯은 기간이 갱신될 때까지 사용된 상태로 유지됩니다. 이는 계정의 다른 모든 사용량 축소에 적용되는 규칙과 동일하며(일할 계산 참조), 한 주기 내에서 풀을 재사용할 수 없다는 의미입니다. 즉, 20개를 연결한 후 모두 연결 해제해도 갱신 시점까지 사용량은 여전히 20개입니다.
이에 따라 2가지 사항이 적용됩니다. 동일한 소셜 계정을 동일한 브랜드에 다시 연결하는 것은 무료입니다. 해당 계정이 그 브랜드에서 이미 보유한 슬롯을 재사용하기 때문입니다. 슬롯은 하나의 브랜드와 계정 조합에 속하므로, 동일한 계정을 다른 브랜드에 연결하면 두 번째 슬롯을 사용하며 첫 번째 슬롯은 주기가 바뀔 때까지 유지됩니다. 또한 기간 중 용량을 추가하는 유일한 방법은 팩을 구매하는 것입니다. 추가 기능은 즉시 청구되고 제공되지만, 해제된 슬롯은 주기가 바뀔 때까지 기다려야 하기 때문입니다.
GET /social/limits에서 전체 현황을 확인할 수 있습니다:
추가로 사용할 수 있는 용량은 maxConnections - usage.connections입니다. 풀이 소진되면 연결 링크에서 SY95042를 반환하므로, 개발자가 방금 여러 계정의 연결을 해제했더라도 연결이 거부될 수 있습니다. API 요금제에서는 브랜드 생성 시 이에 해당하는 오류가 발생하지 않습니다.
셀프서비스 상한
추가 기능을 얼마나 많이 구매하든 2가지 절대 상한이 적용됩니다:
- 셀프서비스 Listings 계정에서는 사업장 100개입니다.
- 셀프서비스 Social 계정에서는 연결 250개입니다.
브랜드 수에는 상한이 없습니다. 브랜드 수는 무제한이며, 해당 브랜드들이 사용하는 연결 수가 풀의 한도를 넘지 않는 한 계정에서 원하는 만큼 브랜드를 보유할 수 있습니다.
어느 쪽이든 상한을 초과하려면 계정을 Enterprise로 전환해야 하며, Enterprise에서는 상한을 협의하므로 팩을 더 구매하는 대신 영업팀에 문의해야 합니다. Listings 요금제가 전혀 없는 계정은 사업장을 생성할 수 없으며 SY10155를 받습니다. Social에서는 Social 구독이 없는 경우가 이에 해당하며, 이 경우 모든 /social/* 엔드포인트를 사용할 수 없습니다.
두 번째 제품 추가
한 제품을 보유한 계정은 영업팀에 문의하거나 새 계정을 만들지 않고도 대시보드에서 다른 제품을 구매할 수 있습니다. 각 제품은 별도로 구매했을 때와 동일하게 구독, 갱신일, 해지가 각각 독립적으로 유지됩니다.
각 제품에는 별도의 무료 체험이 제공됩니다. 한 번도 보유한 적이 없는 제품의 Launch 등급은 다른 제품의 유료 고객이더라도 14일 무료 체험으로 시작합니다. Social Launch를 추가하는 Listings Growth 고객에게는 Social의 자체 갱신일을 기준으로 별도의 14일 무료 체험이 제공되며, Listings 청구는 변경 없이 계속됩니다. Social 고객이 Listings Launch를 추가하는 반대의 경우에도 동일하게 적용됩니다.
Launch보다 높은 모든 등급은 구매 당일에 청구되며, 두 제품 모두 Enterprise는 셀프서비스로 판매되지 않고 당사와 협의하여 범위를 정합니다.
체험은 제품별로 1회만 제공됩니다. 이미 체험한 제품을 다시 구매하면 즉시 청구되며, 동일한 제품에 대한 두 번째 무료 기간은 제공되지 않습니다. 구독이 아직 체험 중일 때 추가 기능을 구매하면 해당 체험이 종료되고 유료 청구가 시작되며, 대시보드에서 이 작업이 실행되기 전에 확인을 받습니다.
일할 계산
추가 기능은 즉시 청구됩니다. 추가 사업장이나 연결 팩을 구매하면 즉시 적용되며, 현재 청구 주기의 남은 기간에 대해 일할 계산된 금액이 즉시 청구됩니다. 방금 구매한 용량을 사용하기 위해 다음 청구 주기까지 기다릴 필요가 없습니다.
축소는 청구 주기가 끝날 때 적용됩니다. 해지하거나 제거하는 항목은 남은 기간에 대해 환불되지 않으며, 청구 주기가 끝나기 전에는 해당 항목이 차지하던 용량도 반환되지 않습니다. 이 규칙은 두 제품의 모든 축소에 적용됩니다.
따라서 해제된 연결 슬롯은 해지된 추가 기능과 정확히 같은 방식으로 처리됩니다. API 호출 시점이 아니라 청구 기간이 끝나는 시점에 용량 변화가 적용됩니다. 기다리는 동안 반환될 예정인 용량은 GET /social/limits에서 usage.connectionsReleased로 표시됩니다.
이러한 비대칭은 의도된 것입니다. 언제든지 즉시 용량을 늘리고 실제로 사용한 만큼만 비용을 지불할 수 있으며, 이미 비용을 지불한 용량을 잃는 일도, 같은 기간에 같은 용량을 두 번 사용하는 일도 없습니다.
90일 유지 규칙
사업장이나 브랜드는 생성 후 최소 90일이 지나야 보관 처리할 수 있습니다. POST /locations/archive와 POST /social/brands/archive 모두 이 규칙을 적용하며, 브랜드 엔드포인트는 SY95051과 함께 status: "TENURE_NOT_MET"를 반환하여 이를 알립니다.
이 규칙이 있는 이유는 보관 처리가 구독 규모를 줄이는 방법이기 때문입니다. 이 규칙이 없으면 한 청구 주기 안에 생성하고 보관 처리한 리소스에는 비용이 전혀 발생하지 않습니다. 설계 시 고려해야 할 실질적인 결과가 하나 있습니다. 실수로 생성한 브랜드나 사업장은 90일 동안 제거할 수 없습니다. 생성하기 전에 검증합니다.
유지 기간을 충족한 후의 처리 방식은 제품에 따라 다릅니다.
- 브랜드는 즉시 보관 처리되지만, 해당 연결 슬롯은 즉시 반환되지 않습니다. 브랜드와 여기에 연결된 모든 연결은 동일한 요청에서 보관 처리되고 즉시 오프라인 상태가 되며, 각 슬롯은 직접 연결을 해제했을 때와 똑같이 청구 주기가 끝날 때까지 유지됩니다.
GET /social/limits를 다음에 조회하면usage.connectionsActive의 감소와 그에 상응하는usage.connectionsReleased의 증가가 표시되며, 청구 대상인usage.connections는 갱신 시점까지 변경되지 않습니다. 보관 처리 자체에는 예약 상태가 없으며 취소할 항목도 없습니다. - 사업장은 청구 주기가 끝나는 시점에 보관 처리되도록 예약됩니다. 사업장은 청구 주기가 끝날 때까지 활성 상태로 유지되고 Listings 한도에 계속 산입되며, 그때까지는 사업장 보관 처리 취소를 통해 결정을 되돌릴 수 있습니다.
계정 한도 확인
실패한 뒤가 아니라 생성하기 전에 관련 한도를 확인합니다. 그러면 고객에게 오류 코드 대신 업그레이드 경로를 안내할 수 있습니다.