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

• 포스트별 독립 설정 (NEW!)
  • 글쓰기 우측 메타박스에서 모든 설정 가능
  • 키워드, 상품 개수, 배치 위치를 포스트별로 설정
  • 저장 후 변경되지 않아 일관성 유지
  • 사용자 정의 필드 자동 숨김
• 상품 노출 모드 선택 (NEW!)
  • 키워드 입력 시에만 노출: cptag가 있는 포스트만 상품 표시
  • 제목에서 유추하여 노출: 포스트 제목에서 자동 추출
  • 키워드 + 제목 병합: 키워드 우선, 없으면 제목에서 추출
  • 관리자 설정에서 전체 모드 변경 가능
• 개선된 캐싱 시스템 (NEW!)
  • 캐시 키에 키워드 + 상품 개수 포함
  • 정확한 캐시 관리로 설정 변경 즉시 반영
  • 1시간 캐시로 API 호출 최소화
• 스마트 배치 시스템
  • 본문 최하단 (기본값)
  • 마지막 H2 태그 직전
  • 포스트별로 선택 가능
• 디스클레이머 조건부 표시 (NEW!) - 플러그인 활성화 이후 발행 글에만 적용 가능, 기존 글 보호
• 반응형 디자인 - 데스크톱 3열 그리드, 모바일 가로 슬라이드
• API Rate Limiting - 분당 10회 제한으로 안정적 운영
• CSS 독립성 강화 (NEW!) - cai- 네임스페이스로 테마 충돌 방지
• 이미지 크기 고정 (NEW!) - 256x256으로 통일하여 빠른 로딩
• 상품 표시 안 함 (NEW!) - 이 포스트에서 쿠팡 상품 표시 안 함 기능 추가

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

• (1) 포스트 작성 시 설정
  • 우측 메타박스에서 키워드, 상품 개수, 배치 위치 설정
  • 설정값이 포스트 메타데이터로 저장
  • 저장 후 변경되지 않아 일관성 유지
• (2) 키워드 추출 (노출 모드에 따라 분기)
  • keyword_only: cptag 값만 사용, 없으면 상품 미노출
  • title_extract: 제목에서 첫 단어 추출, cptag 무시
  • keyword_and_title: cptag 우선, 없으면 제목에서 추출
• (3) 상품 검색
  • 포스트별 설정값 적용 (상품 개수, 이미지 크기)
  • 캐시 확인 (키워드 + 상품개수 조합)
  • 캐시 없으면 쿠팡 API 호출
  • HMAC-SHA256 인증 방식 사용
• (4) HTML 생성 및 삽입
  • 디스클레이머 표시 여부 판단 (활성화 이후 글만 또는 전체)
  • 조건 충족 시 디스클레이머를 컨텐츠 최상단에 추가
  • 상품 카드 HTML 생성 (cai- 네임스페이스)
  • 포스트별 배치 위치에 삽입
• (5) 렌더링
  • CSS/JS 파일 로드
  • 반응형 레이아웃 적용
  • 모바일 슬라이드 인터랙션 활성화

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

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

좌측 메뉴 > 쿠팡 상품 설정 페이지에서 다음 항목을 설정합니다:

[API 설정]

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

[상품 노출 설정] (NEW!)

• 상품 노출 모드: 키워드만 / 제목 유추 / 키워드+제목 중 선택
• 디스클레이머 적용 범위: 활성화 이후 글만 (권장) / 모든 포스트

[고급 설정]

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

포스트 편집 화면 우측 "쿠팡 상품 설정" 메타박스 활용

📝 메타박스 구성:

• 🔍 검색 키워드 (cptag)
  • 이 포스트에서 검색할 쿠팡 상품 키워드 입력
  • 예: "노트북", "커피", "화장품"
  • 비워두면 제목에서 자동 추출
• 📦 노출 상품 개수
  • 3~10개 사이로 설정 가능
  • 기본값: 3개
  • 비워두면 기본값 사용
• 📍 배치 위치
  • 본문 최하단 (기본값)
  • 마지막 H2 태그 직전
• 📷 이미지 크기
  • 256x256 고정 (변경 불가)
  • 빠른 로딩과 일관된 디자인 보장

💡 사용 예시:

쿠팡 상품을 표시하고 싶지 않을 때:

• 이 포스트에서 쿠팡 상품 표시 안 함 체크
• 체크 시 나머지 필드 자동 비활성화 (회색 처리)

개선된 캐시 시스템 (v2.0.0):

• 캐시 키에 키워드 + 상품 개수 포함
• "가방 3개"와 "가방 5개"는 별도 캐시
• 포스트 설정 변경 시 자동으로 다른 캐시 사용

캐시 삭제가 필요한 경우:

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

캐시 삭제 방법:

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

