Genel SFTP sunucusunu kullanma

Genel feed SFTP sunucusu, ortam başına tek bir SFTP sunucusuna birden fazla feed türünün yüklenmesine olanak tanır. Bu kılavuzda, genel SFTP sunucusunun nasıl kullanılacağı açıklanmakta ve kullanmayı planladığınız feed'e uygun kılavuzun bağlantıları verilmektedir.

(Lütfen dokümanların Feed'leri Dışa Aktarma (uçtan uca) veya Feed'ler (başlangıç) bölümüne bakın).

Genel SFTP sunucusu, iki ayrı yüklemenin olmasını gerektirir:

  1. Açıklama dosyası: Yükleyeceğiniz feed türünü açıklar.
  2. Feed dosyaları: Gerçek feed'in içeriği

Açıklama alanı yapılandırması

Açıklama dosyası, sistemimize hangi feed türünü yüklediğinizi bildirmek için yüklenir. Bu sayede feed'i doğru şekilde doğrulayabilir ve işleyebiliriz. Açıklayıcı dosya, feed içeriklerinden önce yüklenmeli ve aşağıdaki adlandırma koşullarına uymalıdır:

  • Tanımlayıcı dosyası için .filesetdesc.json dosya uzantısını kullanmanız gerekir.
  • Her tanımlayıcı dosya adı benzersiz olmalı ve yüklemeler arasında yeniden kullanılamaz. Dosya adına oluşturma zaman damgasını ve feed adını eklemenizi öneririz.
    • Örnek: offers_1524606581.filesetdesc.json
  • Her tanımlayıcı dosya, ilgili feed adı için en son feed'deki tüm veri dosyalarını listelemelidir.
message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

name alanı için olası değerler şunlardır:

İki parçalı bir fırsat feed'i için örnek JSON tanımlayıcı dosyası aşağıda verilmiştir:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

Feed içeriğini yapılandırma

Açıklayıcı dosyasını yükledikten sonra, açıklayıcı dosyanızın adını taşıyan feed yapılandırma dosyasına karşılık gelen feed veri türü için tüm feed dosyalarını yüklersiniz. Dosya adları ve yol konumları (SFTP sunucusunda göreli olarak) data_file alanında yer alanlarla tam olarak eşleşmelidir. Eksik, yanlış adlandırılmış veya farklı bir konuma yüklenmiş bir dosya varsa feed'in tamamı işlenmez.

Bu feed verileri dosyalarının içeriği, açıklama dosyasında belirtilen feed'in ilgili spesifikasyonuna uygun olmalıdır.

Her feed dosyası adı benzersiz olmalı ve yüklemeler arasında yeniden kullanılamamalıdır. Dosya adına oluşturma zaman damgasını ve parça numarasını (artımlı kimlik) eklemenizi öneririz.

  • Örnek: offers_1524606581_1.json

Feed dosyası boyutları ve yükleme sıklığı

  • Feed dosyası boyutunu 200 MB'ın altında tutun (sıkıştırmadan sonra).
  • Sıkıştırılmamış her veri dosyasının boyutu 2 GB'tan küçük olmalıdır.
  • Çoğu entegrasyon yalnızca tek bir parça kullanmalıdır. Mümkün olduğunca az parça kullanmalısınız. Feed başına en fazla 1.000 parça olabilir.
  • Tek bir parçada gönderilen ayrı kayıtların gelecekteki feed'lerde aynı parça numarasıyla gönderilmesi gerekmez.
  • Daha iyi performans için, tüm parça dosyalarının boyutunun benzer olması amacıyla verileri parçalar arasında eşit şekilde bölün.
  • Gerekirse feed'leri sıkıştırmak için gzip'i kullanın. Ancak bunu her bir feed parçası için yapın.

Sorun giderme ve hata ayıklama

Dosyalarınızı (açıklama ve feed dosyaları) yükledikten sonra, feed alımınızın ilerleme durumunu takip etmek için İş Ortağı Portalı'ndaki Alım Görüntüleyici'ye (belgeler) gidin (Alım > Geçmiş'e gidin).

Feed'inizi bulmak için "Feed adı" sütununda açıklama dosyasına girdiğiniz name simgesini arayın.

Feed alındıktan sonra (durum Success veya Fail) hataların ve uyarıların ayrıntılarını görmek için satırını tıklayabilirsiniz.