個人資料動態消息語意
如動態饋給類別定義所述，快照動態饋給的語意為下列動作：
- 如果快照動態饋給中的任何供應商目前不在 LSA 供應商資料庫中，系統就會建立新的設定檔。
- 如果快照動態饋給中的供應商目前存在於 LSA 供應商資料庫，系統就會更新該供應商的設定檔資訊。
- 如果供應商目前位於 LSA 供應商資料庫中，但不在快照動態消息中，系統會刪除該供應商的設定檔。
增量動態饋給的語意會導致下列動作：
- 如果增量動態消息中的任何供應商目前不存在於 LSA 供應商資料庫中，系統會執行空作業。
- 如果增量動態饋給中的供應商目前已存在於 LSA 供應商資料庫，系統就會更新該供應商的設定檔資訊。
- 如果供應商不在漸進式動態饋給中，則為無運算。
設定檔的錯誤處理
如果個別商家檔案動態消息項目無效，系統就不會更新商家檔案資料庫中的該動態消息項目，同時會暫停該項目，避免提供過時資料。
如果設定檔動態饋給無效 (例如不符合結構定義)，系統會停止處理整個動態饋給。我們會分享報表，其中包含動態饋給處理結果摘要 (例如錯誤、每個項目的處理狀態等)。
通訊協定和限制
限制。動態饋給中的每個商家 (動態饋給項目) 都必須有專屬 ID。
限制。LSA 對個別資料欄位設有大小限制，詳情請參閱下表。
商家名稱限制
- 長度上限：100 個字元 (含空格)
- 至少須包含一個數字或字母
- 支援的字母編碼為 UTF-8、UTF-16 和 UTF-32 (建議使用 UTF-8)
- 可用的特殊字元：
- 連字號
-、AND 符號&、句號.、逗號,、單引號'、半形括號()
- 連字號
- 禁止使用全大寫
- 禁止使用令人反感的字詞
- 禁止使用表情符號
個人資料欄位
以下說明特定供應商的設定欄位。選填欄位會標示為選填。
| 欄位名稱 | 說明 | 欄位類型 | 範例 | 必填 | 限制 |
|---|---|---|---|---|---|
| serviceProviderId | 商家資訊 (服務供應商) 的專屬 ID | 數字 | 12345 | 是 | 這是每個服務供應商的專屬 ID。這會轉換為 int64。更新供應商時請使用相同的 ID |
| serviceProviderName | 商家名稱 | 字串 | 「King David Garage Doors, Inc.」 | 是 | 最多 100 個字元。須遵守名稱限制政策。 |
| serviceProviderWebsiteUrl | 商家網站網址 | 字串 | https://abc.xyz | 否 | 開頭須為 http 或 https |
| 地址 | 商家地址 | 物件 | "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" | 是 | 如有街道地址，請務必填入 addressLine1。完成初始商家設定後，就無法變更國家/地區代碼。 |
| aggregatorProfileUrl | 個人資料網址，連結至合作夥伴網站上的個人資料頁面。 | 字串 | http://aggregator.com/joes-plumbing/ | 否 | 開頭須為 http 或 https |
| yearBusinessStarted | 公司創立年份 | 整數 | 2015 | 否 | YYYY 格式 |
| businessHours | 商家營業時間 | 物件陣列 | 請參閱「商家檔案動態消息範例」。 | 是 | 如要瞭解限制，請參閱物件定義 |
| businessPhoneNumber | 採用 e164 格式的個別商家電話號碼，應為空白或由商家擁有，而非客服中心號碼或合作夥伴分配的追蹤號碼。 | 字串 | 「+16501112222」 | 是 | 電話號碼必須為 E.164 格式 |
| 聯絡人 | 用於各種聯絡方式的聯絡資訊 | 物件陣列 | "{ “type”: “PHONE”, “address”: “+16501112222” }" | 是 | 類型可為「PHONE」或「MESSAGE」。如果類型為「PHONE」，地址必須包含 E.164 格式的電話號碼。「MESSAGE」地址不得填入。必須提供「電話」類型的元素，但「訊息」類型的元素為選填。 |
| targetingLanguages | 廣告放送的語言清單。語言是以 ISO 639-1 語言代碼 (小寫，2 個字母) 定義。 | 字串陣列 | 「en」、「fr」 | 是 | 如未提供，則預設為「en」。 |
| geoCovered | 商家提供的地理位置。 | 物件 | 否 | ||
| geoCovered ->criteriaIds | 與服務區域 (地區、縣市、城市、郵遞區號) 對應的條件 ID 清單。 | 整數陣列 | 否 | 指定地理區域條件 ID 必須在 Google Ads 地理區域目標清單中有效。 | |
| 類別 | 商家提供的類別清單。 | 物件陣列 | 請參閱「商家檔案動態消息範例」。 | 是 | 請從 Google 提供的類別清單中選取。這項屬性只能包含一個類別。 |
| categories->tasks | 指定類別中提供的任務清單。 | 物件陣列 | 是 | 從 Google 提供的工作清單中選取 | |
| tasks ->geoCovered | 工作服務的地理區域 | 物件 | 是 | ||
| tasks ->geoCovered->postalCodeCriteriaIds | 與服務郵遞區號相應的條件 ID 清單。 | 字串陣列 | 放送郵遞區號清單的地理區域條件 ID，條件 ID 必須在 Google Ads 地理區域目標清單中有效，且目標類型為 PostalCode | ||
| tasks ->geoCovered->cityCriteriaIds | 與提供服務的城市相應的條件 ID 清單。 | 字串陣列 | 放送廣告的城市清單的地理區域條件 ID，條件 ID 必須在 Google Ads 地理區域目標清單中有效 (目標類型為「城市」) | ||
| 已啟用 | 指出商家應處於有效或暫停狀態的標記 | 布林值 | true/false | 是 | |
| monthlyBudget | 這個供應商的每月預算 (以 monthlyBudgetCurrency 為單位) | 整數 | 100 | 是 | 必須大於或等於出價或待開發客戶保留價格上限。 |
| monthlyBudgetCurrency | 每月預算和出價的幣別。請參閱幣別代碼。 | 字串 | “USD” | 是 | 完成初始商家設定後即無法變更。 |
| 摘要 | 各類別的宣傳內容陣列 | 物件陣列 | 是 | 從 Google 提供的摘要清單中選取 | |
| biddingStrategy | 這項業務在競價時採用的出價策略。這會影響每位待開發客戶費用。 | 字串 | 「MANUAL_CPA」/「MAX_CONVERSION」 | 否 | 從 Google 提供的清單中選取。如未設定，這項策略預設為 MANUAL_CPA。 |
| biddingConfiguration | 每個類別的競價設定清單。僅適用於 MANUAL_CPA 出價策略。 | 物件陣列 | 查看商家檔案動態消息範例 | 否 | 如未提供任何設定，且 biddingStrategy 為 MANUAL_CPA，則每個類別都會預設為最低出價。 |
| biddingConfiguration->categoryId | LSA 分類中的類別 ID。這些類別應與上述類別相符。如果已聲明出價設定，則為必要欄位。 | 字串 | 否 | 從 Google 提供的清單中選取。 | |
| biddingConfiguration->manualCostPerLead | 手動設定每位待開發客戶費用。如果 biddingStrategy 為「MANUAL_CPA」，則必須提供這項屬性。 | 物件 | 否 | ||
| manualCostPerLead->bid | 手動設定每位待開發客戶費用出價。因此，待開發客戶價格絕不會超過這個出價值。如果聲明 manualCostPerLead，則為必填。 | 數字 | 否 | 必須大於或等於底價。 |