도움말 · 바스케이션 광고 자동화

1. 한눈에 보기

이 시스템은 자사 5개 브랜드(천비누솝 · 모그라미 · 달콤라이프 · 세남자바스켓 · 드실랩)와 경쟁사들의 메타 광고 + 매출 정보 를 한곳에서 보는 사내 대시보드입니다. 백그라운드에서 알아서 돌아가는 부분과, 사람이 직접 누르는 부분이 명확히 나뉘어 있습니다.

🤖 자동 처리 (켜둔 채로 둠)

등록된 경쟁사 광고 자동 크롤링 — 1시간마다
자사 키워드로 새 경쟁사 자동 발굴 — 3시간마다
크롤 큐 워커 — 2분마다 처리
새 경쟁사 등록 시 잡코리아/사람인에서 매출 자동 조회

👤 사람이 하는 일

새 경쟁사 등록 (모달 또는 키워드 검색 발굴)
광고 카드 즐겨찾기 / 메모 작성
특정 경쟁사 즉시 크롤링 트리거
매출 안 잡히면 수동 편집

💡 팁: 자동 처리 도중 사용자가 [▶ 크롤링]/[🔍 발굴]/검색 발굴을 누르면 자동 작업이 30분간 자동 일시정지 됩니다. 충돌 걱정 없이 마음껏 누르세요.

2. 갤러리 페이지 /

메타 광고 라이브러리에서 크롤링한 광고 카드들을 카드 그리드로 보여줍니다. 현재 메타에 게재 중인 광고만 가져오며, 게재 중단된 광고는 자동으로 표시되지 않습니다.

광고 카드 한 장의 구성

광고주명 — 메타에 표시되는 페이지 이름. 매칭된 자사/경쟁사 브랜드가 함께 표시됨
광고문 — 광고 본문 텍스트
미디어 — 첫 번째 이미지 또는 영상 썸네일. 클릭 시 상세 페이지에서 전체 미디어 확인
게재 N일째 — 메타에 등록된 게재 시작일 기준
⭐ 별 아이콘 — 클릭 시 즐겨찾기 ON/OFF

필터 / 검색

상단 탭: 전체 / ⭐ 자사 5개 / ⭐ 즐겨찾기 (내가 별표 친 광고만)
키워드 검색: 광고문/광고주명에서 부분 일치 검색
게재 N일 이상 필터: 오래 돌고 있는 광고만 보고 싶을 때 (롱런 광고 = 효과 좋은 광고일 가능성)

3. 경쟁사 관리 페이지 /competitors

이 페이지에서 경쟁사를 등록·편집·삭제하고, 즉시 크롤링을 트리거합니다.

자사 5개 카드 (페이지 상단)

각 자사 카드 = 그 자사 + 그 자사 그룹에 묶인 경쟁사들의 광고를 모두 합쳐서 보여줌
우상단 [🔍] 버튼 → 그 자사 기준 유사 브랜드 자동 발굴

경쟁사 카드 정보

브랜드명 + 광고 수
도메인 — 클릭하면 새 탭에서 해당 사이트가 열림 (↗ 표시)
매출 — 잡코리아/사람인에서 자동 조회한 매출액. 없으면 [💰 매출 조회] 버튼
검색 키워드 — 메타 광고 라이브러리에서 이 경쟁사 광고를 찾기 위한 일반 키워드 목록
최근 크롤 시각

카드 액션

버튼	동작
📂 광고	갤러리로 이동해 이 경쟁사 광고만 필터링
▶ 크롤링	크롤링 큐에 즉시 추가. 검색 키워드별로 큐 항목 자동 생성. 자동 토글이 30분 일시정지됨
🔍 유사 브랜드	이 경쟁사 기준 유사 브랜드 자동 발굴 (네이버 파워링크). 결과는 카드 아래 펼침
💰 매출 조회	잡코리아 → 사람인 → 크레딧잡 순으로 시도. 5~15초 소요
⋯ 메뉴	[✏️ 편집] / [🗑️ 삭제]

일괄 작업

각 경쟁사 카드 좌상단 체크박스 를 켭니다 (자사 카드엔 체크박스 없음)
상단 빨간 액션 바에 "N개 선택됨" 이 떠요
[🗑️ 선택 삭제] → 확인 팝업에 "광고 NN건도 함께 삭제됩니다" 경고. OK 누르면 일괄 삭제

크롤링 큐 현황 (페이지 하단)

최근 15개 크롤 작업의 상태를 5초마다 자동 갱신. 진행 중 항목은 파란색.

