اوزون API کے ساتھ پروموشن تجزیات کو خودکار کیسے بنایا جائے؟

اوزون، روس میں سب سے بڑے ای کامرس پلیٹ فارمز میں سے ایک، ایک API پیش کرتا ہے جو بیچنے والوں کو اپنے کاروبار کے مختلف پہلوؤں کو خودکار کرنے کی اجازت دیتا ہے، بشمول پروموشن اینالیٹکس۔ Ozon کے API کو سمجھنا اور استعمال کرنا آپ کی مارکیٹنگ کی کوششوں کو نمایاں طور پر بڑھا سکتا ہے اور آپ کے کاموں کو ہموار کر سکتا ہے۔ یہ مضمون اوزون کے API کا استعمال کرتے ہوئے پروموشن اینالیٹکس کو خودکار بنانے کے عمل میں آپ کی رہنمائی کرے گا۔

اوزون API کیا ہے؟

اوزون API ایک طاقتور ٹول ہے جو اوزون کے اندرونی اشتہاری نظام تک پروگرامی رسائی فراہم کرتا ہے۔ یہ API صارفین کو تفصیلی اعدادوشمار بازیافت کرنے اور پروموشنل کاموں کو خودکار کرنے کی اجازت دیتا ہے۔ بہت سے دوسرے APIs کے برعکس، Ozon کا API غیر مطابقت پذیر ہے اور ڈیٹا کو محفوظ شدہ فائل کی شکل میں واپس کرتا ہے، جس سے اسے منفرد اور ہینڈل کرنے میں قدرے پیچیدہ ہوتا ہے۔

اپنے ماحول کو ترتیب دینا

کوڈ میں غوطہ لگانے سے پہلے، اپنے ماحول کو ترتیب دینا بہت ضروری ہے۔ اس عمل کے لیے آپ کو چند کلیدی لائبریریوں کی ضرورت ہوگی: requests, python-dotenv، اور pandas. ورچوئل ماحول قائم کرنے سے انحصار کو منظم کرنے اور آپ کے پروجیکٹ کو منظم رکھنے میں مدد مل سکتی ہے۔

API اسناد حاصل کرنا

Ozon کے API کے ساتھ تعامل کرنے کے لیے، آپ کو Ozon پر اپنے ذاتی اکاؤنٹ سے کلائنٹ آئی ڈی اور کلائنٹ سیکرٹ حاصل کرنے کی ضرورت ہے۔ یہ اسناد ایک رسائی ٹوکن بنانے کے لیے ضروری ہیں، جو بعد میں آنے والی تمام 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', [])

پروموشن کے اعدادوشمار کی درخواست کرنا

پروموشن کے اعدادوشمار حاصل کرنے کے لیے، آپ کو تاریخ کی حد اور مہم کے IDs کے ساتھ POST کی درخواست بھیجنے کی ضرورت ہے۔ API ایک رپورٹ ID واپس کرے گا، جسے آپ رپورٹ کی حیثیت چیک کرنے اور تیار ہونے پر اسے ڈاؤن لوڈ کرنے کے لیے استعمال کر سکتے ہیں۔

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')

رپورٹ کی حیثیت اور ڈاؤن لوڈنگ کی جانچ کر رہا ہے۔

رپورٹ کی درخواست کرنے کے بعد، وقتاً فوقتاً اس کی حالت چیک کریں جب تک کہ یہ ڈاؤن لوڈ کے لیے تیار نہ ہو۔ رپورٹ عام طور پر زپ فائل کے طور پر دستیاب ہوتی ہے اگر متعدد مہمات ہوں۔

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)

مثال کا جدول: پروموشن کے اعدادوشمار

نتیجہ

اوزون کے API کا استعمال کرتے ہوئے پروموشن اینالیٹکس کو خودکار بنانا آپ کی مارکیٹنگ کی کارکردگی کو بہت زیادہ بڑھا سکتا ہے اور آپ کی مہمات میں گہری بصیرت فراہم کر سکتا ہے۔ اس مضمون میں بیان کردہ اقدامات پر عمل کرکے، آپ اپنی پروموشنل کوششوں کو ہموار کرنے کے لیے اوزون کے API کی طاقت کا فائدہ اٹھا سکتے ہیں۔ درست تجزیہ کو یقینی بنانے کے لیے باقاعدگی سے اپنی رپورٹس کی حیثیت کو چیک کرنا اور نکالے گئے ڈیٹا کو احتیاط سے ہینڈل کرنا نہ بھولیں۔ خوش خودکار!