汎用フィード ドロップボックスの使用

汎用フィードのドロップボックスを使用すると、複数のフィードタイプを 1 つのドロップボックスしかありませんこのガイドでは、Terraform を使用して 汎用ドロップボックスと、それぞれに適したガイドへのリンクを提供 選択します。

<ph type="x-smartling-placeholder">で確認できます。 ( ドキュメントの「フィードのエクスポート(エンドツーエンド)」または「フィード(開始条件)」のセクションを参照)。

<ph type="x-smartling-placeholder">で確認できます。 <ph type="x-smartling-placeholder">

汎用ドロップボックスでは、2 つの個別のアップロードが必要です。

  1. 記述子ファイル: 使用するフィードタイプを記述します。 アップロード中
  2. フィード ファイル: 実際のフィードの内容
で確認できます。 <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 フィールドの有効な値は次のとおりです。

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 を使用してフィードを圧縮します。ただし、 個別フィードシャードがあります

トラブルシューティングとデバッグ

ファイル(記述子とフィード ファイル)をアップロードしたら、 [Feed History] ダッシュボードドキュメント)。 ([履歴] > [フィード] に移動)して、フィードの取り込みの進行状況を確認できます。

記述子ファイルの [フィード名] に入力した name を探します。フィードを探すことができます。

フィードが取り込まれたら(ステータスが Success または Fail の場合)、 その行でエラーと警告の詳細を確認できます。