設定檔動態消息

個人資料動態饋給的語意

如動態饋給類別定義所述，快照動態饋給的語意如下：

  • 如果快照動態饋給中的提供者不屬於 LSA 提供者資料庫，則系統會建立新的設定檔。
  • 如果快照動態饋給中的提供者是 LSA 提供者資料庫中的提供者，系統會更新設定檔資訊。
  • 如果快照服務未包含於快照動態饋給中的任何提供者，系統就會刪除該設定檔。

漸進式動態饋給的語意會產生下列動作：

  • 針對漸進式動態饋給中的供應商，如果 LSA 供應商資料庫中沒有供應商，則免人工管理。
  • 針對漸進式動態饋給中的供應商，如果 LSA 提供者資料庫內已有該提供者，系統就會更新設定檔資訊。
  • 對於不屬於漸進式動態饋給的供應商，此為免人工管理。

處理設定檔時發生錯誤

如果個別商家檔案動態饋給項目無效，系統就不會在 LSA 資料庫中更新該動態饋給項目，同時會暫停此項目以避免提供過時的資料。

如果商家檔案動態饋給無效 (例如不符合結構定義)，我們會停止處理整個動態饋給。我們將分享一份報表，其中包含動態饋給處理結果摘要 (例如錯誤、每個項目的處理狀態等)。

通訊協定和限制

  1. 限制條件。動態饋給中的每個商家 (動態饋給項目) 都必須有專屬 ID。

  2. 相關限制。LSA 會對個別資料欄位設下大小限制，如下表所示。

  3. 商家名稱限制

    1. 長度上限：100 個字元 (含空格)
    2. 至少需要一個數字或字母
    3. 支援的字母編碼為 UTF-8、UTF-16 和 UTF-32 (建議 UTF-8)
    4. 可使用特殊字元：
      1. 連字號 -，連接號 &，句號 .，逗號 ,，單引號 '，括號 ( )
    5. 不允許全大寫字母
    6. 禁止令人反感的字詞
    7. 禁止表情符號

設定檔欄位

以下說明特定供應商的設定欄位。選填欄位會標示為這類。

欄位名稱 說明 欄位類型 範例 需要 限制條件
serviceProviderId 商家資訊的專屬 ID (服務供應商) 數字 12345 是 這是每個服務供應商的專屬 ID。這會轉換為 int64。更新供應商時保持 ID 相同
serviceProviderName 公司名稱 string &quot King David Garage Doors, Inc.。 是 長度上限為 100 個半形字元。必須遵守名稱限制政策。
serviceProviderWebsite 商家網站網址 string https://abc.xyz 否 開頭須為 http 或 https
地址 公司地址 object "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" 是 addressLine1 必須填入街道地址 (如果有的話)。完成初始商家設定後，就無法變更國家/地區代碼。
BaselineProfileUrl 連結至合作夥伴網站個人資料頁面的個人資料網址。 string http://aggregator.com/joes-plumbing/ 否 開頭須為 http 或 https
年初商家 創立年分 整數 2015 否 YYYY 年格式
營業時間 商家的營業時間 物件陣列 請參閱「商家檔案動態饋給範例」。 是 查看限制的物件定義
公司電話號碼 採用 e164 格式的個別商家電話號碼 (可以是商家電話號碼或由商家擁有)，而不是客服中心號碼或合作夥伴分配的追蹤號碼。 string 「+16501112222」 是 電話號碼必須採用 E.164 格式
contact 用於各種聯絡方式的聯絡資訊 物件陣列 "{ “type”: “PHONE”, “address”: “+16501112222” }" 是 類型包括「PHONE」或「MESSAGE」。如果是「PHONE」，類型地址必須包含 E.164 格式的電話號碼。不得為「MESSAGE」地址填入資料。電話類型為 PHONE 的元素為必要，但為 MESSAGE 類型元素為選用元素。
指定目標語言 指定要放送廣告的語言清單。語言會以 ISO 639-1 語言代碼 (小寫，2 個字母) 定義。 字串陣列 「en」、「fr」 是 如未提供，則預設為「en」。
涵蓋地理 商家提供的地理區域。 object 否
geoCovered ->criteriaIds 與所放送廣告區域 (區域、郡、城市、郵遞區號) 對應的條件 ID 清單。 整數陣列 否 Google Ads 指定地理區域清單中的地理區域條件 ID 必須有效。
categories 商家提供的類別清單。 物件陣列 請參閱「商家檔案動態饋給範例」。 是 從 Google 提供的類別清單中選取所需項目。此類別只能包含一個類別。
類別 - 工作 指定類別的工作清單。 物件陣列 是 從 Google 提供的工作清單中選擇
工作 ->地理區域 由工作提供的地理區域 object 是
工作 ->geoCovered->postalCodeCriteriaIds 與放送廣告的郵遞區號對應的條件 ID。 字串陣列 已提供郵遞區號清單的地理區域條件 ID，條件 ID 必須在 Google Ads 地理區域目標清單中有效，且目標類型為 PostalCode
工作 ->geoCovered->cityCriteriaIds 與所放送廣告城市對應的條件 ID。 字串陣列 已放送城市清單的地理區域條件 ID 條件，在 Google Ads 指定地理區域目標清單中，條件 ID 必須是目標類型城市的
已啟用 標記為這個商家是否應處於有效或暫停狀態 布林值 True/False 是
每月預算 這個供應商的每月預算 (每月預算) 整數 100 是 必須大於或等於出價或待開發客戶預訂價格的最大值。
每月預算預算 每月預算與出價的貨幣。請參閱「貨幣代碼」。 string “USD” 是 初始商家設定完成後即無法變更。
摘要 每個類別的摘要陣列 物件陣列 是 從 Google 提供的摘要清單中選擇
出價策略 這個商家的出價策略。會影響每位待開發客戶的價格。 string 「MANUAL_CPA」/「MAX_CONVERSION」 否 從 Google 提供的名單中挑選。如未設定，這項策略會預設為 MANUAL_CPA。
出價設定 每個類別的出價設定清單。僅適用於「MANUAL_CPA」出價策略。 物件陣列 查看商家檔案動態饋給範例 否 如果未提供設定，BidStrategy 也設為 MANUAL_CPA，請將每個類別預設為最低出價。
出價設定 - 類別 ID LSA 分類中的類別 ID。這些類別應與上述類別相符。如果已宣告出價設定，則為必填欄位。 string 否 從 Google 提供的清單中選取。
出價設定 - 手動單次費用待開發客戶 手動設定每位待開發客戶費用。如果配對策略為「MANUAL_CPA」，就必須提供這項屬性。 object 否
手動單次待開發客戶費用 - 出價 手動每位待開發客戶出價。待開發客戶價格絕不會超過這個出價的值。如果已宣告 ManualCostPerLead，則為必要欄位。 數字 否 必須大於或等於預留價格。