일반 피드 보관용 계정 사용

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

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

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

설명자 필드 구조화

설명자 파일은 Google 시스템에 사용자가 제공한 피드 유형을 알리기 위해 있습니다. 이렇게 하면 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)가 포함되어 있습니다.

• 예: offer_1524606581_1.json

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

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

문제해결과 디버깅

파일 (설명어 및 피드 파일)을 업로드한 후에는 피드 기록 대시보드 (문서) 파트너 포털 (기록 > 피드로 이동)에서 피드 처리 진행 상황을 확인할 수 있습니다.

'피드 이름'의 설명자 파일에서 입력한 name를 찾습니다. 열을 사용하여 피드를 찾습니다.

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