सामान्य फ़ीड ड्रॉपबॉक्स का इस्तेमाल करना

जेनेरिक फ़ीड ड्रॉपबॉक्स की मदद से हर एनवायरमेंट के लिए सिंगल ड्रॉपबॉक्स. इस गाइड में आपको 'वेब और ऐप्लिकेशन गतिविधि' के जेनरिक ड्रॉपबॉक्स और उन किताबों के लिए सही गाइड के लिंक दें वह फ़ीड चुनें जिसका इस्तेमाल करना है.

(कृपया दस्तावेज़ के, फ़ीड (पूरी तरह खत्म) या फ़ीड (शुरुआती) सेक्शन को एक्सपोर्ट करना).

जेनेरिक ड्रॉपबॉक्स दो अलग-अलग अपलोड पर निर्भर करता है:

  1. जानकारी वाली फ़ाइल: इससे पता चलता है कि आपका फ़ीड किस तरह का होगा अपलोड हो रही है
  2. फ़ीड की फ़ाइलें: असल फ़ीड का कॉन्टेंट

डिस्क्रिप्टर फ़ील्ड को स्ट्रक्चर करना

डिस्क्रिप्टर फ़ाइल को अपलोड करके, हमारे सिस्टम को यह बताया जाता है कि आपका फ़ीड किस तरह का है अपलोड कर रहे हैं. इससे हम फ़ीड की सही तरीके से पुष्टि और प्रोसेस कर पाते हैं. कॉन्टेंट बनाने डिस्क्रिप्टर फ़ाइल को फ़ीड के कॉन्टेंट से पहले अपलोड किया जाना चाहिए और उसे नाम रखने की ये ज़रूरी शर्तें:

  • .filesetdesc.json फ़ाइल एक्सटेंशन का इस्तेमाल करें
  • हर डिस्क्रिप्टर फ़ाइल का नाम यूनीक होना चाहिए. साथ ही, उसे सभी अपलोड में फिर से इस्तेमाल नहीं किया जा सकता. बुध फ़ाइल के नाम में जनरेशन टाइमस्टैंप शामिल करने का सुझाव दें.
    • उदाहरण: 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 फ़ील्ड के लिए संभावित वैल्यू में ये शामिल हैं:

दो शार्ड वाले ऑफ़र फ़ीड के लिए JSON डिस्क्रिप्टर फ़ाइल का उदाहरण यहां उपलब्ध है:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

फ़ीड के कॉन्टेंट के बारे में जानकारी देना

डिस्क्रिप्टर फ़ाइल अपलोड करने के बाद, आपको सभी फ़ीड फ़ाइलें अपलोड करनी होंगी की ओर से नाम दी गई फ़ीड कॉन्फ़िगरेशन फ़ाइल से संबंधित फ़ीड डेटा प्रकार के लिए आपकी डिस्क्रिप्टर फ़ाइल. फ़ाइल के नाम और पाथ की लोकेशन (ये जगहें ड्रॉपबॉक्स) का नाम data_file फ़ील्ड. अगर कोई फ़ाइल मौजूद नहीं है, उसका नाम गलत है या किसी दूसरे स्थान पर अपलोड किए जाते हैं, तो पूरा फ़ीड प्रोसेस किया गया.

इन फ़ीड डेटा फ़ाइलों का कॉन्टेंट, वह फ़ीड जिसे डिस्क्रिप्टर फ़ाइल में दिया गया था.

हर फ़ीड फ़ाइल का फ़ाइल नाम अलग होना चाहिए. साथ ही, सभी अपलोड के लिए, इसका इस्तेमाल दोबारा नहीं किया जा सकता. हमारा सुझाव है कि आप: इसमें फ़ाइल नाम में जनरेशन टाइमस्टैंप और शार्ड नंबर (इंक्रीमेंटल आईडी) शामिल है.

  • उदाहरण: Offers_1524606581_1.json

फ़ीड की फ़ाइल का साइज़ और अपलोड करने की फ़्रीक्वेंसी

  • फ़ीड की फ़ाइल का साइज़ 200 एमबी से कम रखें (कंप्रेशन के बाद).
  • ज़्यादातर इंटिग्रेशन के लिए सिर्फ़ एक शार्ड का इस्तेमाल करना होगा. आपको इस रूप में इस्तेमाल करना चाहिए कम से कम शार्ड डालें. हर फ़ीड में ज़्यादा से ज़्यादा 1,000 शार्ड हो सकते हैं.
  • एक शार्ड में भेजे गए अलग-अलग रिकॉर्ड को एक ही शार्ड में भेजने की आवश्यकता नहीं है शार्ड नंबर की ज़रूरत पड़ेगी.
  • बेहतर प्रदर्शन के लिए, डेटा को शार्ड के बीच समान रूप से विभाजित करें, ताकि सभी शार्ड फ़ाइलों का आकार एक जैसा होता है.
  • अगर ज़रूरी हो, तो फ़ीड कंप्रेस करने के लिए gzip का इस्तेमाल करें. हालांकि, प्रत्येक खाते के लिए ऐसा ही करें अलग-अलग फ़ीड शार्ड.

समस्या का हल और डीबग करना

अपनी फ़ाइलें (डिस्क्रिप्टर और फ़ीड फ़ाइलें) अपलोड करने के बाद, फ़ीड के इतिहास का डैशबोर्ड (दस्तावेज़) फ़ीड जोड़ने की प्रोग्रेस को फ़ॉलो करने के लिए, पार्टनर पोर्टल पर जाएं (इतिहास > फ़ीड पर जाएं).

वह name खोजें जिसे आपने "फ़ीड के नाम" की डिस्क्रिप्टर फ़ाइल में डाला है कॉलम पर क्लिक करें.

फ़ीड डालने के बाद (स्टेटस Success या Fail है), आपके पास इस पर क्लिक करने का विकल्प है इसकी पंक्ति पर क्लिक करें.