Genel feed dropbox'ını kullanma

Genel feed dropbox'ı, ortam başına tek bir dropbox'a birden fazla feed türünün yüklenmesine olanak tanır. Bu kılavuzda, genel Dropbox'un nasıl kullanılacağı ele alınmakta ve kullanmak istediğiniz feed'e ait uygun kılavuzların bağlantıları sağlanmaktadır.

Genel Dropbox, iki ayrı yükleme yapılmasını gerektirir:

1. Tanımlayıcı dosya: Yükleyeceğiniz feed türünü açıklar
2. Feed dosyaları: Gerçek feed'in içeriği

Açıklayıcı alanını yapılandırma

Tanımlayıcı dosyası, sistemimizi yüklediğiniz feed türüyle ilgili bilgilendirmek 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ını karşılamalı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ıdır 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ı dosyası, 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çaya ayrılmış bir teklif feed'i için örnek bir 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

Tanımlayıcı dosyasını yükledikten sonra, tanımlayıcınız tarafından adlandırılan 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ı (dropbox'a göre göreli), data_file alanına eklenmiş dosya adları ve yol konumlarıyla tam olarak eşleşmelidir. Eksik, yanlış adlandırılmış veya farklı bir konuma yüklenen dosyalar varsa feed'in tamamı işlenmez.

Bu feed veri dosyalarının içerikleri, tanımlayıcı dosyasında belirtilen feed'in ilgili spesifikasyonuna uygun olmalıdır.

Her feed dosyası adı benzersiz olmalıdır ve yüklemelerde yeniden kullanılamaz. Dosya adına oluşturma zaman damgasını ve parça numarasını (artan kimlik) eklemenizi öneririz.

• Örnek: offers_1524606581_1.json

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

• Feed dosyası boyutunu 200 MB'ın altında tutun (sıkıştırıldıktan sonra).
• Sıkıştırılmamış her veri dosyasının boyutu 2 GB'tan küçük olmalıdır.
• Çoğu entegrasyon için tek bir parçanın kullanılması yeterlidir. Mümkün olduğunca az parça kullanmanız gerekir. Feed başına maksimum 1.000 parça vardır.
• Bir parçada gönderilen bağımsız kayıtların, gelecekteki feed'lerde aynı parça numarasında gönderilmesi gerekmez.
• Daha iyi performans için verileri parçalar arasında eşit şekilde bölün. Böylece tüm parça dosyalarının boyutu benzer olur.
• Gerekirse feed'leri sıkıştırmak için gzip kullanın. Ancak bunu her feed kırıntısıyla ilgili olarak yapın.

Sorun giderme ve hata ayıklama

Dosyalarınızı (tanımlayıcı ve feed dosyaları) yükledikten sonra, feed beslemenizin ilerleme durumunu takip etmek için İş Ortağı Portalı'ndaki Feed Geçmişi kontrol paneline (dokümanlar) gidin (Geçmiş > Feed'ler'e gidin).

Feed'inizi bulmak için tanımlayıcı dosyasına girdiğiniz name değerini "Feed adı" sütununda bulun.

Feed beslendikten sonra (durum Success veya Fail ise) hataların ve uyarıların ayrıntılarını görmek için feed'in satırını tıklayabilirsiniz.