Bagaimana untuk mengautomasikan Analitis Promosi dengan API Ozon?

Ozon, salah satu platform e-dagang terbesar di Rusia, menawarkan API yang membolehkan penjual mengautomasikan pelbagai aspek perniagaan mereka, termasuk analisis promosi. Memahami dan menggunakan API Ozon boleh meningkatkan usaha pemasaran anda dengan ketara dan menyelaraskan operasi anda. Artikel ini akan membimbing anda melalui proses mengautomasikan analisis promosi menggunakan API Ozon.

Apakah API Ozon?

API Ozon ialah alat berkuasa yang menyediakan akses terprogram kepada sistem pengiklanan dalaman Ozon. API ini membolehkan pengguna mendapatkan semula statistik terperinci dan mengautomasikan tugas promosi. Tidak seperti kebanyakan API lain, API Ozon adalah tak segerak dan mengembalikan data dalam format fail yang diarkibkan, menjadikannya unik dan lebih kompleks untuk dikendalikan.

Sediakan Persekitaran Anda

Sebelum menyelami kod, adalah penting untuk menyediakan persekitaran anda. Anda memerlukan beberapa perpustakaan utama untuk proses ini: requests, python-dotenv, dan pandas. Menyediakan persekitaran maya boleh membantu mengurus kebergantungan dan memastikan projek anda teratur.

Mendapatkan Kredensial API

Untuk berinteraksi dengan API Ozon, anda perlu mendapatkan ID Pelanggan dan Rahsia Pelanggan daripada akaun peribadi anda di Ozon. Bukti kelayakan ini penting untuk menjana token akses, yang akan digunakan untuk semua permintaan API berikutnya.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Menjana Token Akses

Langkah pertama dalam menggunakan API ialah menjana token akses. Token ini sah selama 30 minit dan mesti digunakan untuk mengesahkan semua permintaan 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')

Mengambil Data Kempen

Sebaik sahaja anda mempunyai token akses, anda boleh mula mengambil data daripada API. Contohnya, untuk mendapatkan senarai kempen pengiklanan anda, anda boleh menggunakan kod berikut:

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', [])

Meminta Statistik Kenaikan Pangkat

Untuk mendapatkan statistik promosi, anda perlu menghantar permintaan POST dengan julat tarikh dan ID kempen. API akan mengembalikan ID laporan, yang boleh anda gunakan untuk menyemak status laporan dan memuat turunnya apabila sedia.

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

Menyemak Status Laporan dan Memuat Turun

Selepas meminta laporan, semak statusnya secara berkala sehingga ia sedia untuk dimuat turun. Laporan biasanya tersedia sebagai fail ZIP jika terdapat berbilang kempen.

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)

Mengekstrak dan Memproses Data

Setelah fail ZIP dimuat turun, ekstrak kandungannya dan proses fail CSV untuk menganalisis data.

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)

Contoh Jadual: Perangkaan Kenaikan Pangkat

Kesimpulan

Mengautomatikkan analitis promosi menggunakan API Ozon boleh meningkatkan kecekapan pemasaran anda dan memberikan pandangan yang lebih mendalam tentang kempen anda. Dengan mengikuti langkah-langkah yang digariskan dalam artikel ini, anda boleh memanfaatkan kuasa API Ozon untuk menyelaraskan usaha promosi anda. Jangan lupa untuk sentiasa menyemak status laporan anda dan mengendalikan data yang diekstrak dengan berhati-hati untuk memastikan analisis yang tepat. Selamat mengautomasikan!