• 백엔드 서버가 실행 중이어야 합니다. 터미널에서 cd backend && python main.py를 먼저 실행하세요.
• 애드팝콘 어드민 / 아바티 어드민 계정이 있어야 합니다.
• 브라우저 로그인 세션은 자동으로 유지됩니다. 처음 실행 시 브라우저 창이 열리면 각 어드민에 로그인하세요.
• 매핑 파일(app_mapping.json)이 최신 상태인지 확인하세요. 오래됐으면 매핑 관리 탭에서 새로고침하세요.

왼쪽 앱 목록 컬럼 하단의 입력창에 애드팝콘 매체키를 입력하고 Enter 또는 + 추가 버튼을 누릅니다.

• 여러 앱을 한 번에 추가하려면 일괄 추가 버튼으로 줄바꿈 구분 입력이 가능합니다.
• 매체키가 app_mapping.json에 없으면 추가되지 않습니다. 먼저 매핑 관리에서 수동으로 등록하거나 새로고침을 실행하세요.

추가된 앱을 클릭하면 오른쪽에 앱 설정이 펼쳐집니다. 세팅할 주제를 선택하세요.

• 버즈빌 주제(버즈배너 등)와 아바티 주제(럭키박스, 행운뽑기 등)는 동시에 선택할 수 없습니다.
• 주제를 선택하면 해당 주제의 기본 지면이 모두 선택됩니다.

등록 예정 지면 컬럼에서 주제별로 세팅할 지면을 개별 선택할 수 있습니다.

• 각 주제 헤더를 클릭하면 해당 주제의 전체 선택/해제를 토글합니다.
• 지면 항목을 개별 클릭하면 체크/해제가 됩니다. 주제당 최소 1개는 선택되어야 합니다.

앱 목록 하단의 전체 세팅 시작 버튼을 클릭하면 목록에 있는 모든 앱을 순서대로 자동 세팅합니다.

• 진행 상황은 진행 상황 컬럼에서 실시간으로 확인할 수 있습니다.
• 세팅 중 멈추기 버튼을 클릭하면 현재 앱 완료 후 다음 앱 처리를 중단합니다.
• 개별 앱의 세팅 시작 버튼으로 특정 앱만 단독으로 실행할 수도 있습니다.

app_mapping.json은 애드팝콘 매체키와 아바티 App ID를 연결하는 테이블입니다. 이 파일이 없으면 세팅 자동화를 사용할 수 없습니다.

• 아바티 매핑 새로고침: 아바티 어드민을 순회하며 전체 앱 목록을 갱신합니다. 새 앱이 추가됐을 때 실행하세요. 수십 분 소요될 수 있습니다.
• 앱 수동 추가: 특정 앱만 빠르게 등록할 때 사용합니다. 매체키, 아바티 App ID, 앱 이름을 직접 입력합니다.
• 하나의 매체키에 아바티 앱이 여러 개인 경우 다중 매핑으로 등록할 수 있습니다.

• 진행 상황 컬럼의 로그를 확인하세요. 로그인 만료, 네트워크 오류, 이미 등록된 지면 등의 이유가 나타납니다.
• 브라우저 세션이 만료됐다면 백엔드를 재시작한 뒤 다시 시도하세요. 브라우저 창이 열리면 로그인해주세요.

• app_mapping.json에 해당 매체키가 없는 것입니다. 매핑 관리 탭에서 수동 추가하거나 새로고침을 실행하세요.

• 이는 의도된 동작입니다. 버즈빌 네트워크와 아바티 네트워크는 세팅 방식이 다르기 때문에 한 번에 하나의 그룹만 선택할 수 있습니다. 그룹을 바꾸면 기존 선택이 자동으로 초기화됩니다.