XML dosyası aracılığıyla verilerin güncellenmesi

Ağınızda 30’dan fazla şube varsa, Yandex Business’teki verileri bir XML dosyası kullanarak güncellemenizi öneririz.

Şubelerinize ilişkin veriler, XML dosyasındaki bilgilere dayanarak güncellenecektir:

Yeni şubeler veritabanına eklenecek ve belirtilen özelliklerle hizmetlerde görüntülenecektir.
Bilgileri XML dosyasına eklenmemiş şube kartları kapatılacaktır.

Adım 1. XML dosyasını hazırlayın

İçerik gereksinimleri

Dikkat

Bu gereksinimleri yerine getirmezseniz veya veriler web sitesiyle uyuşmazsa, dosyayı yayınlamayacağız.

Moderatörler, dosyadaki ve web sitesindeki verilerin uyumluluğunu kontrol eder:

Adres
Yasal adreslerin eklenmesi gerekmez.
Telefon
Numaralar aynı olmalıdır.
Web sitesinde, dosyayla eşleşmeyen yönlendirme numaraları varsa, dosyayı iletirken bunu belirtin.
Çalışma Saatleri
Erişimi kısıtlı kuruluşlar varsa, dosyayı iletirken bunu belirtin.
Kategori
Web sitesindeki ve dosyadaki ana kategori eşleşmelidir.
Kategoriler anlam olarak uyumlu olmalıdır.

Doğru: Lastik Tamiri, Oto Servisi
Yanlış: Lastik Tamiri, Pastane
Şube Sayısı.
Kopyaların olmaması – iki farklı kuruluşta aynı adres ve koordinatların bulunmaması.
İstisnalar
Aynı adreslere sahip olabilen, ancak farklı koordinatları (30 metreden fazla fark) olması gereken kategorilerin listesi:
- ATM’ler
- Paket terminalleri
- Otomatlar
- Terminaller

Aşağıdaki özellikler için kuruluşun web sitesiyle uyumluluk tercih edilir:

Dahili Telefon
Ek Kategoriler
Resmi Tatil Çalışma Saatleri
Adreslerde Bina/Harf

Teknik gereksinimler

XML dosyası UTF‑8 kodlamasında oluşturulmalıdır.
Dosya boş değil.
Boş öğe yok.
Standart XML Başlığı ilk satırdan boş karakterle başlamalıdır. Örneğin:
```
<?xml version="1.0" encoding="UTF-8"?>
```
Doğru XML yapısına uyulur.

Dosya şu şekilde kontrol edilebilir:
- Webmaster Doğrulayıcısı kullanılarak.
  Belge doğrulama şeması olarak İş seçin ve XML veri kaynağı olarak dosya, bağlantı veya metin belirleyin.
- Kendi bilgisayarınızda şema (XML Schema Definition) kullanarak bağımsız olarak.
Verilerde HTML öğeleri bulunmamalıdır.
Metin alanlarında 0 ile 31 arası ASCII kodlu karakterlere izin verilmez.
Verilerde HTML öğeleri bulunmamalıdır.
Metin alanlarında 0 ile 31 arası ASCII kodlu karakterlere izin verilmez.

İstisnalar: 9 (sekme), 10 (satır sonu), 13 (satır başı) değerleri.
& karakterleri & ile değiştirilmiştir.
Şubeleri tanımlamak için zorunlu ve isteğe bağlı özellikler setini kullanın. Her şube özelliğini ayrı bir etiket içine alın (bkz. Dosya Örneği).
Bir özellik için birden fazla değer varsa (örneğin telefonlar), aynı isme sahip birden fazla etiket iletin.
XML dosyasında iki veya daha fazla aynı company-id yok.
XML dosyasındaki veriler tek bir dilde olmalıdır. Çok dilli özellikler istisnadır (bkz. Özellik Açıklamaları).

Çok dilli özellik – XML dosyasında birden fazla dilde değerlere sahip bir etikettir.

Dil, lang özniteliği ile belirlenir. Her yeni dil için, ayrı bir satırda kendi lang özniteliğine sahip bir etiket belirtin.
Örnek
<address lang="ru">İstanbul şehri, Büyük Postane Caddesi, 7</address> <address lang="tr">Büyük Postane Cd. No. 7, İstanbul</address>
Güncel değerler XML şemasına uygun olmalıdır. Diğer dilleri eklemek için destek hizmetlerine başvurun.

