제품 피드 (Product Feed)

👍

프리미엄 기능

제품 피드는 프리미엄 기능입니다. 활성화 방법은 CSM에게 문의해 주세요. 현재 이 온보딩 프로세스는 추천 캠페인만 지원합니다. 피드 트리거 캠페인에는 제품 데이터 피드 온보딩을 참조하세요.

Appier의 마케팅 솔루션과 에이전트들이 제품 제목, 설명, 링크, 가격, 재고 여부 등을 공유하여 사용할 수 있도록 하나의 제품 피드를 생성하세요.

제품 피드는 제품 목록과 각 제품의 정보를 나열한 CSV 파일입니다. 피드를 온보딩하면 제품 데이터가 필요한 모든 곳에서 동일한 피드가 재사용되므로, 최초 한 번만 설정하면 됩니다.

제품 피드를 온보딩하려면 다음 섹션의 단계를 진행하세요:

• 제품 피드 파일 준비
• 제품 피드 추가
• 제품 피드 관리

---

제품 피드 파일 준비

제품 피드를 Appier에 전달하는 방법은 두 가지입니다: CSV 파일을 업로드하거나, 자체 서버에 파일을 호스팅한 후 Appier 콘솔에서 URL을 제공할 수 있습니다. URL 소스를 사용하려는 경우, 파일이 서버에 호스팅되어 있고 접근이 가능한지 확인하세요.

두 가지 방법 모두 아래의 형식 및 인코딩 요구사항을 준수해야 합니다.

• 파일 형식: CSV
• 파일 인코딩: BOM 없는 UTF-8. UTF-8 BOM 또는 다른 인코딩은 사용하지 마세요.
• 파일 크기:
  • 파일 업로드: 파일당 최대 100MB.
  • URL 소스: URL당 최대 275MB.

필드 사양

제품 피드 파일에 포함할 필드는 아래 표를 참조하세요. 다음 규칙은 모든 필드에 적용됩니다:

• 필드 이름
  • 필드 이름은 대소문자를 구분합니다.
  • 필드 이름에 알파벳이 아닌 문자를 사용해서는 안 됩니다.
  • 가능한 한 표에 나열된 필드 이름을 그대로 사용하세요. 제품 피드에 다른 필드 이름을 사용하고 있다면, 2단계: 필드 매핑에서 각 열을 Appier 시스템 필드와 매칭할 수 있습니다.
  • 필드 매핑을 완료한 후에는 열 이름을 변경하지 않고 그대로 유지해야 합니다. Appier는 향후 동기화를 위해 매핑 정보를 저장하고 재사용합니다. 매핑된 열의 이름을 변경하면 동기화가 실패하거나 해당 필드가 매핑되지 않을 수 있습니다.
• 필수 입력 필드
  • 모든 필수 열을 제품 피드에 반드시 추가해야 합니다.
  • 모든 제품은 각 필수 필드에 비어 있지 않은 값(데이터)을 가지고 있어야 합니다.
