ओज़ोन एपीआई के साथ प्रमोशन एनालिटिक्स को स्वचालित कैसे करें?

रूस में सबसे बड़े ई-कॉमर्स प्लेटफ़ॉर्म में से एक ओज़ोन एक एपीआई प्रदान करता है जो विक्रेताओं को अपने व्यवसाय के विभिन्न पहलुओं को स्वचालित करने की अनुमति देता है, जिसमें प्रचार विश्लेषण भी शामिल है। ओज़ोन के एपीआई को समझना और उसका उपयोग करना आपके मार्केटिंग प्रयासों को महत्वपूर्ण रूप से बढ़ा सकता है और आपके संचालन को सुव्यवस्थित कर सकता है। यह लेख आपको ओज़ोन के एपीआई का उपयोग करके प्रचार विश्लेषण को स्वचालित करने की प्रक्रिया के बारे में बताएगा।

ओजोन एपीआई क्या है?

ओज़ोन एपीआई एक शक्तिशाली उपकरण है जो ओज़ोन की आंतरिक विज्ञापन प्रणाली तक प्रोग्रामेटिक पहुँच प्रदान करता है। यह एपीआई उपयोगकर्ताओं को विस्तृत आँकड़े प्राप्त करने और प्रचार कार्यों को स्वचालित करने की अनुमति देता है। कई अन्य API के विपरीत, ओज़ोन का API अतुल्यकालिक है और संग्रहीत फ़ाइल प्रारूप में डेटा लौटाता है, जिससे यह अद्वितीय और संभालने में थोड़ा अधिक जटिल हो जाता है।

अपना वातावरण स्थापित करना

कोड में गोता लगाने से पहले, अपने वातावरण को सेट करना महत्वपूर्ण है। इस प्रक्रिया के लिए आपको कुछ प्रमुख लाइब्रेरीज़ की आवश्यकता होगी: requests, python-dotenv, और pandasवर्चुअल वातावरण स्थापित करने से निर्भरताओं को प्रबंधित करने और अपनी परियोजना को व्यवस्थित रखने में मदद मिल सकती है।

API क्रेडेंशियल प्राप्त करना

ओज़ोन के API के साथ बातचीत करने के लिए, आपको ओज़ोन पर अपने व्यक्तिगत खाते से क्लाइंट आईडी और क्लाइंट सीक्रेट प्राप्त करना होगा। ये क्रेडेंशियल एक्सेस टोकन बनाने के लिए आवश्यक हैं, जिसका उपयोग बाद के सभी API अनुरोधों के लिए किया जाएगा।

import requests
import os
from dotenv import load_dotenv

load_dotenv()

CLIENT_ID = os.getenv('CLIENT_ID')
CLIENT_SECRET = os.getenv('CLIENT_SECRET')

एक्सेस टोकन उत्पन्न करना

API का उपयोग करने में पहला कदम एक एक्सेस टोकन जनरेट करना है। यह टोकन 30 मिनट के लिए वैध होता है और इसका उपयोग सभी API अनुरोधों को प्रमाणित करने के लिए किया जाना चाहिए।

url = "https://api.ozon.ru/sell/v1/oauth/token"
headers = {
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "client_id": CLIENT_ID,
    "client_secret": CLIENT_SECRET,
    "grant_type": "client_credentials"
}

response = requests.post(url, headers=headers, json=payload)
access_token = response.json().get('access_token')

अभियान डेटा प्राप्त करना

एक बार जब आपके पास एक्सेस टोकन हो जाए, तो आप API से डेटा प्राप्त करना शुरू कर सकते हैं। उदाहरण के लिए, अपने विज्ञापन अभियानों की सूची प्राप्त करने के लिए, आप निम्न कोड का उपयोग कर सकते हैं:

url = "https://api.ozon.ru/performance/v1/campaigns"
headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/json",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
campaigns = response.json().get('campaigns', [])

पदोन्नति सांख्यिकी का अनुरोध

प्रमोशन के आँकड़े प्राप्त करने के लिए, आपको दिनांक सीमा और अभियान आईडी के साथ एक POST अनुरोध भेजना होगा। API एक रिपोर्ट आईडी लौटाएगा, जिसका उपयोग आप रिपोर्ट की स्थिति की जाँच करने और तैयार होने पर उसे डाउनलोड करने के लिए कर सकते हैं।

report_payload = {
    "campaigns": [campaign_id_list],
    "date_from": "2024-01-01",
    "date_to": "2024-01-31"
}

report_response = requests.post(report_url, headers=headers, json=report_payload)
report_id = report_response.json().get('report_id')

रिपोर्ट की स्थिति की जाँच करना और डाउनलोड करना

रिपोर्ट का अनुरोध करने के बाद, डाउनलोड के लिए तैयार होने तक समय-समय पर इसकी स्थिति की जाँच करें। यदि कई अभियान हैं तो रिपोर्ट आमतौर पर ZIP फ़ाइल के रूप में उपलब्ध होती है।

status_url = f"https://api.ozon.ru/performance/v1/report/status?report_id={report_id}"
status_response = requests.get(status_url, headers=headers)

if status_response.json().get('status') == 'done':
    download_url = f"https://api.ozon.ru/performance/v1/report/download?report_id={report_id}"
    download_response = requests.get(download_url, headers=headers)

    with open('report.zip', 'wb') as f:
        f.write(download_response.content)

डेटा निकालना और उसका प्रसंस्करण करना

एक बार ज़िप फ़ाइल डाउनलोड हो जाने पर, इसकी सामग्री निकालें और डेटा का विश्लेषण करने के लिए CSV फ़ाइल को संसाधित करें।

import zipfile
import pandas as pd

with zipfile.ZipFile('report.zip', 'r') as zip_ref:
    zip_ref.extractall('extracted_reports')

csv_files = [f for f in os.listdir('extracted_reports') if f.endswith('.csv')]
data_frames = [pd.read_csv(f'extracted_reports/{file}', delimiter=';') for file in csv_files]

combined_df = pd.concat(data_frames, ignore_index=True)
combined_df.to_csv('final_report.csv', index=False)

उदाहरण तालिका: पदोन्नति सांख्यिकी

निष्कर्ष

ओज़ोन के एपीआई का उपयोग करके प्रचार विश्लेषण को स्वचालित करना आपकी मार्केटिंग दक्षता को बहुत बढ़ा सकता है और आपके अभियानों में गहन अंतर्दृष्टि प्रदान कर सकता है। इस लेख में बताए गए चरणों का पालन करके, आप अपने प्रचार प्रयासों को सुव्यवस्थित करने के लिए ओज़ोन के एपीआई की शक्ति का लाभ उठा सकते हैं। सटीक विश्लेषण सुनिश्चित करने के लिए नियमित रूप से अपनी रिपोर्ट की स्थिति की जाँच करना और निकाले गए डेटा को सावधानीपूर्वक संभालना न भूलें। स्वचालन का आनंद लें!