Alan açıklamaları

İşaret	Açıklama	Çok dilli öğe	Zorunlu Alan
companies	Kök öznitelik.	Y/B	Evet
company	Şube açıklaması. Kök özniteliğin içine yerleştirilir. `company` özniteliğinin miktarı keyfi olabilir.	Y/B	Evet
company-id	Şubenin eşsiz değiştirilemeyen kimlik tanımlayıcısı (ağ sahibi tarafından verilir). İstediğiniz rakam ve Latin harflerini içerebilir.	Hayır	Evet
name	Belirli bir şubenin adı. Tırnak işareti, caps lock, özel karakter olmadan, büyük/küçük harfe dikkat edilerek belirtilir. Ağ adıyla eşleşmeli ve şube belirtici içermemelidir – tıpkı web sitesindeki gibi. Açıklamalar sadece `name-other` öğesine yazılabilir. Doğru: _Papatya_Yanlış: İstiklal’in Sokağında Papatya	Evet	Evet
shortname	Haritalarda etiketlerin yanında, 25 karaktere kadar kısa şube adı. Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir.	Evet	Hayır
name-other	Şube için açıklamalar (“Ek Ofis No. 1”) veya şubenin alternatif adı (eğer birden fazla ad varsa, her birini ayrı bir öğede belirtin). Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Mutlaka dili belirtin: `<`.	Evet	Hayır
address	Şubenin tam adresi – bölge, şehir, cadde, bina numarası (istisnalar: köyler, benzin istasyonları, otoyollardaki kuruluşlar, Yandex Maps’de bina numarası olmayanlar). Şubenin tam adres bilgisi yoksa, adres kısmen belirtilebilir, ancak dosyada belirtilen koordinatlarla çelişmemelidir. Tek bir satır olarak yazılır. Doğru: İstanbul, İstiklal, 72k2 Yanlış: İstanbul, İstiklal Öğe yalnızca sokak adı ve bina numarası içeriyorsa, yerleşim yerini belirten `locality name` öğesini kullanın. Fazladan bilgi içermemelidir: kat numaraları, ofisler, referans noktaları.	Evet	Evet
country	Ülke. Ülke adını kısaltmasız ve tam olarak yazın. Bir dosya için yalnızca bir ülke. Farklı ülkeler için ayrı ağlar oluşturmanız ve bunları farklı dosyalarla güncellemeniz gerekir.	Evet	Hayır
address-add	Diğer öğelerle ilgili olmayan adres için ek bilgi (AVM/ticaret merkezi adı, kat, ofis, oda, butik, giriş). Örneğin, Rosa Alışveriş Merkezi, 2. kat, ofis 203. Referans noktalarına ve adrese giden yolun ayrıntılı açıklamalarına izin verilmez (metro istasyonundan 100 metre tam kuzeyde, Puşkin Bahçesi’nin sağındaki mavi bina). Parantez ve tırnak işaretleri kullanmayın.	Evet	Hayır
phone	Kuruluşun telefon numarası. (Birden fazla numara varsa, her biri ayrı bir öğede belirtilir). Bileşik öğe. İçinde zorunlu öğeler bulunur. `<phone> <number>00 90 212 200-23-45</number> <type>phone</type> </phone>`	Hayır	Evet
phone içine yerleştirilmiş öğeler
number	Sabit hat veya cep telefonu numarası. Şu biçimde belirtilir: `[ülke kodu]` (`[şehir kodu]`) `[telefon numarası]`.		Evet
ext	Dahili numara (açıklama, sözcük ve ayırıcılar olmadan).
info	Numara hakkında bilgi: örneğin, yönetmen, sekreter. Bu öğede telefon tipi bilgisini belirtmeyin.
type	Telefon türü. İzin verilen değerler: `phone` : telefon; `fax` : faks; `phone-fax` : telefon-faks.		Evet

