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

सामान्य फ़ीड ड्रॉपबॉक्स की मदद से, हर एनवायरमेंट के लिए एक ही ड्रॉपबॉक्स में कई तरह के फ़ीड अपलोड किए जा सकते हैं. इस गाइड में, सामान्य तौर पर इस्तेमाल होने वाले ड्रॉपबॉक्स का इस्तेमाल करने का तरीका बताया गया है. साथ ही, उस फ़ीड के लिए सही गाइड के लिंक भी दिए गए हैं जिसका इस्तेमाल करना है.

चेतावनी: यह गाइड, व्यापारियों/कंपनियों/कारोबारियों, सेवाओं या उपलब्धता के ड्रॉपबॉक्स पर लागू नहीं होती. यह सिर्फ़ सामान्य ड्रॉपबॉक्स पर लागू होता है.

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

ध्यान दें: आपको हर उस फ़ीड टाइप के लिए अनुमति लेनी होगी जिसे अपलोड करना है. अगर आपने ऐसा फ़ीड टाइप अपलोड किया है जिसे आपके इंटिग्रेशन के लिए मंज़ूरी नहीं मिली है, तो फ़ीड को प्रोसेस नहीं किया जाएगा. अगर आपको नहीं पता कि आपके इंटिग्रेशन पर कौनसे फ़ीड टाइप लागू होते हैं, तो कृपया अपने ऐक्शन सेंटर के संपर्क से संपर्क करें.

चेतावनी: सामान्य फ़ीड के ड्रॉपबॉक्स में अपलोड करने की सुविधा चालू करने के लिए, आपको अपनी एसएसएच पासकोड को रीसेट करना पड़ सकता है. ऐसा करने के लिए, कृपया पार्टनर पोर्टल के फ़ीड कॉन्फ़िगरेशन (दस्तावेज़) देखें.

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

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 एमबी से कम रखें.
• बिना कंप्रेस की गई हर डेटा फ़ाइल का साइज़ 2 जीबी से कम होना चाहिए.
• ज़्यादातर इंटिग्रेशन के लिए, सिर्फ़ एक ही शार्ड का इस्तेमाल करना होगा. आपको कम से कम shaर्ड का इस्तेमाल करना चाहिए. हर फ़ीड में ज़्यादा से ज़्यादा 1,000 शार्ड हो सकते हैं.
• एक ही स्hard में भेजे गए अलग-अलग रिकॉर्ड को, आने वाले समय में भेजे जाने वाले फ़ीड में उसी स्hard नंबर में भेजने की ज़रूरत नहीं है.
• बेहतर परफ़ॉर्मेंस के लिए, डेटा को शार्ड में बराबर-बराबर बांटें, ताकि सभी शार्ड फ़ाइलों का साइज़ एक जैसा हो.
• अगर ज़रूरी हो, तो फ़ीड को कंप्रेस करने के लिए gzip का इस्तेमाल करें. हालांकि, ऐसा हर फ़ीड के लिए करें अलग-अलग शर्ड.

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

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

अपना फ़ीड ढूंढने के लिए, "फ़ीड का नाम" कॉलम में, डिस्क्रिप्टर फ़ाइल में डाला गया name देखें.

फ़ीड को डालने के बाद (स्थिति Success या Fail), गड़बड़ियों और चेतावनियों की जानकारी देखने के लिए, उसकी पंक्ति पर क्लिक किया जा सकता है.