일반 피드 보관용 계정을 사용하면 여러 피드 유형을 하나의 하나의 보관용 계정을 만들 수 있습니다 이 가이드에서는 일반 보관용 계정을 사용하는 방법을 안내하고 사용할 각 피드에 적합한 가이드 링크를 제공합니다.
를 통해 개인정보처리방침을 정의할 수 있습니다. ( 문서의 피드 내보내기 (엔드 투 엔드) 또는 피드 (시작 조건) 섹션 참조). 를 통해 개인정보처리방침을 정의할 수 있습니다. <ph type="x-smartling-placeholder">일반 보관용 계정은 다음과 같이 두 개의 별도 업로드가 있어야 합니다.
- 설명자 파일: 사용할 피드 유형을 설명합니다. 업로드 중
- 피드 파일: 실제 피드의 콘텐츠
설명 필드 구성
설명 파일은 업로드하는 피드 유형을 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
)되면
해당 행을 클릭하여 오류와 경고의 세부정보를 확인합니다.