대기 → 큐에 들어가 워커 대기 중
진행중 → 워커가 메타 광고 라이브러리 크롤링 중
완료 → 결과를 DB에 저장 완료
실패 → 에러 메시지 확인

4. 새 경쟁사 발굴 — 3가지 방법

① 키워드 검색 발굴 (가장 권장)

경쟁사 관리 페이지 중간 [🔎 키워드 검색 발굴] 패널에서 일반 제품 키워드로 즉석 검색.

검색어 입력 — 예: 남자팬티, 마스크팩, 어성초 비누
(옵션) 자사 그룹 선택 — 등록 시 자동 분류됨
[🔍 검색] → 네이버 파워링크 광고 상위 15개 가 표시
각 결과에 [+ 추가] / [+ 통과 항목 전부 추가]
등록 직후 백그라운드로 매출 자동 조회. 3~10초 후 새로고침하면 카드에 매출 표시

쿠팡/G마켓/11번가 등 종합몰 32개는 자동 제외됩니다 (우측 패널에서 관리).

② 자사 카드 [🔍] 버튼

자사 카드 우상단 [🔍] 누르면 자사의 키워드/카테고리 시드로 유사 브랜드 자동 발굴. 결과 후보는 점수와 함께 통합 패널에 표시됩니다. 각 후보에 [+ 추가] / [숨김] / [거절] 가능.

③ 모달로 직접 추가

페이지 우상단 [+ 경쟁사 추가] → 모달:

브랜드명 (필수)
자사 그룹 — 어느 자사와 같은 시장인지
검색 키워드 — 메타 광고 라이브러리에서 검색할 일반 제품 단어 (쉼표 구분)
예: 크림, 앰플, 에센스, 토너
랜딩 도메인 — 매칭의 핵심. 광고주명이 영문/한글로 달라져도 도메인이 일치하면 정확 매칭
예: themedicube.co.kr, medicube.co.kr

💡 동시에 자동도 돌아갑니다: systemd 타이머가 3시간마다 자사 5개를 무작위 순회하며 파워링크 발굴을 실행합니다. 자동 토글이 ON이면 사용자가 아무것도 안 해도 새 경쟁사가 자동 등록됩니다 (등록 시 매출도 함께 조회).

5. 매출 정보

데이터 소스 (자동 시도 순서)

잡코리아 회사 상세 페이지의 매출액 테이블 — 가장 정확
사람인 검색 카드의 "매출액 N억" — 폴백
크레딧잡 — 최후 폴백

언제 자동 조회되나요?

새 경쟁사가 등록될 때 자동 (등록 후 3~10초 안에 카드에 표시)
카드의 [💰 매출 조회] 버튼을 누를 때
페이지 상단 [💰 매출 일괄 갱신] 누르면 매출 없는 비-자사 항목 일괄 조회 (1건당 2~5초 대기, 30개면 약 2~3분)

왜 매출이 안 잡힐 때가 있나요?

한국 D2C 브랜드는 본사가 잡코리아/사람인에 등록되지 않은 경우가 많음
동명 의원/지점/대리점이 잘못 잡히지 않도록 엄격 매칭 정책 — 정확 매칭만 채택, 의심스러우면 "매칭 없음"
이 경우 모달 편집에서 직접 입력하시면 됩니다 (구글에서 "{브랜드명} 매출액" 검색하면 보통 바로 나옴)

매출 표기

원 단위로 저장하고 카드에는 279억 7,884만 같은 한국식 표기로 노출됩니다. 회계 연도(YYYY년)와 출처(↗ 외부 링크)도 함께 표시.

6. 자동 업데이트 토글

모든 페이지 상단 우측의 칩 한 번으로 전체 자동 동작을 ON/OFF.

3가지 상태

🟢 자동 ON 정상 가동. systemd 타이머가 1h/3h 마다 자동 광고 크롤 + 경쟁사 발굴 실행
⏸ 자동 수동 작업이 들어와 30분 락. NN분 후 자동 재개. 락 중에도 큐 워커는 동작 (이미 들어온 큐 처리)
⚫ 자동 OFF 모든 자동 작업 중단. 사용자 토글 OFF 한 경우 — 점심시간/외부 망 점검 등에

수동 락이 걸리는 동작

아래 동작 중 하나라도 누르면 자동으로 30분 락:

경쟁사 카드 [▶ 크롤링]
경쟁사 카드 [🔍 유사 브랜드] / 자사 카드 [🔍]
키워드 검색 발굴 [🔍 검색]

[💰 매출 조회] 는 외부 사이트(잡코리아/사람인) 호출이라 자동 크롤과 충돌이 없어 락이 안 걸립니다.

OFF 로 바꾸면 어떻게 되나요?

