일반 SFTP 서버 사용

일반 피드 SFTP 서버를 사용하면 환경당 단일 SFTP 서버에 여러 피드 유형을 업로드할 수 있습니다. 이 가이드에서는 일반 SFTP 서버를 사용하는 방법을 설명하고 사용하려는 피드에 적합한 가이드 링크를 제공합니다.

일반 SFTP 서버는 다음과 같은 두 가지 별도의 업로드를 사용합니다.

1. 설명자 파일: 업로드할 피드 유형을 설명합니다.
2. 피드 파일: 실제 피드의 콘텐츠

설명자 필드 구조화

설명자 파일은 업로드하는 피드 유형을 Google 시스템에 알리기 위해 업로드됩니다. 이렇게 하면 피드를 올바르게 검증하고 처리할 수 있습니다. 설명자 파일은 피드 콘텐츠보다 먼저 업로드해야 하며 다음 이름 지정 요구사항을 따라야 합니다.

• 설명자 파일에는 .filesetdesc.json 파일 확장자를 사용해야 합니다.
• 각 설명자 파일 이름은 고유해야 하며 업로드 간에 재사용할 수 없습니다. 파일 이름에 생성 타임스탬프와 피드 이름을 포함하는 것이 좋습니다.
  • 예: offers_1524606581.filesetdesc.json
• 각 설명자 파일에는 관련 피드 이름의 최신 피드에 있는 모든 데이터 파일이 나열되어야 합니다.

message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

name 필드에 가능한 값은 다음과 같습니다.

샤드가 두 개인 혜택 피드의 JSON 설명자 파일 예는 아래에서 확인할 수 있습니다.

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

피드 콘텐츠 구조화

설명자 파일을 업로드한 후에는 설명자 파일에서 이름이 지정된 피드 구성 파일에 해당하는 피드 데이터 유형의 모든 피드 파일을 업로드합니다. 파일 이름과 경로 위치 (SFTP 서버 내 상대 경로)는 data_file 필드에 포함된 내용과 정확히 일치해야 합니다. 파일이 누락되거나 이름이 잘못되었거나 다른 위치에 업로드된 경우 전체 피드가 처리되지 않습니다.

이러한 피드 데이터 파일의 콘텐츠는 설명어 파일에 지정된 피드의 관련 사양을 준수해야 합니다.

각 피드 파일 파일 이름은 고유해야 하며 업로드 간에 재사용할 수 없습니다. 생성 타임스탬프와 샤드 번호 (증분 ID)를 파일 이름에 포함하는 것이 좋습니다.

• 예: offers_1524606581_1.json

피드 파일 크기 및 업로드 빈도

• 피드 파일 크기를 200MB 미만으로 유지합니다 (압축 후).
• 압축 해제된 각 데이터 파일 크기는 2GB 미만이어야 합니다.
• 대부분의 통합에서는 단일 샤드만 사용하면 됩니다. 샤드는 가능한 한 적게 사용해야 합니다. 피드당 최대 1,000개의 샤드가 있습니다.
• 하나의 샤드로 전송되는 개별 레코드는 이후 피드에서 동일한 샤드 번호로 전송하지 않아도 됩니다.
• 성능을 향상하려면 데이터를 샤드 간에 균등하게 분할하여 모든 샤드 파일의 크기를 비슷하게 만듭니다.
• 필요한 경우 gzip을 사용하여 피드를 압축합니다. 단, 개별 피드 샤드에 대해 이 작업을 실행합니다.

문제해결과 디버깅

파일 (설명자 및 피드 파일)을 업로드한 후 파트너 포털의 수집 뷰어(문서)로 이동하여 (수집 > 기록으로 이동) 피드 수집 진행 상황을 확인합니다.

'피드 이름' 열에서 설명자 파일에 입력한 name를 찾아 피드를 찾습니다.

피드가 수집되면 (상태가 Success 또는 Fail) 행을 클릭하여 오류 및 경고의 세부정보를 확인할 수 있습니다.