XML dosyası aracılığıyla verilerin güncellenmesi
İşletmenizin şube sayısı 30'dan fazla ise Yandex Business verilerinizi güncellemek için XML dosyası kullanabilirsiniz.
Bu güncelleme yönteminin şu avantajları vardır:
- Tüm Yandex servislerinde ve mobil uygulamalarında görüntülenen şube bilgileriniz her zaman güncel olur. Potansiyel müşterileriniz en yakın şubenize ulaşmak için Yandex Maps veya Yandex Navigator'u, gerekli şubeyi bulmak için Web Arama'yı ve diğer Yandex servislerini kullanabilirler.
- Şube bilgilerinizin 1C, ERP (SAP, Axapta) veya başka bir veritabanından aktarımını tümüyle otomatikleştirebilirsiniz.
- XML dosyası aracılığıyla, fotoğraflar ve ek parametreler de dahil olmak üzere şubelerinizle ilgili tüm bilgileri aktarabilirsiniz.
Dosyanın hazırlanması
XML formatında dosya hazırlayın.
Dosyayı kontrol etmek için Webmaster Doğrulayıcısı'nı kullanabilirsiniz. Belge doğrulama şeması olarak Yandex Business'ı ve XML veri kaynağı olarak dosya, bağlantı veya metin seçin.
Dosyayı güncellenen bağlantıdan sitenize yükleyin.
Veriler HTTP veya HTTPS protokolüne göre erişilebilir olmalıdır.
Dosya hazırlama ve düzenleme bir kez yapılır. Tüm güncellemeler otomatik olarak gerçekleşir.
- Aktif olan tüm şubelerle ilgili veriler sunmak,
- Verileri güncel tutmak zorunludur.
Dosyanın arayüzde yüklenmesi
Ağ sayfasında Şubeler bölümüne geçin. Şube yönetimi bloğunda Dosya sekmesini seçin.
Hazırlanan dosya için bağlantı belirtin, “xml” türünü seçin ve Denetle butonuna tıklayın. Dosya denetimi birkaç saat sürebilir.
Dosya denetimi başarılı olursa Denetim sonuçları 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 rehber 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 Rehber veritabanına yüklenen şubelerdeki değişiklikleri görmek için Yükleme geçmişi butonuna tıklayın. Buton, ilk yüklemeden 24 saat sonra erişilebilir olacaktır.
Yandex Maps'da yeni şubeler ve diğer değişiklikler birkaç gün sonra erişebilir olacaktır.
Şube verilerinin dosya aracılığıyla yüklenmesi ile ilgili sorularınız kaldıysa bize ulaşın.
XML dosyası formatı
Aktarılan veriler XML formatı özellikleri ile uyumlu olmalıdır.
Genel Koşullar
- XML dosyası UTF-8 kodlamasında oluşturulmalıdır.
Standart XML Başlığı ilk satırdan boş karakterle başlamalıdır.
Örneğin:<?xml version="1.0" encoding="UTF-8"?>
- Kök öğe şu şekilde olmalıdır:
<companies></companies>
- Şubeler, kök öğe içine yerleştirilmiş
company
öğeleri yardımıyla tanımlanır.company
öğe sayısı isteğe bağlı olabilir. Her şube özelliği ayrı bir öğeye sarılmalıdır. Daha fazla bilgi için bkz Öğe açıklaması.
Bu örnekte şu site seçildi:
<url>http://www.anchor.com</url>
- Ana ve ek öğeler, örnek ve öğe açıklaması içeren tablo üzerinde gösterildiği gibi yerleştirilmelidir.
- Aşağıdakiler her şube için mutlaka belirtilmelidir:
- eşsiz ve değiştirilemeyen kimlik tanımlayıcısı:
company-id
öğesi, - ad:
name
öğesi, - binaya kadar kesinliğe sahip tam konum adresi,
- çalışma saatleri:
working-time
öğesi, - site:
url
öğesi, - XML dosyası güncellenme tarihi:
actualization-date
öğesi, - koordinatlar (şubeler için adres kesinliği olmaksızın):
coordinates
öğesi.
Kullanıcıların kurumunuzla ilgili bilgileri netleştirebilmesi için telefon numaranızı
phone
öğesi içinde belirtin.Not. İndeks aktarımı gerekmez. - Bir özellik için birkaç değer varsa (örneğin telefonlar), aynı adlara sahip birkaç öğe aktarılmalıdır.
- Dosyada sadece Öğe açıklaması alt bölümünde belirtilen öğeler aktarılabilir.
Bazı öğeler çok dilli olabilir.
name
,name-other
,address
,country
,address-add
,working-time
öğeleri bunlara dahildir.lang
özelliği aşağıdaki değerleri alabilir:tr
: Türkçeen
: İngilizce
- Kurum ağı ile ilgili bilgilerin eksiksiz olması amacıyla her bir şube için (ek öğeler dahil) maksimum öğe kümesi aktarın.
- Her şube ayrı bir kartta sunulmalıdır; her şube için farklı bir öğe kümesi içeren kendi kimlik tanımlayıcısı belirtilmelidir.
- Verilerde HTML öğeleri olmamalıdır. XML standardında, metin alanlarında 0 ile 31 değer aralığında ASCII kodlarına sahip karakterler geçersizdir. 9, 10, 13 istisnadır: sekme, satır sonu, satır başı. Ayrıca bu standart, katı bir şekilde metindeki bazı karakterleri değiştirmeyi gerektirir:
&
-->&
.
Adres
Tam adresi address
, ülkeyi country
, alışveriş merkezi adı, iş merkezi, ofis numarası ve katını address-add
öğesinde tek satırla belirtin.
<address lang="tr">Barbaros Blv., No:108, Beşiktaş, İstanbul</address>
<country lang="tr">Türkiye</country>
<address-add lang="tr">Papatya AVM, 2. kat, ofis 123</address-add>
Kategori
Bir kategori belirtmek için Yandex Business kategorilerinden tanımlayıcıları kullanın.
Ek parametreler
XML dosyası aracılığıyla ağınız veya şubeniz için ek parametreleri aktarabilirsiniz (örneğin, alışveriş merkezinizin yakınında park yeri olup olmadığını veya ATM'lerinizden hangi para birimlerinde para çekilebileceğini belirtebilirsiniz).
Bu bilgi ek öğeler yardımıyla iletilir. Kategoriniz için olası öğelerin listesini içeren bir XML dosyası almak için:
- Ağ sayfasında Şubeler sekmesine geçin.
- Şube yönetimi bloğunda Dosya sekmesini seçin.
- İşaretleri yükle butonunu tıklayın.
Ek parametrelere sahip dosyanın yüklenmesi ile ilgili sorularınız varsa lütfen partner@sprav.yandex.ru adresine yazın.
XML dosyası örneği
<?xml version="1.0" encoding="UTF-8"?>
<companies>
<company>
<company-id>770704034</company-id>
<name lang="tr">Anchor</name>
<shortname lang="tr">Anchor</shortname>
<address lang="tr">Barbaros Blv., No:108, Beşiktaş, İstanbul</address>
<country lang="tr">Türkiye</country>
<address-add lang="tr">Papatya İş Merkezi, Kat 2, Ofis No.: 203</address-add>
<phone>
<number>+90 (212) 501-23-45</number>
<ext>555</ext>
<info>Sekreter</info>
<type>phone</type>
</phone>
<phone>
<type>phone</type>
<number>+90 (212) 511-23-45</number>
<info />
</phone>
<email>info@anchor.com</email>
<url>http://www.anchor.com</url>
<add-url>http://www.fb.com/anchor</add-url>
<info-page>http://www.anchor.com/branch1/photos</info-page>
<working-time lang="tr">her gün 10:00-21:00</working-time>
<rubric-id>184106414</rubric-id>
<rubric-id>184106394</rubric-id>
<inn>123456789123</inn>
<ogrn>9876543219876</ogrn>
<actualization-date>1511724300</actualization-date>
<photos gallery-url="http://test.com/anchor/gallery">
<photo url="http://test.com/anchor/11_b.jpg" alt="Hotel Restaurant" type="interior" />
<photo url="http://test.com/anchor/19_b.jpg" type="exterior" />
<photo url="http://test.com/anchor/25_b.jpg" />
<photo url="http://test.com/anchor/26_b.jpg" />
<photo url="http://test.com/anchor/17_b.jpg" />
<photo url="http://test.com/anchor/drink1.jpg" alt="Cocktail in the hotel bar" type="food" />
</photos>
<feature-boolean name="internet" value="1" />
<feature-enum-single name="star" value="five" />
<feature-numeric-single name="room_number" value="15" />
<feature-enum-multiple name="hotel_type" value="art_hotel" />
<feature-text-single value="anchor_free_wi-fi" name="ssid" />
</company>
</companies>
Öğe açıklaması
İsim | Açıklama | Örnek |
---|---|---|
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. | |
name | Şube adı. Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Çok dilli öğe. | |
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. Çok dilli öğe. | |
name-other | Şubenin alternatif adı (birden fazla adı varsa her biri ayrı bir öğe içinde belirtilir). Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Çok dilli öğe. | |
address | Şube adresi (tek satırla). Çok dilli öğe. Not. Öğe sadece sokak adı ve ev numarası içeriyorsa kesinlikle yerleşim yeri belirtilerek locality-name öğesi kullanılmalıdır. | |
country | Ülke. Kısaltmasız tam olarak belirtilir. Çok dilli öğe. | |
address-add | Diğer öğelerle ilintili olmayan bir adrese ek bilgi. Parantez, tırnak işareti olmadan belirtilir. Çok dilli öğe. | |
coordinates | Bileşik öğe. Enlem ve boylam koordinatları. | |
lon | Boylam koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır. | |
lat | Enlem koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır. | |
phone | Bileşik öğe. Telefon numarası (birden fazla numara varsa her biri ayrı bir öğe içinde belirtilir). | |
number | Sabit hat veya cep telefonu numarası. Şu biçimde belirtilir: [ülke kodu] ([şehir kodu]) [telefon numarası]. | |
ext | Dahili numara (açıklama, sözcük ve ayırıcılar olmadan). | |
info | Numara hakkında bilgi: örneğin, yönetmen, sekreter. Not. Bu öğede telefon türü hakkında bilgi olmamalıdır. | |
type | Telefon türü. Üç değerden birini alır:
| |
E-posta | E-posta adresi (adresler birden fazla ise her biri ayrı bir öğe içinde belirtilir). | |
url | Ağın ana sitesi. http:// veya https://dahil olmak üzere tamamen küçük harfle belirtilir. | |
add-url | Ek ağ sitesi (örneğin, sosyal medya bağlantıları). Not. Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi info-page öğesi içinde gösterilir. | |
info-page | Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi. http:// veya https://dahil olmak üzere tamamen küçük harfle belirtilir. Not. Adres ağ sitesinin alan adının içermelidir. | |
working-time | Çalışma saatleri. Hafta sonu, çalışılmayan günler belirtilmez. Çok dilli öğe. Not. Haftanın günleri nasıl yazılır:
| Öğle yemeği: Öğle arası: 24 saat: |
rubric-id | Bu şubenin ait olduğu kategori kimlik tanımlayıcısı (kategori birden fazla ise her biri ayrı bir öğe içinde belirtilir). Not. Her şubenin en fazla üç kategorisi olabilir, fakat en az bir tanesi ağ kategorisiyle aynı olmalıdır. | |
inn | Kurum vergi kimlik no | |
ogrn | Kurum ticari sicil no | |
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:
| |
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
| |
tag | Fotoğraf etiketi. Aşağıdaki değerlerden birini alır:
| |
Ek öğeler | ||
feature-boolean | Şube özelliği. 1 ("Evet") veya 0 ("hayır") olmak üzere iki değer alabilir. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Şubede Wi-Fi ağı var: |
feature-enum-single | Şube özelliği. | Tiyatro türü - absürd tiyatro: |
feature-enum-multiple | Şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Tur türü - otobüs turu: |
feature-numeric-single | Sayısal değerler içeren şube özelliği. | Şubede üç televizyon var: |
feature-numeric-multiple | Sayısal değerler içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Lisans numarası: |
feature-in-units-single | Değeri ölçü birimlerinde belirlenen şube özelliği. | Minimum teslimat tutarı 15 TL'dir: |
feature-in-units-multiple | Değeri ölçü birimlerinde belirlenen şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Otelde 200 tek kişilik oda vardır: |
feature-range-single | Sayı aralık değeri içeren şube özelliği. | Şubede 15-20 kişilik bir ziyafet salonu var: |
feature-range-multiple | Sayı aralık değeri içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Bilet fiyatları 40-60 TL arasındadır: |
feature-in-units-single | Ölçü birimlerinde aralık değeri içeren şube özelliği. | Bir dakikalık maliyet 3-6 TL'dir: |
feature-in-units-multiple | Ölçü birimlerinde aralık değeri içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Stil içeren kadın saç kesim fiyatı 100-200 TL arasındadır. |
feature-text-single | Metin biçiminde şube özelliği. | ANCOR Otel'deki ücretsiz Wi-Fi kullanıcı adı: “ssid” |
İsim | Açıklama | Örnek |
---|---|---|
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. | |
name | Şube adı. Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Çok dilli öğe. | |
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. Çok dilli öğe. | |
name-other | Şubenin alternatif adı (birden fazla adı varsa her biri ayrı bir öğe içinde belirtilir). Tırnak işareti olmadan, büyük/küçük harf dikkate alınarak belirtilir. Çok dilli öğe. | |
address | Şube adresi (tek satırla). Çok dilli öğe. Not. Öğe sadece sokak adı ve ev numarası içeriyorsa kesinlikle yerleşim yeri belirtilerek locality-name öğesi kullanılmalıdır. | |
country | Ülke. Kısaltmasız tam olarak belirtilir. Çok dilli öğe. | |
address-add | Diğer öğelerle ilintili olmayan bir adrese ek bilgi. Parantez, tırnak işareti olmadan belirtilir. Çok dilli öğe. | |
coordinates | Bileşik öğe. Enlem ve boylam koordinatları. | |
lon | Boylam koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır. | |
lat | Enlem koordinatı. Tam ve ondalık kısmı ayırmak için nokta kullanılır. | |
phone | Bileşik öğe. Telefon numarası (birden fazla numara varsa her biri ayrı bir öğe içinde belirtilir). | |
number | Sabit hat veya cep telefonu numarası. Şu biçimde belirtilir: [ülke kodu] ([şehir kodu]) [telefon numarası]. | |
ext | Dahili numara (açıklama, sözcük ve ayırıcılar olmadan). | |
info | Numara hakkında bilgi: örneğin, yönetmen, sekreter. Not. Bu öğede telefon türü hakkında bilgi olmamalıdır. | |
type | Telefon türü. Üç değerden birini alır:
| |
E-posta | E-posta adresi (adresler birden fazla ise her biri ayrı bir öğe içinde belirtilir). | |
url | Ağın ana sitesi. http:// veya https://dahil olmak üzere tamamen küçük harfle belirtilir. | |
add-url | Ek ağ sitesi (örneğin, sosyal medya bağlantıları). Not. Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi info-page öğesi içinde gösterilir. | |
info-page | Ağ sitesinde şube hakkında bilgi içeren sayfanın adresi. http:// veya https://dahil olmak üzere tamamen küçük harfle belirtilir. Not. Adres ağ sitesinin alan adının içermelidir. | |
working-time | Çalışma saatleri. Hafta sonu, çalışılmayan günler belirtilmez. Çok dilli öğe. Not. Haftanın günleri nasıl yazılır:
| Öğle yemeği: Öğle arası: 24 saat: |
rubric-id | Bu şubenin ait olduğu kategori kimlik tanımlayıcısı (kategori birden fazla ise her biri ayrı bir öğe içinde belirtilir). Not. Her şubenin en fazla üç kategorisi olabilir, fakat en az bir tanesi ağ kategorisiyle aynı olmalıdır. | |
inn | Kurum vergi kimlik no | |
ogrn | Kurum ticari sicil no | |
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:
| |
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
| |
tag | Fotoğraf etiketi. Aşağıdaki değerlerden birini alır:
| |
Ek öğeler | ||
feature-boolean | Şube özelliği. 1 ("Evet") veya 0 ("hayır") olmak üzere iki değer alabilir. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Şubede Wi-Fi ağı var: |
feature-enum-single | Şube özelliği. | Tiyatro türü - absürd tiyatro: |
feature-enum-multiple | Şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Tur türü - otobüs turu: |
feature-numeric-single | Sayısal değerler içeren şube özelliği. | Şubede üç televizyon var: |
feature-numeric-multiple | Sayısal değerler içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Lisans numarası: |
feature-in-units-single | Değeri ölçü birimlerinde belirlenen şube özelliği. | Minimum teslimat tutarı 15 TL'dir: |
feature-in-units-multiple | Değeri ölçü birimlerinde belirlenen şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Otelde 200 tek kişilik oda vardır: |
feature-range-single | Sayı aralık değeri içeren şube özelliği. | Şubede 15-20 kişilik bir ziyafet salonu var: |
feature-range-multiple | Sayı aralık değeri içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Bilet fiyatları 40-60 TL arasındadır: |
feature-in-units-single | Ölçü birimlerinde aralık değeri içeren şube özelliği. | Bir dakikalık maliyet 3-6 TL'dir: |
feature-in-units-multiple | Ölçü birimlerinde aralık değeri içeren şube özelliği. Özellikler birden fazla ise her biri ayrı bir öğe içinde belirtilir. | Stil içeren kadın saç kesim fiyatı 100-200 TL arasındadır. |
feature-text-single | Metin biçiminde şube özelliği. | ANCOR Otel'deki ücretsiz Wi-Fi kullanıcı adı: “ssid” |