WordPress 블로그 운영자가 쿠팡 파트너스 수익을 자동화할 수 있도록 돕는 플러그인입니다. 포스트 작성 시 글 주제에 맞는 쿠팡 상품을 자동으로 검색하여 본문에 삽입하며, 반응형 디자인으로 모바일과 데스크톱 모두에서 최적화된 광고 효과를 제공합니다.

• 키워드 자동 추출 (3단계)
  • 1차: 커스텀 필드 'cptag' 값 사용
  • 2차: H1 제목에서 첫 번째 단어 추출
  • 3차: "추천" 키워드로 랜덤 상품 표시
• 스마트 배치 시스템 - 마지막 H2 태그 직전 또는 본문 최하단 자동 배치
• 반응형 디자인 - 데스크톱 3열 그리드, 모바일 가로 슬라이드
• API Rate Limiting - 분당 10회 제한으로 안정적 운영
• 캐싱 시스템 - 1시간 캐시로 API 호출 최소화
• 관리자 설정 페이지 - API 키, 상품 개수, 이미지 크기 등 설정
• 디스클레이머 자동 생성 - 쿠팡 파트너스 정책 준수

전체 프로세스는 4단계로 구성됩니다:

• (1) 키워드 추출
  • 포스트 로드 시 자동으로 키워드 추출
  • 커스텀 필드 → H1 제목 → 기본 키워드 순서로 시도
• (2) 상품 검색
  • 쿠팡 파트너스 API로 상품 검색
  • HMAC-SHA256 인증 방식 사용
  • 캐시 확인 후 API 호출
• (3) HTML 생성 및 삽입
  • 상품 카드 HTML 자동 생성
  • 본문 내 지정 위치에 삽입
  • 디스클레이머 자동 추가
• (4) 렌더링
  • CSS/JS 파일 로드
  • 반응형 레이아웃 적용
  • 모바일 슬라이드 인터랙션 활성화

1. 워드프레스 관리자 로그인
2. 좌측 메뉴: 플러그인 > 플러그인 추가 > 플러그인 업로드
3. 다운로드한 ZIP 파일 업로드
4. "활성화" 버튼 클릭

1. 쿠팡 파트너스 사이트 접속 (https://partners.coupang.com)
2. 상단 메뉴: 추가기능 → 파트너스 API
3. Access Key, Secret Key, Affiliate ID 발급
4. 워드프레스 관리자: 설정 > Coupang Auto Insert
5. 발급받은 API 정보 입력 후 저장

설정 > Coupang Auto Insert 페이지에서 다음 항목을 설정합니다:

[API 설정]

• Access Key: 쿠팡 API Access Key
• Secret Key: 쿠팡 API Secret Key
• Affiliate ID: 파트너스 ID (예: AF1234567)
• Sub ID: 채널 아이디 (선택사항)

[상품 설정]

• 노출 상품 개수: 1~10개 (기본 3개)
• 이미지 크기: 256x256 / 512x512 / 1024x1024
• 배치 위치: 마지막 H2 직전 / 본문 최하단
• 제외할 카테고리: 상품을 표시하지 않을 카테고리 선택

[고급 설정]

• 캐시 유지 시간: 300~86400초 (기본 3600초)
• API 호출 제한: 1~50회/분 (권장 10회)

방법 1: 커스텀 필드 사용 (권장)

1. 포스트 작성 화면에서 우측 상단 ⋮ (점 3개) 클릭
2. 환경설정 > 커스텀 필드 활성화
3. 하단 커스텀 필드 섹션에서 "새로운 필드 추가"
4. 이름: cptag, 값: 검색 키워드 (예: 커피, 노트북)
5. 포스트 발행

방법 2: 제목 활용

1. 포스트 제목을 "키워드-부제목" 형식으로 작성
2. 예: "커피-맛있는 원두 추천 TOP 5"
3. 플러그인이 자동으로 "커피"를 키워드로 인식

방법 3: 기본 키워드

• 커스텀 필드와 제목 모두 없으면 "추천" 키워드 사용
• 랜덤 추천 상품 표시

캐시 삭제가 필요한 경우:

• 설정 변경 후 즉시 반영이 필요할 때
• 상품 정보 업데이트가 필요할 때
• Rate Limit 초과로 오류 발생 시

캐시 삭제 방법:

1. 설정 > Coupang Auto Insert
2. 하단 "캐시 관리" 섹션
3. "캐시 삭제" 버튼 클릭

• 라이선스 - GPL v2 or later
• 사용 제한 - 재배포 금지 (상업적 사용 불가능)
• 지원 - 없음 (README.txt 개발 문서 제공)
• 업데이트 - 뉴스레터를 통한 업데이트 제공

A: 아니요. 쿠팡 파트너스 최종 승인 후 API 키를 발급받아야 사용 가능합니다.

A: 네, 무료 배포 중입니다. 하지만 기술 지원은 제공되지 않으며, README.txt 개발 문서를 참고하여 직접 문제를 해결해야 합니다.

A: 네, 개별 포스트(single post)에서만 자동으로 삽입됩니다. 메인 페이지나 카테고리 페이지에서는 표시되지 않습니다. 특정 카테고리를 제외하려면 관리자 설정에서 설정할 수 있습니다.

A: 캐시된 데이터를 우선적으로 사용하며, 관리자 페이지에 경고 알림이 표시됩니다. 1분 후 자동으로 복구됩니다.

A: 네, 소스 코드를 직접 수정할 수 있습니다. CSS 파일(coupang-products.css)과 PHP 파일을 수정하여 디자인과 기능을 변경할 수 있습니다. 단, 수정 후 재배포는 금지됩니다.

A: 다음 사항을 확인하세요:

• API 키가 올바르게 입력되었는지 확인
• Rate Limit 초과 여부 확인 (관리자 페이지)
• 캐시 삭제 후 재시도
• WordPress 디버그 모드 활성화하여 에러 로그 확인