일반 피드 보관용 계정 사용

일반 피드 보관용 계정을 사용하면 여러 피드 유형을 하나의 하나의 보관용 계정을 만들 수 있습니다 이 가이드에서는 일반 보관용 계정을 사용하는 방법을 안내하고 사용할 각 피드에 적합한 가이드 링크를 제공합니다.

를 통해 개인정보처리방침을 정의할 수 있습니다. ( 문서의 피드 내보내기 (엔드 투 엔드) 또는 피드 (시작 조건) 섹션 참조).

를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">

일반 보관용 계정은 다음과 같이 두 개의 별도 업로드가 있어야 합니다.

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

설명 필드 구성

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

  • 설명자 파일에 .filesetdesc.json 파일 확장자를 사용해야 합니다.
  • 각 설명자 파일 이름은 고유해야 하며 업로드 간에 재사용할 수 없습니다. 파일 이름에 생성 타임스탬프와 피드 이름을 포함하는 것이 좋습니다.
    • 예: offer_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"
  ]
}

피드 콘텐츠 구성

설명자 파일을 업로드한 후에는 설명자 파일의 이름을 지정한 피드 구성 파일에 해당하는 피드 데이터 유형의 모든 피드 파일을 업로드합니다. 파일 이름 및 경로 위치( 보관용 계정)가 data_file 필드 파일이 누락되거나 이름이 잘못 지정되거나 다른 위치에 업로드된 경우 전체 피드가 처리되지 않습니다.

이 피드 데이터 파일의 콘텐츠는 설명자 파일에 지정된 피드

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

  • 예: offers_1524606581_1.json

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

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

문제해결과 디버깅

파일(디스크립터 및 피드 파일)을 업로드한 후 파트너 포털의 피드 기록 대시보드(문서)로 이동하여(기록 > 피드로 이동) 피드 처리 진행 상황을 확인합니다.

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

피드가 처리 (상태: Success 또는 Fail)되면 해당 행을 클릭하여 오류와 경고의 세부정보를 확인합니다.