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

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

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

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

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

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

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

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

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

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

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

फ़ीड डालने के बाद (स्टेटस Success या Fail है), आपके पास इस पर क्लिक करने का विकल्प है इसकी लाइन में मौजूद सभी गड़बड़ियां और चेतावनियों की जानकारी देखी जा सकती है.