जेनरिक फ़ीड ड्रॉपबॉक्स की मदद से, हर एनवायरमेंट में एक ही ड्रॉपबॉक्स पर कई तरह के फ़ीड अपलोड किए जा सकते हैं. इस गाइड में आपको जेनरिक ड्रॉपबॉक्स इस्तेमाल करने के तरीके के बारे में जानकारी मिलेगी. साथ ही, इसमें आपको उस फ़ीड के लिए सही गाइड के लिंक भी मिलेंगे जिसका इस्तेमाल करना है.
जेनरिक ड्रॉपबॉक्स दो अलग-अलग अपलोड होने पर निर्भर करता है:
- जानकारी देने वाली फ़ाइल: इससे पता चलता है कि आपको किस तरह का फ़ीड अपलोड करना है
- फ़ीड की फ़ाइल(फ़ाइलें): असल फ़ीड का कॉन्टेंट
डिस्क्रिप्टर फ़ील्ड बनाना
डिस्क्रिप्टर फ़ाइल को इसलिए अपलोड किया जाता है, ताकि हमारे सिस्टम को यह पता चल सके कि आपको किस तरह का फ़ीड अपलोड करना है. इससे हमें फ़ीड की पुष्टि करने और उसे सही तरीके से प्रोसेस करने में मदद मिलती है. डिस्क्रिप्टर वाली फ़ाइल को फ़ीड के कॉन्टेंट से पहले अपलोड किया जाना चाहिए. साथ ही, उसे नाम रखने की इन ज़रूरी शर्तों का पालन करना चाहिए:
- .filesetdes.json फ़ाइल एक्सटेंशन का इस्तेमाल करें
- हर डिस्क्रिप्टर फ़ाइल का नाम यूनीक होना चाहिए. साथ ही, इसे सभी अपलोड में फिर से इस्तेमाल नहीं किया जा सकता. हमारा सुझाव है कि फ़ाइल के नाम में, जनरेट होने का टाइमस्टैंप शामिल करें.
- उदाहरण: Offer_1524606581.filesetdec.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 फ़ील्ड के लिए संभावित वैल्यू में ये शामिल हैं:
- reservewithgoogle.conversion_data
दो शार्ड वाले ऑफ़र फ़ीड के लिए, JSON डिस्क्रिप्टर फ़ाइल का उदाहरण नीचे दिया गया है:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}
फ़ीड का कॉन्टेंट तैयार करना
डिस्क्रिप्टर फ़ाइल अपलोड करने के बाद, आपको फ़ीड डेटा टाइप की सभी फ़ीड फ़ाइलें
अपलोड करनी होंगी. यह वही फ़ाइलें हैं जो आपकी डिस्क्रिप्टर फ़ाइल के नाम से
फ़ीड कॉन्फ़िगरेशन फ़ाइल से मेल खाती हैं. फ़ाइल के नाम और पाथ की जगहें (जो ड्रॉपबॉक्स में मौजूद हैं) data_file फ़ील्ड में शामिल की गई जानकारी से पूरी तरह मेल खानी चाहिए. अगर कोई फ़ाइल मौजूद नहीं है, उसका नाम गलत है या
उसे किसी दूसरी जगह पर अपलोड किया गया है, तो पूरे फ़ीड को
प्रोसेस नहीं किया जाएगा.
इन फ़ीड डेटा फ़ाइलों का कॉन्टेंट, उस फ़ीड से जुड़ी स्पेसिफ़िकेशन के मुताबिक होना चाहिए जिसके बारे में डिस्क्रिप्टर फ़ाइल में बताया गया था.
हर फ़ीड फ़ाइल का नाम अलग होना चाहिए. साथ ही, हर अपलोड में इसे दोबारा इस्तेमाल नहीं किया जा सकता. हमारा सुझाव है कि फ़ाइल के नाम में, जनरेट करने का टाइमस्टैंप और शार्ड नंबर (इंक्रीमेंटल आईडी) शामिल करें.
- उदाहरण: offer_1524606581_1.json
फ़ीड की फ़ाइल का साइज़ और अपलोड करने की फ़्रीक्वेंसी
- कंप्रेस करने के बाद, फ़ीड की फ़ाइल का साइज़ 200 एमबी से कम रखें.
- ज़्यादातर इंटिग्रेशन में सिर्फ़ एक शार्ड का इस्तेमाल करना होगा. आपको कम से कम शार्ड का इस्तेमाल करना चाहिए. हर फ़ीड में ज़्यादा से ज़्यादा 1,000 शार्ड हो सकते हैं.
- एक शार्ड में भेजे गए अलग-अलग रिकॉर्ड को, आने वाले समय में फ़ीड में उसी शार्ड नंबर में भेजने की ज़रूरत नहीं है.
- बेहतर परफ़ॉर्मेंस के लिए, डेटा को शार्ड के बीच बराबर बांटें, ताकि सभी शार्ड फ़ाइलों का साइज़ एक जैसा हो.
- अगर ज़रूरी हो, तो फ़ीड को कंप्रेस करने के लिए gzip का इस्तेमाल करें. हालांकि, हर एक फ़ीड शार्ड के लिए ऐसा करें.
समस्या हल करना और डीबग करना
फ़ाइलों (डिस्क्रिप्टर और फ़ीड फ़ाइलें) को अपलोड करने के बाद, पार्टनर पोर्टल (इतिहास > फ़ीड पर जाएं) पर जाकर, फ़ीड के इतिहास के डैशबोर्ड (दस्तावेज़) पर जाएं, ताकि फ़ीड में डेटा जोड़े जाने की प्रोग्रेस को देखा जा सके.
अपना फ़ीड ढूंढने के लिए, "फ़ीड का नाम" कॉलम में, डिस्क्रिप्टर फ़ाइल में name खोजें.
फ़ीड का डेटा डालने (स्थिति Success या Fail है) के बाद, उसकी लाइन पर क्लिक करके गड़बड़ियों और चेतावनियों की जानकारी देखी जा सकती है.