Genel feed dropbox'ını kullanma

Genel feed dropbox'ı, birden fazla feed türünün bir . Bu kılavuzda, genel dropbox'a ekleyin ve ilgili feed'i seçin.

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

ziyaret edin.

Genel dropbox için iki ayrı yükleme yapılır:

  1. Açıklayıcı dosyası: Hangi feed türünü yapacağınızı açıklar. yükleniyor
  2. Feed dosyaları: Gerçek feed'in içeriği
ziyaret edin.

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

Tanımlayıcı dosyası, hangi feed türünü kullandığınızı sistemimize bildirmek için yüklenir. yükleniyor. Bu sayede feed'i doğru şekilde doğrulayabilir ve işleyebiliriz. İlgili içeriği oluşturmak için kullanılan açıklayıcı dosya, feed içeriklerinden önce yüklenmeli ve şu adlandırma gereksinimlerini belirtin:

  • .filesetdesc.json dosya uzantısını kullanın
  • Her açıklayıcı dosya adı benzersiz olmalıdır ve yüklemelerde yeniden kullanılamaz. Biz dosya adına oluşturma zaman damgasının eklenmesi önerilir.
    • Ö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:

İki parçalı bir teklif feed'i için örnek JSON açıklayıcı dosyası aşağıda bulabilirsiniz:

{
  "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) içerdiği e-posta adresiyle tam olarak eşleşmelidir. 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: offer_1524606581_1.json

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

  • Feed dosya boyutunu 200 MB'tan az (sıkıştırmadan sonra) tutun.
  • Çoğu entegrasyonun yalnızca tek bir parçayı kullanması gerekir. Belirttiğiniz URL'yi parçalamanız gerekir. Feed başına maksimum 1.000 parça vardır.
  • Bir kırıkta gönderilen kayıtların aynı parça numarasını ekleyebilirsiniz.
  • Daha iyi performans için verileri parçalar arasında eşit bir şekilde bölerek benzer bir boyuta sahip kırık dosyaları oluşturabilirsiniz.
  • Gerekirse feed'leri sıkıştırmak için gzip uygulamasını kullanın. Ancak bu işlemi her için de geçerli.

Sorun giderme ve hata ayıklama

Dosyalarınızı (açıklayıcı ve feed dosyaları) yükledikten sonra Feed Geçmişi kontrol paneli (belgeler) Feed beslemenizin ilerleme durumunu takip etmek için İş Ortağı Portalı'nda (Geçmiş > Feed'ler'e gidin).

"Feed adı" bölümündeki açıklayıcı dosyaya girdiğiniz name değerini bulun sütunundan feed'inizi bulun.

Feed beslendikten sonra (durum Success veya Fail olduğunda) kontrol ederek hataları ve uyarıların ayrıntılarını görebilirsiniz.