Ngữ nghĩa của nguồn cấp dữ liệu hồ sơ
Như đã đề cập trong phần định nghĩa danh mục nguồn cấp dữ liệu, ngữ nghĩa của nguồn cấp dữ liệu nhanh là các thao tác sau:
- Đối với bất kỳ nhà cung cấp nào trong nguồn cấp dữ liệu nhanh, nếu nhà cung cấp hiện không có trong cơ sở dữ liệu nhà cung cấp LSA, thì một hồ sơ mới sẽ được tạo.
- Đối với bất kỳ nhà cung cấp nào trong nguồn cấp dữ liệu ảnh chụp nhanh, nếu nhà cung cấp đó hiện có trong cơ sở dữ liệu nhà cung cấp LSA, thì thông tin hồ sơ sẽ được cập nhật.
- Đối với bất kỳ nhà cung cấp nào không có trong nguồn cấp dữ liệu ảnh chụp nhanh, nếu nhà cung cấp đó hiện có trong cơ sở dữ liệu nhà cung cấp LSA, thì hồ sơ sẽ bị xoá.
Ngữ nghĩa của nguồn cấp dữ liệu gia tăng dẫn đến các hành động sau:
- Đối với bất kỳ nhà cung cấp nào trong nguồn cấp dữ liệu gia tăng, nếu nhà cung cấp đó hiện không có trong cơ sở dữ liệu nhà cung cấp LSA, thì đó là một thao tác không có tác dụng.
- Đối với bất kỳ nhà cung cấp nào trong nguồn cấp dữ liệu gia tăng, nếu nhà cung cấp đó hiện có trong cơ sở dữ liệu nhà cung cấp LSA, thì thông tin hồ sơ sẽ được cập nhật.
- Đối với bất kỳ nhà cung cấp nào không có trong nguồn cấp dữ liệu tăng dần, đây là một thao tác không có tác dụng.
Xử lý lỗi trên hồ sơ
Nếu một mục trong nguồn cấp dữ liệu hồ sơ cá nhân không hợp lệ, thì chúng tôi sẽ không cập nhật mục đó trong cơ sở dữ liệu quảng cáo tìm kiếm tại địa phương. Đồng thời, chúng tôi sẽ tạm dừng mục này để tránh phân phát dữ liệu cũ.
Nếu nguồn cấp dữ liệu hồ sơ không hợp lệ (ví dụ: không tuân thủ lược đồ), chúng tôi sẽ ngừng xử lý toàn bộ nguồn cấp dữ liệu. Chúng tôi sẽ chia sẻ một báo cáo bao gồm thông tin tóm tắt về kết quả xử lý nguồn cấp dữ liệu (ví dụ: lỗi, trạng thái xử lý cho từng mặt hàng, v.v.).
Giao thức và các ràng buộc
Các ràng buộc. Mỗi doanh nghiệp (mục trong nguồn cấp dữ liệu) trong một nguồn cấp dữ liệu phải có một mã nhận dạng riêng biệt.
Giới hạn. LSA áp đặt giới hạn về kích thước đối với từng trường dữ liệu, được chỉ định trong bảng bên dưới.
Các ràng buộc đối với Tên doanh nghiệp
- Độ dài tối đa: 100 ký tự, bao gồm cả dấu cách
- Yêu cầu phải có ít nhất một chữ số hoặc chữ cái
- Các phương thức mã hoá chữ cái được hỗ trợ là UTF-8, UTF-16 và UTF-32 (nên dùng UTF-8)
- Ký tự đặc biệt được phép:
- Dấu gạch nối
-, Dấu và&, Dấu chấm., Dấu phẩy,, Dấu nháy đơn', Dấu ngoặc đơn()
- Dấu gạch nối
- Không cho phép VIẾT HOA TOÀN BỘ
- Không cho phép sử dụng từ ngữ phản cảm
- Không cho phép biểu tượng cảm xúc
Trường hồ sơ
Sau đây mô tả các trường được đặt cho một nhà cung cấp nhất định. Các trường không bắt buộc sẽ được đánh dấu là không bắt buộc.
| Tên trường | Mô tả | Loại trường | Ví dụ: | Bắt buộc | Giới hạn |
|---|---|---|---|---|---|
| serviceProviderId | Giá trị nhận dạng riêng biệt của trang thông tin doanh nghiệp (nhà cung cấp dịch vụ) | số | 12345 | Có | Đây là mã nhận dạng duy nhất cho mỗi nhà cung cấp dịch vụ. Giá trị này sẽ được chuyển đổi thành int64. Giữ nguyên mã nhận dạng khi cập nhật nhà cung cấp |
| serviceProviderName | Tên doanh nghiệp | chuỗi | "King David Garage Doors, Inc." | Có | Tối đa 100 ký tự. Tuân thủ chính sách về các quy định hạn chế đối với tên. |
| serviceProviderWebsiteUrl | URL trang web của doanh nghiệp | chuỗi | https://abc.xyz | Không | Bắt đầu bằng http hoặc https |
| xử lý | Địa chỉ doanh nghiệp | đối tượng | "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" | Có | addressLine1 phải được điền sẵn địa chỉ đường phố (nếu có). Bạn không thể thay đổi mã quốc gia sau khi thiết lập doanh nghiệp ban đầu. |
| aggregatorProfileUrl | URL hồ sơ liên kết đến trang hồ sơ trên trang web của đối tác. | chuỗi | http://aggregator.com/joes-plumbing/ | Không | Bắt đầu bằng http hoặc https |
| yearBusinessStarted | Năm thành lập doanh nghiệp | số nguyên | 2015 | Không | Định dạng YYYY |
| businessHours | Giờ mở cửa của doanh nghiệp | Mảng đối tượng | Xem "Ví dụ về nguồn cấp dữ liệu hồ sơ". | Có | Xem định nghĩa đối tượng để biết các điều kiện ràng buộc |
| businessPhoneNumber | Số điện thoại riêng của doanh nghiệp ở định dạng e164, phải là số điện thoại trống hoặc thuộc sở hữu của doanh nghiệp, thay vì số điện thoại của trung tâm dịch vụ khách hàng hoặc số theo dõi do đối tác phân bổ. | chuỗi | "+16501112222" | Có | Số điện thoại phải có định dạng E.164 |
| liên-hệ | thông tin liên hệ được dùng cho nhiều phương thức liên hệ | Mảng đối tượng | "{ “type”: “PHONE”, “address”: “+16501112222” }" | Có | Loại có thể bao gồm "PHONE" hoặc "MESSAGE". Đối với loại "PHONE", địa chỉ phải chứa số điện thoại được định dạng theo tiêu chuẩn E.164. Bạn không được điền địa chỉ "MESSAGE". Bạn phải có phần tử thuộc loại ĐIỆN THOẠI, nhưng phần tử thuộc loại TIN NHẮN là không bắt buộc. |
| targetingLanguages | Danh sách các ngôn ngữ mà quảng cáo sẽ được phân phát. Ngôn ngữ được xác định bằng mã ngôn ngữ ISO 639-1 (viết thường, gồm 2 chữ cái). | Mảng chuỗi | "en", "fr" | Có | Nếu không được cung cấp, giá trị mặc định sẽ là "en". |
| geoCovered | Khu vực địa lý mà doanh nghiệp phục vụ. | đối tượng | Không | ||
| geoCovered ->criteriaIds | Danh sách mã tiêu chí tương ứng với các khu vực (khu vực, quận, thành phố, mã bưu chính) được phục vụ. | Mảng số nguyên | Không | Mã tiêu chí địa lý phải hợp lệ trong danh sách mục tiêu địa lý của Google Ads. | |
| danh mục | Danh sách các danh mục mà doanh nghiệp cung cấp. | Mảng đối tượng | Xem "Ví dụ về nguồn cấp dữ liệu hồ sơ". | Có | Được chọn trong danh sách danh mục do Google cung cấp. Phần này phải chứa đúng một danh mục. |
| danh mục->việc cần làm | Danh sách các việc cần làm được cung cấp trong một danh mục nhất định. | Mảng đối tượng | Có | Được chọn trong danh sách việc cần làm do Google cung cấp | |
| tasks ->geoCovered | Vị trí địa lý mà nhiệm vụ phục vụ | đối tượng | Có | ||
| tasks ->geoCovered->postalCodeCriteriaIds | Danh sách mã tiêu chí tương ứng với mã bưu chính được phân phát. | Mảng chuỗi | Mã tiêu chí địa lý của danh sách mã bưu chính được phân phát, mã tiêu chí phải hợp lệ trong danh sách mục tiêu theo địa lý của Google Ads với loại mục tiêu là PostalCode | ||
| tasks ->geoCovered->cityCriteriaIds | Danh sách mã tiêu chí tương ứng với các thành phố được phục vụ. | Mảng chuỗi | Mã tiêu chí địa lý của danh sách thành phố được phục vụ, mã tiêu chí phải hợp lệ trong danh sách mục tiêu theo địa lý của Google Ads (với Loại mục tiêu là Thành phố) | ||
| hoạt động | Cờ cho biết liệu doanh nghiệp này có đang hoạt động hay đang tạm dừng | boolean | true/false | Có | |
| monthlyBudget | Ngân sách hằng tháng của nhà cung cấp này theo monthlyBudgetCurrency | số nguyên | 100 | Có | Phải lớn hơn hoặc bằng giá thầu tối đa hoặc giá dự trữ của khách hàng tiềm năng. |
| monthlyBudgetCurrency | Đơn vị tiền tệ của ngân sách hằng tháng và giá thầu. Xem Mã đơn vị tiền tệ. | chuỗi | “USD” | Có | Bạn không thể thay đổi thông tin này sau khi thiết lập doanh nghiệp lần đầu. |
| chú thích | Một mảng chú thích cho mỗi danh mục | Mảng đối tượng | Có | Được chọn trong danh sách chú thích do Google cung cấp | |
| biddingStrategy | Chiến lược đặt giá thầu cho doanh nghiệp này trong phiên đấu giá. Ảnh hưởng đến giá mỗi khách hàng tiềm năng. | chuỗi | "MANUAL_CPA" / "MAX_CONVERSION" | Không | Được chọn trong danh sách do Google cung cấp . Nếu bạn không đặt, chiến lược này sẽ mặc định là MANUAL_CPA. |
| biddingConfiguration | Danh sách các cấu hình đặt giá thầu theo danh mục. Chỉ áp dụng cho chiến lược đặt giá thầu MANUAL_CPA. | Mảng đối tượng | Xem ví dụ về nguồn cấp dữ liệu hồ sơ | Không | Nếu không có cấu hình nào được cung cấp và biddingStrategy là MANUAL_CPA, hãy đặt giá thầu tối thiểu cho mọi danh mục theo mặc định. |
| biddingConfiguration->categoryId | Mã danh mục trong hệ thống phân loại quảng cáo kho hàng tại địa phương. Các danh mục này phải khớp với các danh mục được liệt kê ở trên. Bắt buộc nếu bạn khai báo cấu hình đặt giá thầu. | chuỗi | Không | Được chọn trong danh sách do Google cung cấp. | |
| biddingConfiguration->manualCostPerLead | Cấu hình chi phí cho mỗi khách hàng tiềm năng theo cách thủ công. Bạn nên cung cấp nếu biddingStrategy là "MANUAL_CPA". | đối tượng | Không | ||
| manualCostPerLead->bid | Giá thầu chi phí cho mỗi khách hàng tiềm năng thủ công. Giá thầu chính sẽ không bao giờ vượt quá giá trị của giá thầu này. Bắt buộc nếu bạn khai báo manualCostPerLead. | số | Không | Phải lớn hơn hoặc bằng giá dự trữ. |