Feed profil

Semantik feed profil

Seperti yang disebutkan dalam definisi kategori feed, semantik feed snapshot adalah tindakan berikut:

  • Untuk penyedia mana pun dalam feed snapshot, jika penyedia saat ini tidak ada dalam database penyedia LSA, profil baru akan dibuat.
  • Untuk setiap penyedia dalam feed rekaman, jika penyedia saat ini ada dalam database penyedia LSA, informasi profil akan diperbarui.
  • Untuk penyedia yang tidak ada dalam feed snapshot, jika penyedia saat ini ada di database penyedia LSA, profil akan dihapus.

Semantik feed inkremental menghasilkan tindakan berikut:

  • Untuk penyedia mana pun dalam feed inkremental, jika saat ini penyedia tersebut tidak ada dalam database penyedia LSA, maka tidak ada operasi yang dilakukan.
  • Untuk penyedia mana pun dalam feed inkremental, jika penyedia saat ini ada di database penyedia LSA, informasi profil akan diperbarui.
  • Untuk penyedia yang tidak ada dalam feed inkremental, ini adalah operasi kosong (no-op).

Penanganan error pada profil

Jika item feed profil tertentu tidak valid, kami tidak akan memperbarui item feed tersebut di database LSA, dan sementara itu kami akan menjeda item ini untuk menghindari penayangan data yang tidak berlaku.

Jika feed profil tidak valid (misalnya, tidak mematuhi skema), kami akan berhenti memproses seluruh feed. Kami akan membagikan laporan yang mencakup ringkasan hasil pemrosesan feed (misalnya, error, status pemrosesan untuk setiap item, dll.).

Protokol dan batasan

  1. Constraints. Setiap bisnis (item feed) dalam feed harus memiliki ID unik.

  2. Batasan. LSA memberlakukan batas ukuran pada setiap kolom data, yang ditentukan dalam tabel di bawah.

  3. Batasan pada Nama bisnis

    1. Panjang maksimum: 100 karakter, termasuk spasi
    2. Memerlukan setidaknya satu angka atau huruf
    3. Encoding huruf yang didukung adalah UTF-8, UTF-16, dan UTF-32 (direkomendasikan UTF-8)
    4. Karakter khusus yang diizinkan:
      1. Tanda Hubung -, Ampersand &, Titik ., Koma ,, Apostrof ', Tanda Kurung ( )
    5. Tidak mengizinkan HURUF BESAR SEMUA
    6. Tidak mengizinkan kata-kata yang menyinggung
    7. Tidak mengizinkan emoji

Kolom profil

Berikut ini menjelaskan kolom yang ditetapkan untuk penyedia tertentu. Kolom yang bersifat opsional ditandai sebagai opsional.

