Genel feed dropbox'ı, ortam başına birden fazla feed türünün tek bir dropbox'a yüklenmesine olanak tanır. Bu kılavuzda, genel dropbox'ın nasıl kullanılacağı ayrıntılı olarak açıklanır. Ayrıca, kullanmayı planladığınız feed'e uygun kılavuzun bağlantıları sağlanır.
(Belgelerin Feed'leri (uçtan uca aktarma) veya Feed'ler (başlangıç) bölümüne bakın).Genel dropbox'ta iki ayrı yükleme olması gerekir:
- Açıklayıcı dosya: Yükleyeceğiniz feed türünü açıklar.
- Feed dosyaları: Gerçek feed'in içeriği
Açıklayıcı alanı yapılandırma
Açıklayıcı dosya, sistemimize yüklediğiniz feed türünü bildirmek için yüklenir. Bu sayede feed'i doğru şekilde işleyebilir ve işleyebiliriz. Açıklayıcı dosya, feed içeriğinden önce yüklenmeli ve aşağıdaki adlandırma gereksinimlerine uymalıdır:
- .filesetdesc.json dosya uzantısını kullan
- Her açıklayıcı dosya adı benzersiz olmalı ve yüklemelerde tekrar kullanılmamalıdır. Dosya adına, oluşturma zaman damgasını eklemenizi öneririz.
- Örnek: offers_1524606581.filesetdesc.json
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ça içeren bir teklif özet akışı için örnek JSON açıklayı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 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'ta göreli olarak) data_file alanındakilerle tam olarak eşleşmelidir. Eksik veya yanlış adlandırılmış ya da farklı bir konuma yüklenmiş dosyalar varsa feed'in tamamı işlenmez.
Bu feed veri dosyalarının içeriği, açıklayıcı dosyada belirtilen feed'in ilgili spesifikasyonlarına uygun olmalıdır.
Her feed dosya adı benzersiz olmalıdır ve yüklemelerde tekrar kullanılamaz. Dosya adına, oluşturma zaman damgasını ve parça numarasını (ek 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).
- Çoğu entegrasyonda yalnızca tek bir kırık kullanılması gerekir. Olabildiğince az parça kullanmanız gerekir. Feed başına maksimum 1.000 parça bulunur.
- Bir parçada gönderilen bireysel kayıtların sonraki feed'lerde aynı parça numarasında gönderilmesi gerekmez.
- Daha iyi performans için verileri tüm kırıkların boyutunu benzer hale getirmek üzere kırıklar arasında eşit bir şekilde bölebilirsiniz.
- Feed'leri sıkıştırmak için gerekirse gzip'i kullanın. Ancak her feed kırığı için bunu yapın.
Sorun giderme ve hata ayıklama
Dosyalarınızı (açıklayı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 bölümüne gidin).
Feed'inizi bulmak için "Feed adı" sütunundaki tanımlayıcı dosyasında girdiğiniz name bilgisini arayın.
Feed beslendikten sonra (durum Success veya Fail) satırını tıklayarak hataların ve uyarıların ayrıntılarını görebilirsiniz.