資料分割動態饋給檔案

視廣告空間而定,資料分割 (或將動態饋給拆分為多個項目) 檔案)。

使用資料分割的時機

  • 1 個檔案的動態饋給大小超過 200 MB (gzip 壓縮後)。

    • 示例:產生的供應情形動態饋給為 1 GB。這應該是 已分割至超過 5 個不同的檔案 (或資料分割)。
  • 合作夥伴廣告空間分佈於各個系統和/或區域 導致無法協調廣告空間

    • 範例:合作夥伴有美國和歐盟廣告空間,並分別在不同的平台中販售 有些人會將 Cloud Storage 視為檔案系統 但實際上不是動態饋給可以產生 2 個檔案 (或多個資料分割)、1 代表美國、 1 則代表使用相同 nonce 和 1 的歐盟 generation_timestamp
,瞭解如何調查及移除這項存取權。

通則

  • 每個資料分割不得超過 200 MB,適用於 1 個檔案 (gzip 壓縮後)。
  • 每個動態饋給的建議資料分割不超過 20 個。如果提供的理由 需要超過這個金額,請與支援團隊聯絡,以取得進一步指示。
  • 個別記錄 (例如一個 Merchant 物件) 必須透過單一資料分割傳送 無法跨越多個資料分割但不一定要在資料分割中傳送 相同的 shard_number 用於日後的動態饋給。
  • 為提高成效,請將資料平均分配至 讓所有資料分割檔案的大小都差不多。
,瞭解如何調查及移除這項存取權。

如何分割動態饋給

針對每個檔案 (或資料分割),將 FeedMetadata 設為 包括:

  • processing_instruction已設為 PROCESS_AS_COMPLETE
  • shard_number 已設為動態饋給目前的資料分割 (從 0 開始,total_shards - 1 之間沒有中斷)
  • total_shards 已設為專案的資料分割總數 動態饋給 (從 1 開始)。
  • nonce 已設為使用相同的專屬 ID 設定為「同一個」動態饋給的所有資料分割,但與 其他動態饋給的資訊nonce 必須是正整數 (uint64)。
  • generation_timestamp 是 Unix 和 EPOCH 中的時間戳記 格式。動態饋給的所有資料分割應相同

建議:針對每個檔案 (或資料分割),設定檔案名稱來表示 動態饋給類型、時間戳記、資料分割編號和 資料分割。資料分割大小大致應相同,且全部處理完畢後就會進行處理 資料分割會上傳。

  • Example: “availability_feed_1574117613_001_of_002.json.gz”

資料分割供應情形動態饋給範例

資料分割 0

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 3,
    "nonce": 111111,
    "generation_timestamp": 1524606581
  },
  "service_availability": [
    {
      "availability": [
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1577275200,
          "merchant_id": "merchant1",
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}

資料分割 1

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 1,
    "total_shards": 3,
    "nonce": 111111,
    "generation_timestamp": 1524606581
  },
  "service_availability": [
    {
      "availability": [
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1577620800,
          "merchant_id": "merchant2",
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}

資料分割 2

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 2,
    "total_shards": 3,
    "nonce": 111111,
    "generation_timestamp": 1524606581
  },
  "service_availability": [
    {
      "availability": [
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1576670400,
          "merchant_id": "merchant3",
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}

針對合作夥伴分散式商品目錄資料使用資料分割

合作夥伴想整合分散式廣告空間並不容易 合併多個系統和/或區域的動態饋給資料分割可以是 用來解決對帳問題,將每個資料分割設定為 以及分散式系統的廣告空間組合

舉例來說,假設合作夥伴的廣告空間分為 2 個區域 (美國和歐盟) 廣告空間)。

合作夥伴可以將每個動態饋給分為 2 個檔案 (或資料分割):

  • 商家動態饋給:1 個資料代表美國,1 個資料分割為歐盟
  • 服務動態饋給:1 個資料分割為美國,1 個資料分割為歐盟
  • 供應情形動態饋給:1 個資料代表美國,1 個資料分割為歐盟

如要確保系統能正確處理動態饋給,請按照下列步驟操作:

  1. 決定上傳時間表,並將各個廣告空間例項設為 按照時間表進行
  2. 為每個執行個體指派不重複的資料分割編號,例如 US = N、EU = N + 1。 將 total_shards 設為資料分割總數。
  3. 在每個排定的上傳時間 《generation_timestamp》和《nonce》。在 FeedMetadata,將所有例項設為 這兩個欄位
    • generation_timestamp」必須是目前日期或近期的日期 (最好使用合作夥伴的讀取資料庫時間戳記)
  4. 上傳所有資料分割後,Google 會透過 《generation_timestamp》和《nonce》。
,瞭解如何調查及移除這項存取權。

Google 會將動態饋給視為一項處理,即使每個資料分割都代表 合作夥伴的廣告空間不同區域,並可透過 不同的時段 (只要generation_timestamp 所有資料分割都相同。

各區域的資料分割供應情形動態饋給範例

資料分割 0 - 美國商品目錄

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 2,
    "nonce": 111111,
    "generation_timestamp": 1524606581
  },
  "service_availability": [
    {
      "availability": [
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1577275200,
          "merchant_id": "US_merchant_1",
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}

資料分割 1 - 歐盟商品目錄

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 1,
    "total_shards": 2,
    "nonce": 111111,
    "generation_timestamp": 1524606581
  },
  "service_availability": [
    {
      "availability": [
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1577620800,
          "merchant_id": "EU_merchant_1",
          "confirmation_mode": "CONFIRMATION_MODE_SYNCHRONOUS"
        }
      ]
    }
  ]
}