Genel feed dropbox'ını kullanma

Genel feed dropbox'ı, birden fazla feed türünün bir . 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.

(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 dropbox için iki ayrı yükleme yapılır:

  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 açıklayıcı dosya adı benzersiz olmalıdır ve yüklemelerde yeniden kullanılamaz. Dosya adına, oluşturma zaman damgasını ve feed adını eklemenizi öneririz.
    • Örnek: offer_1524606581.filesetdesc.json
  • Her açıklayı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ç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

Açıklayıcı dosyasını yükledikten sonra tüm feed dosyalarını yüklersiniz. adlı feed yapılandırma dosyasına karşılık gelen feed veri türü için açıklayıcı dosyanız olur. Dosya adları ve yol konumları ( dropbox'ının), içerdiği ek bilgilerle tam olarak eşleşmesi gerekir data_file alanı boş bırakılamaz. Eksik, yanlış adlandırılmış veya farklı bir konuma yüklenirse feed'in tamamı işlendi.

Bu feed veri dosyalarının içeriği, tanımlayıcı dosyasında belirtilen feed'i destekler.

Her feed dosyasının adı benzersiz olmalıdır ve yüklemelerde yeniden kullanılamaz. Önerilerimiz: oluşturma zaman damgası ve parça numarası (artımlı kimlik) dahil.

  • Ö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 entegrasyonun yalnızca tek bir parçayı kullanması gerekir. 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 olarak 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 bu işlemi her için de geçerli.

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.