汎用フィード ドロップボックスを使用すると、環境ごとに 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
フィールドで使用できる値は次のとおりです。
2 つのシャードを含む商品フィードの JSON 記述子ファイルの例を次に示します。
{ "generation_timestamp": 1524606581, "name": "promote.offer", "data_file": [ "offers_1524606581_1.json", "offers_1524606581_2.json" ] }
フィード コンテンツの構造
記述子ファイルをアップロードしたら、記述子ファイルで指定された名前のデータフィード構成ファイルに対応するデータフィード タイプに応じて、すべてのデータフィード ファイルをアップロードします。ファイル名とパスの場所(ドロップボックス内の相対パス)は、data_file
フィールドに含まれているものと完全に一致している必要があります。ファイルが不足している、名前が正しくない、別の場所にアップロードされている場合、フィード全体は処理されません。
これらのフィードデータ ファイルの内容は、記述子ファイルで指定されたフィードの関連する仕様に準拠している必要があります。
各フィード ファイルのファイル名は一意である必要があり、アップロード間で再利用することはできません。ファイル名には、生成タイムスタンプとシャード番号(増分 ID)を含めることをおすすめします。
- 例: offers_1524606581_1.json
フィード ファイルのサイズとアップロード頻度
- フィード ファイルのサイズは(圧縮後)200 MB 未満に抑えます。
- 解凍した各データファイルのサイズは 2 GB 未満にする必要があります。
- ほとんどの統合では、単一シャードを使用するだけで済みます。シャードの使用は最小限に抑える必要があります。1 つのフィードにつきシャードの最大数は 1,000 です。
- 1 つのシャードで送信された個々のレコードを、今後のフィードの同じシャード番号で送信する必要はありません。
- パフォーマンスを向上させるには、シャード間でデータを均等に分割し、すべてのシャード ファイルを同じくらいのサイズにします。
- 必要に応じて、gzip を使用してフィードを圧縮します。ただし、その場合には個々のフィード シャードごとに行ってください。
トラブルシューティングとデバッグ
ファイル(記述子ファイルとフィード ファイル)をアップロードしたら、パートナー ポータルのフィード履歴ダッシュボード(ドキュメント)に移動し([履歴 > フィード] に移動)、フィードの取り込みの進捗状況を確認します。
記述子ファイルに入力した name
を [フィード名] 列で探して、フィードを見つけます。
フィードが取り込まれたら(ステータスが Success
または Fail
)、その行をクリックしてエラーと警告の詳細を確認できます。