• 쉼표와 큰따옴표 이스케이프 처리

  • 쉼표(,)나 큰따옴표(")가 포함된 필드는 필드 전체를 큰따옴표로 감싸야 합니다. 예: Extra Virgin Olive Oil,ID002173,"Organic and natural, cold-pressed, 500ml".

  • 큰따옴표로 감싼 필드 내부에서 또 큰따옴표를 표현하려면, 큰따옴표를 연속으로 두 번("") 사용하여 이스케이프 처리해야 합니다. 예: Extra Virgin Olive Oil,ID002173,"Organic and natural, ""cold-pressed"", 500ml".

    

👍

샘플 파일

참고용 예시가 필요한 경우, 샘플 데이터 피드 파일을 확인하세요.

제품 피드 파일 호스팅(URL 소스만 해당)

URL 소스를 사용하는 경우, Appier가 설정된 주기에 따라 파일을 가져올 수 있도록 자체 서버에 제품 피드 파일을 호스팅해야 합니다.

• 직접 연결되는 HTTP 또는 HTTPS URL을 제공해야 합니다.
• 서버에서 인증이 필요한 경우, URL에 사용자 이름(ID)과 비밀번호를 삽입할 수 있습니다. 예: https://username:[email protected]/<DATA_FEED_FILE_NAME>.csv.
• 허용 목록(Allowlist)을 통해 제품 피드 파일의 접근 권한을 관리하는 경우, Appier가 파일에 접근할 수 있도록 다음 IP 주소들을 허용해 주세요:
  • 61.216.8.104
  • 61.216.8.103
  • 13.229.23.41
  • 3.0.119.155
  • 35.185.163.29
  • 35.189.177.52
  • 34.84.107.180/32
  • 34.84.45.228/32
  • 34.146.255.182/32
  • 34.146.231.181/32
  • 34.84.32.103/32
  • 34.85.109.182/32
  • 35.187.213.241/32
  • 34.84.94.6/32
  • 111.235.224.78/32
  • 111.235.224.79/32
  • 111.235.224.80/32

⚠️

URL에 포함된 인증 정보

URL에 인증 정보를 포함하는 방법은 허용되지만 권장하지 않습니다. 데이터 접근 권한 관리는 사용자의 책임이며, 피드 접근에 필요한 수준을 초과하는 민감한 정보는 포함되지 않아야 합니다.

---

제품 피드 추가

공통 설정 > 제품 피드로 이동하여 다음 단계를 완료하세요:

1. 데이터 소스 선택
2. 필드 매핑
3. 검토 및 런칭

1단계: 데이터 소스 선택

제품 피드 이름을 입력한 후, 제품 피드를 제공할 방식을 선택하세요.

URL 소스 제공

URL 소스 필드에 직접 연결되는 HTTP 또는 HTTPS URL을 입력하세요. 최대 파일 크기는 275MB입니다.

• 동기화 빈도: Appier가 피드를 가져오는 빈도를 선택합니다.
  • 일별: 동기화 간격(일)을 입력합니다.
  • 시간별: 동기화 간격(시간)을 입력합니다. 최소 업데이트 주기는 6시간입니다.
  • 동기화 시작 시간 설정 체크박스를 선택하면 하루 중 동기화가 시작될 시간을 지정할 수 있습니다.
• 인증 요구 사항: 보안이 적용된 피드에 접근하는 방법이 필요한 경우 이 섹션을 확장하여 확인하세요.
  • 제품 피드에 인증이 필요한 경우, URL에 인증 정보(ID 및 비밀번호)를 삽입하세요.
  • 서버의 허용 목록(Allowlist)에 Appier의 모든 IP 주소가 포함되어 있는지 확인해 주세요.

파일 업로드

CSV 파일을 업로드 영역으로 드래그하거나 클릭하여 파일을 선택하세요. 최대 CSV 파일 크기는 100MB입니다.

2단계: 필드 매핑

각 시스템 필드마다 드롭다운에서 제품 피드 파일에서 일치하는 열을 선택하세요. 필수 시스템 필드를 매핑을 해야만 다음 단계로 진행할 수 있습니다. 선택 사항 필드는 매핑하지 않고 비워둘 수 있습니다.

3단계: 검토 및 런칭

Appier는 제품 피드의 상위 700개 행을 검증하고 그 결과를 표시하기 때문에 피드를 시작하기 전에 최종적으로 검토할 수 있습니다.

• 요약: 유효한 항목 수와 확인이 필요한 행의 수를 보여줍니다. 행에 데이터 문제가 있는 경우, Appier가 이를 표시하여 소스 파일을 수정할 수 있도록 안내합니다.
• 행 수준 오류: 가격 필드에 숫자 대신 텍스트가 포함되어 있습니다 또는 필수 필드가 비어 있습니다와 같이 감지된 문제들의 행, 필드, 값, 문제 유형을 나열합니다. 리포트 다운로드를 클릭하면 모든 문제 목록을 다운로드할 수 있습니다.

Appier가 제품 피드에 문제가 있는 행을 표시하더라도 그대로 피드를 런칭할 수 있지만, 가능하면 소스 파일을 수정하고 검증을 다시 실행하는 것이 좋습니다. 문제는 다음 두 가지 방법으로 해결할 수 있습니다:

• 소스 파일 또는 URL에 연결된 파일을 수정하고 검증을 다시 실행합니다.
• 피드를 있는 그대로 먼저 시작한 후, 나중에 소스 업데이트를 통해 문제를 수정합니다.

모든 준비가 완료되면 저장을 클릭하여 피드를 시작하세요.

---

제품 피드 관리

피드를 시작한 후, 전체 데이터가 처리되어 실제로 사용할 수 있을 때까지 어느 정도 시간이 소요될 수 있습니다. 필요에 따라 피드 상태를 모니터링하고, 제품을 조회하거나, 데이터 소스를 업데이트하세요.

개요

개요 섹션에서는 피드의 현재 상태를 확인할 수 있습니다:

제품 둘러보기

제품 목록에서 피드에 있는 모든 제품을 확인할 수 있습니다. 다음과 같은 방식으로 활용이 가능합니다:

• 제품 이름 또는 제품 ID로 검색할 수 있습니다.
• 이미지, 제품 제목, 제품 ID, 판매 가능 여부, URL, 설명 등 여러 열에 걸쳐 제품의 상세 정보를 확인할 수 있습니다.
• 목록 하단의 페이지 번호(페이지네이션)를 이용해 전체 제품을 이동하며 볼 수 있습니다.

소스 업데이트

데이터 소스를 변경하거나, 동기화 실패 오류를 해결하거나, 필드 매핑을 업데이트하려면 소스 업데이트를 클릭하여 피드 설정 단계를 다시 시작하세요. 변경 사항이 반영될 수 있도록 추가 업데이트를 하기 전에 몇 분 정도 기다려 주세요.

• 데이터 소스를 변경하면 필드 매핑이 처음부터 다시 시작되며, Appier가 새 소스의 상위 700개 행을 검증합니다.
• 새 피드가 검증을 통과할 때까지 현재 운영 중인 피드가 중단 없이 계속 실행됩니다. 이 과정 중에도 진행 중인 캠페인이나 기타 기능은 정상적으로 작동합니다.

📘

동기화에 실패한 경우

예약된 동기화가 실패하더라도, 가장 최근에 성공한 피드 데이터를 기반으로 추천 캠페인이 중단 없이 계속 운영됩니다. 다만, 반복적인 실패를 방지하기 위해 자동 동기화는 일시 중지됩니다. 이 문제가 발생하면 담당 CSM에게 문의하여 원인을 파악하고 동기화를 재개하세요.

---

FAQ

• 제품 피드에 어떤 제품 데이터를 포함해야 하나요?
• 제품 데이터는 얼마나 자주 업데이트해야 하나요?

제품 피드에 어떤 제품 데이터를 포함해야 하나요?

먼저 필수 필드를 모두 채우는 것부터 시작하세요. 필수 필드는 Appier가 제품을 식별하고, 화면에 표시하며, 가격을 책정하는 데 필요한 최소한의 데이터입니다. 이후 피드를 활용하려는 목적에 맞춰 다음과 같은 선택 필드를 추가해 보세요:

• 더 정교한 추천, 동적 콘텐츠 또는 캠페인 개인화를 원하신다면 풍부한 description 값과 명확하고 완전한 category 값을 포함하세요.
• 시각적 유사도 기반의 추천을 원하신다면 모든 제품에 image를 포함해야 합니다.
• "베스트셀러" 태그, 시즌별 분류, 내부 SKU 등 표준 필드에 없는 제품 속성이 있다면 custom_label_0부터 custom_label_4까지의 커스텀 라벨에 매핑하여 활용하세요.

제품 데이터는 얼마나 자주 업데이트해야 하나요?

제품 정보가 얼마나 자주 변경되느냐에 따라 다릅니다. 대부분의 제품 카탈로그는 하루에 한 번 업데이트하는 것으로도 충분합니다. 하지만 반짝 세일(타임세일)을 진행하거나, 한정된 재고를 관리하거나, 가격 변동이 잦은 등 하루 동안에도 카탈로그가 자주 바뀐다면 더 자주 업데이트해 주는 것이 좋습니다.

최소 동기화 주기는 6시간이므로 실시간 업데이트는 지원되지 않습니다. 비즈니스 특성상 이보다 더 잦은 업데이트가 필요하시다면 담당 CSM에게 문의하여 대안을 논의해 보세요.

동기화 빈도 또는 데이터 소스를 변경하려면 제품 피드 페이지에서 소스 업데이트를 클릭하세요.

• URL 소스를 사용하는 경우 동기화 빈도 설정을 조정합니다.
• 파일 업로드를 사용하는 경우, 피드를 새로 고치려면 새 파일을 직접 업로드합니다.