Nama Kolom Deskripsi Jenis Kolom Contoh Wajib Batasan
serviceProviderId ID unik listingan bisnis (penyedia layanan) angka 12345 Ya Ini adalah ID unik untuk setiap penyedia layanan. Nilai ini akan dikonversi menjadi int64. Pastikan ID tetap sama saat memperbarui penyedia
serviceProviderName Nama bisnis string "King David Garage Doors, Inc." Ya Maksimum 100 karakter. Tunduk pada kebijakan batasan nama.
serviceProviderWebsiteUrl URL situs bisnis string https://abc.xyz Tidak Awali dengan http atau https
alamat Alamat bisnis objek "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" Ya addressLine1 harus diisi dengan alamat jalan jika tersedia. Kode negara tidak dapat diubah setelah penyiapan bisnis awal.
aggregatorProfileUrl URL profil yang tertaut ke halaman profil di situs partner. string http://aggregator.com/joes-plumbing/ Tidak Awali dengan http atau https
yearBusinessStarted Tahun berdirinya bisnis bilangan bulat 2015 Tidak Format YYYY
businessHours Jam buka bisnis Array Objek Lihat “Contoh Feed Profil”. Ya Lihat definisi objek untuk mengetahui batasan
businessPhoneNumber Nomor telepon bisnis individual dalam format e164, harus kosong atau dimiliki oleh bisnis, bukan nomor pusat panggilan atau nomor pelacakan yang dialokasikan oleh partner. string “+16501112222” Ya Nomor telepon harus dalam format E.164
kontak informasi kontak yang digunakan untuk berbagai metode kontak Array objek "{ “type”: “PHONE”, “address”: “+16501112222” }" Ya Jenis dapat terdiri dari “PHONE” atau “MESSAGE”. Untuk jenis “PHONE”, alamat harus berisi nomor telepon berformat E.164. Untuk “PESAN”, alamat tidak boleh diisi. Elemen dengan jenis PHONE wajib diisi, tetapi elemen dengan jenis MESSAGE bersifat opsional.
targetingLanguages Daftar bahasa yang akan digunakan untuk menayangkan iklan. Bahasa ditentukan dalam kode bahasa ISO 639-1 (huruf kecil, 2 huruf). Array string “en”, “fr” Ya Jika tidak diberikan, setelan defaultnya adalah “en”.
geoCovered Wilayah geografis yang dilayani oleh bisnis. objek Tidak
geoCovered ->criteriaIds Daftar ID kriteria yang sesuai dengan area (wilayah, kabupaten, kota, kode pos) yang dilayani. Array bilangan bulat Tidak ID kriteria geografis harus valid dalam daftar target geografis Google Ads.
kategori Daftar kategori yang dilayani oleh bisnis. Array objek Lihat “Contoh Feed Profil”. Ya Dipilih dari daftar kategori yang disediakan Google. Kolom ini harus berisi tepat satu kategori.
categories->tasks Daftar tugas yang ditayangkan dalam kategori tertentu. Array objek Ya Untuk dipilih dari daftar tugas yang disediakan Google
tasks ->geoCovered Geo yang ditayangkan oleh tugas objek Ya
tasks ->geoCovered->postalCodeCriteriaIds Daftar ID kriteria yang sesuai dengan kode pos yang ditayangkan. Array string ID kriteria geografis dari daftar kode pos yang ditayangkan, ID kriteria harus valid dalam daftar target geografis Google Ads dengan target Type PostalCode
tasks ->geoCovered->cityCriteriaIds Daftar ID kriteria yang sesuai dengan kota yang dilayani. Array string ID kriteria geografis dari daftar kota yang ditayangkan, ID kriteria harus valid dalam daftar target geografis Google Ads dengan target Type City)
aktif Tanda yang menunjukkan apakah bisnis ini harus aktif atau dijeda boolean true/false Ya
monthlyBudget Anggaran bulanan penyedia ini dalam monthlyBudgetCurrency bilangan bulat 100 Ya Harus lebih besar dari atau sama dengan harga minimum bid atau prospek.
monthlyBudgetCurrency Mata uang anggaran bulanan dan bid. Lihat Kode Mata Uang. string “USD” Ya Tidak dapat diubah setelah penyiapan bisnis awal.
info Array info untuk setiap kategori Array objek Ya Dipilih dari daftar info yang disediakan Google
biddingStrategy Strategi Bidding untuk bisnis ini dalam lelang. Memengaruhi harga per prospek. string “MANUAL_CPA” / “MAX_CONVERSION” Tidak Akan dipilih dari daftar yang disediakan Google . Jika tidak disetel, strategi ini akan ditetapkan secara default ke MANUAL_CPA.
biddingConfiguration Daftar konfigurasi bidding per kategori. Berlaku hanya untuk strategi bidding MANUAL_CPA. Array objek Lihat contoh feed Profil T Jika tidak ada konfigurasi yang diberikan dan biddingStrategy adalah MANUAL_CPA, tetapkan setiap kategori ke bid minimum secara default.
biddingConfiguration->categoryId ID Kategori dalam taksonomi LSA. Kategori ini harus cocok dengan kategori yang tercantum di atas. Wajib diisi jika konfigurasi bidding dinyatakan. string Tidak Akan dipilih dari daftar yang disediakan Google.
biddingConfiguration->manualCostPerLead Konfigurasi biaya per prospek manual. Harus diberikan jika biddingStrategy adalah “MANUAL_CPA”. objek Tidak
manualCostPerLead->bid Bidding biaya per prospek manual. Harga prospek tidak akan pernah melebihi nilai bid ini. Wajib diisi jika manualCostPerLead dinyatakan. angka Tidak Harus lebih besar dari atau sama dengan harga reservasi.