KeywordTracking

키워드 랭킹 추적 — RankableItem 추상화 + rank_diff/trend 자동 분류

상태

항목	값
Layer	composite
Tier	L1
Status	wip
Version	0.9.0
가격	Free (free)
**카�
�고리**	Infrastructure

개요

개요

KeywordTracking 은 multi-saas-kit 의 Layer 2 Composite Plugin � 니다. scout.how 의 BookKeyword 랭킹 추적 로직을 일반화하여 키워드/제품/문서 등 임의 항목의 순위 변동 추적을 표준화합니다.

핵심 컴포넌트

RankableItemInterface

프로젝트 모델이 구현하는 4개 메서드 인터페이스:

• getRankableId(): int|string
• getRankableLabel(): string
• getCurrentRank(): ?int
• getPreviousRank(): ?int

scout.how BookKeyword 외에도 ProductKeyword / ArticleKeyword 등 새 도메인에 즉시 적용 가능.

KeywordRankingCalculator (Pure)

• rank_diff = previous - current (양수=올라감, 음수=떨어짐)
• trend 자동 분류: rising / falling / stable / new / dropped
• threshold 기반 (default ±3)

설정

return [
    'enabled' => env('PLG_KEYWORD_TRACKING_ENABLED', true),
    'trend' => [
        'rising_threshold' => 3,
        'falling_threshold' => 3,
        'new_entry_value' => 'new',
        'dropped_value' => 'dropped',
    ],
];

출처

scout.how App\Models\BookKeyword 의 rank_diff / trend 결정 로직을 추상화. 모델 의존 제거 후 인터페이스 기반.

라이선스

MIT

데모

• Platform 관리자 패널에서 메타 확인 🔒 로그인 필요
• 사용 예시 (PHP)

---

🛒 Plugin Store에서 보기: store.codebase.how/plugins/keyword-tracking