汎用フィードのドロップボックスでは、環境ごとに複数のフィードタイプを 1 つのドロップボックスにアップロードできます。このガイドでは、汎用ドロップボックスの使用方法について説明し、使用する予定の各フィードの適切なガイドへのリンクを紹介します。
(ドキュメントのフィードのエクスポート(エンドツーエンド)またはフィード(開始条件)のセクションをご覧ください)。汎用ドロップボックスは、2 つの個別のアップロードがあることに依存しています。
- 記述子ファイル: アップロードするフィードタイプを記述します。
- フィード ファイル: 実際のフィードのコンテンツ
記述子フィールドの構造化
記述子ファイルは、アップロードするフィードタイプを Google のシステムに知らせるためにアップロードされます。これにより、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 未満に抑えます。
- ほとんどの場合、統合で使用するシャードは 1 つだけです。シャードはできるだけ少なくしてください。シャードの最大数はフィードあたり 1,000 個です。
- 1 つのシャードで送信された個々のレコードを、今後のフィードで同じシャード番号で送信する必要はありません。
- パフォーマンスを向上させるには、シャード間でデータを均等に分割し、すべてのシャード ファイルの同じサイズにします。
- 必要に応じて、gzip を使用してフィードを圧縮します。ただし、この操作はフィードのシャードごとに行ってください。
トラブルシューティングとデバッグ
ファイル(記述子とフィード ファイル)をアップロードしたら、パートナー ポータルのフィード履歴ダッシュボード(ドキュメント)([履歴] > [フィード] に移動)でフィードの取り込み状況を確認できます。
対象のフィードは、記述子ファイルに「フィード名」列に入力されている name
で探します。
フィードが取り込まれると(ステータスが Success
または Fail
)、その行をクリックしてエラーと警告の詳細を確認できます。