E-posta	E-posta adresi (birden fazla adres varsa, her birini ayrı bir öğede belirtin).	Hayır	Hayır
url	Ağın ana web sitesi (sosyal medya hesapları hariç). Küçük harfle, `http://` veya `https://` dahil tam olarak belirtilir. Sosyal medya bağlantıları için `add-url` özelliğini kullanın. Şubeler için bölgesel web siteleri kullanılabilir. Bağlantılarda UTM etiketleri bulunmamalıdır.	Hayır	Evet
add-url	Ek ağ sitesi (örneğin, sosyal medya bağlantıları). Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi `info‑page` öğesi içinde gösterilir.	Hayır	Hayır
info-page	Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi. Adresin, ağın web sitesi alan adını içerdiğinden emin olun. http:// veya https://dahil olmak üzere tamamen küçük harflerde belirtilir.	Hayır	Hayır
working-time	Çalışma saatleri. Hafta sonu, çalışılmayan günler belirtilmez. Genel çalışma saatleri (bölümler için farklı saatler olmadan). Örnek `<working-time lang="ru">her gün 11.30-21.30 mola 14.00-14.30, mola 16.30-17.00</working-time>` Eğer resmi tatil günleri varsa – kesin tarihlerle ayrı bir `scheduled-working-time` öğesi gerekir.	Evet	Evet
scheduled-working-time	Resmi tatil günlerinde çalışma saatleri.		Hayır
rubric-id	İlgili şubenin ait olduğu kategori kimliği. Her şubenin en az bir, en fazla üç kategorisi olabilir, ancak en az bir tanesi şube ağının kategorileriyle eşleşmelidir. Bir şubenin birden fazla kategorisi varsa, bunları ayrı öğelerde belirtin.	Hayır	Evet
actualization-date	Güncellenme Tarihi. Verilerin son güncellenme saatine karşılık gelir. Bir önceki denetlemede alınan bilgilerin indirilmemesi için kullanılır. İçerik şu biçimde gösterilebilir: `GG.AA.YYYY`; UNIX time – `00.00.00,000 01.01.1970` zamanından itibaren milisaniye cinsinden belirtilir.	Hayır	Evet
coordinates	Bileşik öğe. Enlem ve boylam koordinatları.	Hayır	Evet (eğer adres kesin değilse)
coordinates içine yerleştirilmiş öğeler
lon	Boylam koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır. Koordinatlar adresle çelişmemelidir. Adresler ve koordinatlar arasında farklılık, sadece Yandex Maps’te adres bilgisi bulunmadığında kabul edilir. Koordinatlar, Yandex Maps’teki binanın üzerine denk gelmelidir. Koordinatların binanın üzerine denk gelmemesi, sadece Yandex Maps’te bina bulunmadığında kabul edilir.		Evet (eğer adres eksikse)
lat	Enlem koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır. Koordinatlar adresle çelişmemelidir. Adresler ve koordinatlar arasında farklılık, sadece Yandex Maps’te adres bilgisi bulunmadığında kabul edilir. Koordinatlar, Yandex Maps’teki binanın üzerine denk gelmelidir. Koordinatların binanın üzerine denk gelmemesi, sadece Yandex Maps’te bina bulunmadığında kabul edilir.		Evet (eğer adres eksikse)

photos	Ağ sitesinde tüm fotoğrafları içeren galeri veya sayfaya yönlendiren bağlantı. Birden fazla fotoğraf varsa, her biri ayrı bir `photo` öğesinde belirtilir. Şu öznitelikleri içerebilir: `alt` : serbest biçimde fotoğraf metin açıklaması; `type` : fotoğraf türü. Tek bir değer alabilir – `interior` (iç mekan).	Hayır	Hayır
photos içine yerleştirilmiş öğeler
tag	Fotoğraf etiketi. `photos` öğesi içinde belirtilir. İzin verilen değerler: `INTERIOR` – iç mekan; `EXTERIOR` – dış mekan; `ENTER` - ENTER; `LOGO` - LOGO. `FOOD` – yemekler ve içecekler; `GOODS` - eşya; `MENU` – kafe veya restoran menüsü; `ACCESSIBILITY` – engelli erişimi için rampalar, asansörler ve diğerleri; `DEVICES` – elektronik cihazlar; `SERVICES` – hizmetler.

