كيفية أتمتة تحليلات الترويج باستخدام Ozon API؟

تقدم Ozon، إحدى أكبر منصات التجارة الإلكترونية في روسيا، واجهة برمجة تطبيقات تسمح للبائعين بأتمتة جوانب مختلفة من أعمالهم، بما في ذلك تحليلات العروض الترويجية. إن فهم واستخدام واجهة برمجة تطبيقات Ozon يمكن أن يعزز بشكل كبير جهودك التسويقية ويبسط عملياتك. سترشدك هذه المقالة خلال عملية أتمتة تحليلات الترويج باستخدام واجهة برمجة تطبيقات Ozon.

ما هو أوزون API؟

تعد Ozon API أداة قوية توفر وصولاً برمجيًا إلى نظام الإعلانات الداخلي لشركة Ozon. تسمح واجهة برمجة التطبيقات هذه للمستخدمين باسترداد الإحصائيات التفصيلية وأتمتة المهام الترويجية. على عكس العديد من واجهات برمجة التطبيقات الأخرى، فإن واجهة برمجة تطبيقات Ozon غير متزامنة وتقوم بإرجاع البيانات بتنسيق ملف مؤرشف، مما يجعلها فريدة وأكثر تعقيدًا قليلاً في التعامل معها.

إعداد بيئتك

قبل الغوص في التعليمات البرمجية، من الضروري إعداد بيئتك. ستحتاج إلى بعض المكتبات الأساسية لهذه العملية: requests, python-dotenv، و pandas. يمكن أن يساعد إعداد بيئة افتراضية في إدارة التبعيات والحفاظ على تنظيم مشروعك.

الحصول على بيانات اعتماد API

للتفاعل مع واجهة برمجة التطبيقات الخاصة بـ Ozon، يتعين عليك الحصول على معرف العميل وسر العميل من حسابك الشخصي على Ozon. تعتبر بيانات الاعتماد هذه ضرورية لإنشاء رمز وصول، والذي سيتم استخدامه لجميع طلبات واجهة برمجة التطبيقات اللاحقة.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

إنشاء رمز الوصول

الخطوة الأولى في استخدام واجهة برمجة التطبيقات هي إنشاء رمز وصول. هذا الرمز صالح لمدة 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)

استخراج ومعالجة البيانات

بمجرد تنزيل ملف ZIP، قم باستخراج محتوياته ومعالجة ملفات 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)

جدول المثال: إحصائيات الترويج

خاتمة

يمكن أن تؤدي أتمتة تحليلات الترويج باستخدام واجهة برمجة تطبيقات Ozon إلى تعزيز كفاءتك التسويقية بشكل كبير وتوفير رؤى أعمق لحملاتك. باتباع الخطوات الموضحة في هذه المقالة، يمكنك الاستفادة من قوة واجهة برمجة تطبيقات Ozon لتبسيط جهودك الترويجية. لا تنس التحقق بانتظام من حالة تقاريرك والتعامل مع البيانات المستخرجة بعناية لضمان التحليل الدقيق. أتمتة سعيدة!