다음 systemd 타이머 발화 시 스크립트가 시작되자마자 즉시 종료
이미 큐에 들어간 항목은 워커가 그대로 처리 (자동/수동 무관)
다시 ON 으로 바꾸면 다음 타이머에서 정상 재개

7. 닉네임 / 즐겨찾기

즐겨찾기는 사용자별로 분리 됩니다 — 옆자리 동료가 별표 친 광고는 나에게 안 보임.

닉네임 설정

헤더 우측 👤 버튼 클릭
이름 입력 (영문/한글/숫자/공백/._- 1~32자)
빈 값으로 두면 익명 모드 (쿠키 UID 일부로 식별)

쿠키 기반이라 다른 브라우저/시크릿 창에서는 별개 사용자로 인식됩니다. 여러 기기에서 같은 즐겨찾기를 보려면 닉네임을 동일하게 설정하세요.

즐겨찾기 사용

광고 카드의 별 아이콘 (☆ → ⭐) 클릭으로 토글
갤러리 상단 [⭐ 즐겨찾기] 탭 또는 /?fav=1 로 내가 별표 친 광고만 필터

8. 자주 묻는 질문

Q. 광고 카드는 어떻게 갱신되나요?

시스템이 1시간마다 등록된 경쟁사 중 마지막 크롤이 6시간 이상 지난 항목 을 자동 선택해 크롤링 큐에 추가합니다. 큐 워커가 2분마다 처리합니다. 자동 토글이 ON 이면 별도 조작 없이 카드가 갱신됩니다.

Q. 새 경쟁사를 등록하면 광고는 언제 채워지나요?

등록 즉시 자동 크롤이 트리거되는 게 아니라, 다음 자동 크롤 시점(최대 1시간 후) 또는 카드의 [▶ 크롤링] 을 직접 누르면 바로 큐에 들어갑니다. 큐 워커가 2분 안에 잡아 처리합니다.

Q. 매출 정보가 비어있어요

한국 D2C 브랜드 본사는 잡코리아/사람인에 등록되지 않은 경우가 많습니다. 카드의 [💰 매출 조회] 로 재시도하거나 모달 편집에서 직접 입력해 주세요. (DART API 키 승인되면 공식 공시 매출도 추가 예정)

Q. 경쟁사를 삭제하면 광고도 사라지나요?

네, 매칭되는 광고 카드도 함께 삭제됩니다 (첨부 이미지/영상 메타·메모 포함). 삭제 전 팝업에 "광고 N건도 함께 삭제됩니다" 경고가 표시되니 확인 후 진행하세요. 삭제는 복구 불가입니다.

Q. 자사 브랜드를 삭제할 수 있나요?

자사 5개 브랜드는 삭제 불가 입니다 (일괄 삭제에서도 자동 제외). 편집은 가능하지만 브랜드명 변경은 잠겨있습니다.

Q. 키워드 검색 발굴은 어디서 데이터를 가져오나요?

네이버 검색 결과의 파워링크 광고 상위 15개 입니다. 등록된 제외 키워드/도메인(쿠팡·G마켓·11번가 등 32개 기본 시드)은 자동으로 필터됩니다. 우측 패널에서 자유롭게 추가/제거 가능.

Q. 자동 토글을 켜둔 채로 두면 부담이 되나요?

자체 크롤러는 무료, 네이버 API 는 무료 한도 안에서 캐시(SHA-256) 동작. AWS Lightsail Seoul 인스턴스(월 고정) + S3 스토리지만 비용 — 켜둬도 부담은 동일합니다.

Q. 같은 광고가 메타에서 사라졌다 다시 등록되면 중복 저장되나요?

아니요. library_id 가 같으면 UNIQUE 제약으로 차단되고, library_id 가 새로 발급되어도 (광고주 + 광고문 앞 200자) SHA-1 해시로 2단계 중복 감지가 동작합니다.

Q. 화면이 한참 안 바뀌어요

크롤링 큐 현황은 5초마다, 자동 토글 상태는 60초마다 자동 갱신합니다. 그래도 변화가 없다면 페이지 새로고침. 큐 진행중 항목이 오래 머물면 메타 응답이 늦는 경우라 최대 1~2분 기다리거나 큐 항목 옆 [취소] 로 강제 중단할 수 있습니다.

Q. 시스템에 문제가 생기면 어디를 보면 되나요?

서버는 AWS Lightsail Seoul (IP 43.201.12.162)에서 systemd 로 관리됩니다 — cb-gallery.service, cb-gallery-worker.timer, cb-auto-crawl.timer, cb-power-link.timer. 관리자(개발팀)에게 문의 주세요.

📖 사용 가이드