feature-boolean	Şube özelliği. Birden fazla özellik varsa, her birini ayrı bir öğede belirtin. İzin verilen değerler: `0 – hayır;` `1 – evet.`	Hayır	Hayır
feature-enum-single	Şube özelliği.	Hayır	Hayır
feature-enum-multiple	Şube özelliği. Birden fazla özellik varsa, her birini ayrı bir öğede belirtin.	Hayır	Hayır
feature-numeric-single	Sayısal değerli şube özelliği.	Hayır	Hayır
feature-numeric-multiple	Sayısal değerli şube özelliği. Birden fazla özellik varsa, her birini ayrı bir öğede belirtin.	Hayır	Hayır
feature-in-units-single	Değeri ölçü birimlerinde belirlenen şube özelliği.	Hayır	Hayır
feature-in-units-multiple	Değeri ölçü birimlerinde belirlenen şube özelliği. Birden fazla özellik varsa, her birini ayrı bir öğede belirtin.	Hayır	Hayır
feature-range-single	Sayı aralık değeri içeren şube özelliği.	Hayır	Hayır
feature-in-units-single	Ölçü birimlerinde aralık değeri içeren şube özelliği.	Hayır	Hayır
feature-range-in-units-multiple	Ölçü birimlerinde aralık değeri içeren şube özelliği. Birden fazla özellik varsa, her birini ayrı bir öğede belirtin.	Hayır	Hayır
feature-text-single	Metin biçiminde şube özelliği.	Hayır	Hayır

Ek özellikler

XML dosyası aracılığıyla ağınız veya şubeniz için ek özellikler iletebilirsiniz. Örneğin, alışveriş merkezinizin yanında otopark olup olmadığını veya bankamatiğinizden hangi para biriminde nakit çekilebileceğini belirtebilirsiniz.

Faaliyet türünüz için olası özelliklerin listesini içeren bir XML dosyası almak için:

Ağ sayfasında Şubeler bölümüne geçin.
Şube yönetimi bloğunda Dosya sekmesini seçin.
Verileri Dışa Aktar → Özellikleri yükle seçeneğine tıklayın.

Not

Özellikleri doldururken yapılan hatalar, XML dosyasının genel olarak yayınlanmasını engellemez, ancak bu niteliklere ilişkin bilgiler yayınlanmaz.

Ek özellikli dosya dışa aktarma ile ilgili sorularınız varsa, bize yazın.

Dosya örneği

Not

Dosya örneğinden bir özelliğin açıklamasını açmak için, altı çizili herhangi bir özelliğin adına tıklayın.

        <?xml version="1.0" encoding="UTF-8"?> 
