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'ın nasıl kullanılacağı açıklanır ve kullanmayı planladığınız ilgili feed için uygun kılavuza bağlantılar sağlanır.
Genel dropbox, iki ayrı yükleme olmasını temel alır:
- Açıklayıcı dosyası: Yükleyeceğiniz feed türünü açıklar.
- Feed dosyaları: gerçek feed'in içeriği
Açıklayıcı alanını yapılandırma
Açıklayıcı dosya, yüklediğiniz feed türünü sistemimize bildirmek için yüklenir. Bu sayede feed'i doğrulayıp doğru şekilde işleyebiliriz. Açıklayıcı dosya, feed içeriklerinden önce yüklenmeli ve şu adlandırma gereksinimlerine uymalıdır:
- .filesetdesc.json dosya uzantısını kullanın
- Açıklayıcı dosya adlarının her biri benzersiz olmalıdır ve yüklemelerde yeniden kullanılamaz. Oluşturma zaman damgasını dosya adına eklemenizi öneririz.
- Örnek: offer_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:
- reservewithgoogle.conversion_data
İki parçalı teklif feed'i için örnek bir 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ı dosyayı yükledikten sonra, açıklayıcı dosyanız tarafından adlandırılmış feed yapılandırma dosyasına karşılık gelen feed veri türüne ilişkin tüm feed dosyalarını yüklersiniz. Dosya adları ve yol konumları (Dropbox'taki göreli), data_file alanında belirtilenlerle tam olarak eşleşmelidir. Eksik, yanlış bir şekilde adlandırılmış veya farklı bir konuma yüklenmiş bir dosya varsa feed'in tamamı işlenmez.
Bu feed veri dosyalarının içeriği, feed'in açıklayıcı dosyasında belirtilen ilgili spesifikasyonuna uygun olmalıdır.
Her feed dosyası dosya adı benzersiz olmalıdır ve yüklemelerde yeniden kullanılamaz. Dosya adına oluşturma zaman damgasını ve parça numarasını (artımlı kimlik) eklemenizi öneririz.
- Örnek: offer_1524606581_1.json
Feed dosya boyutları ve yükleme sıklığı
- Feed dosyasının boyutunu 200 MB'tan küçük tutun (sıkıştırma işleminden sonra).
- Çoğu entegrasyonun yalnızca tek bir parça kullanması gerekir. 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 bağımsız kayıtların gelecek feed'lerde aynı parça numarası içinde gönderilmesi gerekmez.
- Daha iyi performans için verileri parçalar arasında eşit bir şekilde bölerek tüm parça dosyalarının benzer boyutta olmasını sağlayın.
- Gerekirse feed'leri sıkıştırmak için gzip kullanın. Ancak bu işlemi her bir feed parçası için ayrı ayrı 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ı'nda 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ütununa açıklayıcı dosyaya girdiğiniz name olup olmadığına bakın.
Feed beslendikten sonra (durum Success veya Fail) hata ve uyarıların ayrıntılarını görmek için feed'in satırını tıklayabilirsiniz.