• 버전 - v2.0.0 (2026-02-13)
• 라이선스 - GPL v2 or later
• 사용 제한 - 재배포 금지 (상업적 사용 불가능)
• 지원 - 없음
• 업데이트 - 뉴스레터를 통한 업데이트 제공

A: "키워드 입력 시에만 노출"을 권장합니다. 포스트 편집 시 cptag 키워드를 직접 입력한 글에서만 상품이 표시되므로 가장 정확한 상품 매칭이 가능합니다.

"제목에서 유추하여 노출" 모드는 편의 기능이지만, 제목의 구성에 따라 관련 없는 상품이 노출될 수 있습니다. "키워드 + 제목 병합" 모드는 키워드가 있는 글은 정확하게, 없는 글은 제목에서 자동 추출하는 절충안입니다.

A: 이 모드는 제목의 단어를 분석하여 키워드를 자동 추출합니다. 1글자 단어, 동사/형용사 활용형, 일반 불용어(방법, 정리, 추천 등)는 자동으로 건너뛰지만, 모든 경우를 완벽하게 처리하기는 어렵습니다.

정확한 상품 매칭이 중요하다면 "키워드 입력 시에만 노출" 모드로 변경하시거나, 해당 포스트의 메타박스에서 cptag 키워드를 직접 입력하세요.

A: 좌측 메뉴 > 쿠팡 상품 설정에서 디스클레이머 적용 범위를 "플러그인 활성화 이후 발행된 글에만 적용"으로 선택하세요. 이것이 기본값이며, 플러그인 활성화 시점 이전에 발행된 기존 글에는 디스클레이머가 표시되지 않습니다.

A: 네, 안전합니다. 기본 설정이 "키워드 입력 시에만 노출" + "활성화 이후 글에만 디스클레이머 적용"이므로, 기존 100개 이상의 글이 있어도 cptag 키워드가 없는 기존 글에는 상품과 디스클레이머 모두 표시되지 않습니다. 플러그인 설치 후 새로 작성하는 글부터 메타박스에서 설정하면 됩니다.

A: v2.0.0부터 워드프레스 관리자 좌측에 "쿠팡 상품 설정" 독립 메뉴(장바구니 아이콘)로 분리되었습니다. 기존 "설정 > Coupang Auto Insert" 경로는 더 이상 사용되지 않습니다.

A: 전역 설정(좌측 메뉴 > 쿠팡 상품 설정)에서는 API 키, 상품 노출 모드, 디스클레이머 적용 범위, 캐시/Rate Limit을 관리합니다. 포스트별 설정(편집 화면 우측 메타박스)에서는 해당 포스트의 키워드, 상품 개수, 배치 위치를 개별적으로 설정합니다. 포스트별 설정은 저장 후 변경되지 않아 일관성이 유지됩니다.

A: 포스트 편집 화면 우측 "쿠팡 상품 설정" 메타박스 최상단의 "🚫 이 포스트에서 쿠팡 상품 표시 안 함" 체크박스를 선택하세요.

체크하면 나머지 설정 필드들이 자동으로 비활성화되며, 해당 포스트에서는 쿠팡 상품이 전혀 표시되지 않습니다.

A: 개별 포스트(single post) 페이지에서만 작동하며, 메인 페이지나 카테고리/아카이브 페이지에서는 표시되지 않습니다. 실제 상품 노출 여부는 선택한 노출 모드에 따라 다릅니다. "키워드 입력 시에만 노출" 모드에서는 cptag를 입력한 포스트에서만 상품이 표시됩니다.

A: 파일 교체 후 플러그인을 비활성화했다가 다시 활성화하세요. 활성화 시점이 자동으로 기록됩니다. 기존 포스트의 메타박스 설정(키워드, 상품 개수 등)은 그대로 유지되며, 새로 추가된 노출 모드와 디스클레이머 설정만 좌측 메뉴 > 쿠팡 상품 설정에서 확인하시면 됩니다.

A: 노출 모드를 변경한 후, 상품 정보 업데이트가 필요할 때, Rate Limit 초과로 오류가 발생했을 때 캐시를 삭제하세요. 좌측 메뉴 > 쿠팡 상품 설정 하단의 "캐시 삭제" 버튼을 클릭하면 됩니다.

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

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

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

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

A: 다음 사항을 순서대로 확인하세요:

• 좌측 메뉴 > 쿠팡 상품 설정에서 API 키가 올바르게 입력되었는지 확인
• 상품 노출 모드가 의도한 설정인지 확인 ("키워드만" 모드에서는 cptag 필수)
• 포스트 메타박스에서 "상품 표시 안 함"이 체크되어 있지 않은지 확인
• Rate Limit 초과 여부 확인 (관리자 페이지 상단 경고)
• 캐시 삭제 후 재시도
• WordPress 디버그 모드 활성화하여 에러 로그 확인