<companies>
  <company>
    <company-id>770704034</company-id>
    <name lang="ru">Yanchor</name>
    <shortname lang="ru">Yanchor</shortname>
    <address lang="ru">İstanbul şehri, Büyük Postane Caddesi, 7</address>
    <country lang="ru">Türkiye</country>
    <country lang="tr">Türkiye</country>
    <address-add lang="ru">Rosa Alışveriş Merkezi, 2. kat, ofis 203</address-add>
    <phone>
      <number>020 1234 5678</number>
      <ext>555</ext>
      <info>sekretarya</info>
      <type>phone</type>
    </phone>
    <phone>
      <type>phone</type>
      <number>034 2202 3303</number>
      <info/>
    </phone>
    <email>info@anchor.com.tr</email>
    <url>http://www.anchor.com.tr</url>
    <add-url>http://www.anchor.com.tr</add-url>
    <info-page>http://www.test.com.tr/anchor</info-page>
    <working-time lang="ru">her gün 10.00-21.00</working-time>
    <rubric-id>184106414</rubric-id>
    <rubric-id>184106394</rubric-id>
    <actualization-date>1511724300</actualization-date>
    <photos gallery-url="http://test.com.tr/anchor/gallery">
      <photo url="http://test.com.tr/anchor/11_b.jpg" alt="Otel restoranı" 
      type="interior"></photo>
      <photo url="http://test.com.tr/anchor/19_b.jpg">
        <tag>EXTERIOR</tag>
      </photo>
      <photo url="http://test.com.tr/anchor/25_b.jpg"></photo>
      <photo url="http://test.com.tr/anchor/26_b.jpg"></photo>
      <photo url="http://test.com.tr/anchor/17_b.jpg"></photo>
      <photo url="http://test.com.tr/anchor/drink1.jpg" alt="Otel barında kokteyl">
        <tag>FOOD</tag>
      </photo>
    </photos>
    <feature-boolean name="internet" value="1"/>
    <feature-enum-single name="star" value="five"/>
    <feature-numeric-single name="room_number" value="15"/>
    <feature-enum-multiplename="hotel_type" value="art_hotel"/>
    <feature-numeric-multiple name="license_number" value="004555"/>
    <feature-in-units-single name="minimum_order" unit="money" unit-value="gbp" value="30"/>
    <feature-in-units-multiple name="ats_by_type" unit="apartment_type" unit-value="single" value="200"/>
    <feature-range-single name="number_seats_banquet_hall" from="15" to="20"/>
    <feature-range-in-units-single name="tickets" unit="money" unit-value="gbp" from="10" to="15"/>
    <feature-range-in-units-single name="price_1_min" unit="money" unit-value="gbp" from="7" to="10"/>
    <feature-range-in-units-multiple name="tea" unit="money" unit-value="gbp" from="100" to="300"/>
    <feature-text-single value="Anchor_free_wi-fi" name="ssid"/>
  </company>
  <company>
    <company-id>7707040070</company-id>
    <name lang="ru">Yanchorbank</name>
    <shortname lang="ru">Yanchorbank</shortname>
    <name-other lang="ru">Şube-2</name-other>
    <address lang="ru">Türkiye, İstanbul, Fatih, Hobyar Mahallesi, Büyük Postane Caddesi, 7</address>
    <phone>
      <ext/><type>phone</type>
      <number>+90 999 999 99 90</number>
      <info/>
    </phone>
    <url>http://www.anchorbank.com.tr/</url>
    <working-time lang="ru">hafta içi 8.30-18.00, cts 9.00-14.30</working-time>
    <rubric-id>184106974</rubric-id>
    <actualization-date>23.09.2019</actualization-date>
    <coordinates>
      <lon>48.295532</lon>
      <lat>55.616051</lat>
    </coordinates>
  </company>
</companies>


        
    

Adım 2. Dosyayı kendi web sitenize yükleyin

Dosyayı, güncellenebilir bir bağlantı ile kendi web sitenize yükleyin. Veriler HTTP veya HTTPS protokolüne göre erişilebilir olmalıdır.

Adım 3. Yandex Business’te dosyanın bağlantısını belirtin

Ağ sayfasında Şubeler bölümüne geçin.
Şube yönetimi bloğunda Dosya sekmesini seçin.
Hazırlanan dosyanın bağlantısını ekleyin, XML türünü seçin ve Kontrol Et butonuna tıklayın. Dosya denetimi birkaç saat sürebilir.
Dosya kontrolü başarılı olursa, Yayınla butonuna tıklayın. Açılan pencerede şubelerdeki değişiklikleri kontrol edin. Haritada değişiklikler içeren en fazla 50 şube gösterilebilir. Her şey doğru. Veritabanına yüklemeyi başlat butonuna tıklayın. Dosyadaki veriler moderasyondan geçecek ve Yandex Business veritabanına yüklenecektir. Büyük hacimli verilerin yüklenmesi birkaç gün sürebilir.

Dosya denetimi sonucunda hatalar tespit edilirse, bu konuda bir mesaj göreceksiniz. Hataları düzeltin ve dosyayı tekrar denetlemeye gönderin.

Dosyadan Yandex Business veritabanına yüklenen şube değişikliklerini görmek için Yükleme Geçmişi butonuna tıklayın. Buton, ilk yüklemeden bir gün sonra erişilebilir olacaktır.

Yeni şubeler ve diğer değişiklikler, Yandex Maps’de birkaç gün içinde erişilebilir olacaktır.

Destek mektubu

Ayrıca şu servise de geçebilirsiniz:

Faydalı bağlantılar

Yazı yararlı oldu mu?

Verileri Manuel Güncelleme

CSV dosyası aracılığıyla verilerin güncellenmesi