Bagaimana Mengotomatiskan Analisis Promosi dengan Ozon API?

Ozon, salah satu platform e-niaga terbesar di Rusia, menawarkan API yang memungkinkan penjual mengotomatiskan berbagai aspek bisnis mereka, termasuk analisis promosi. Memahami dan memanfaatkan API Ozon dapat meningkatkan upaya pemasaran dan menyederhanakan operasi Anda secara signifikan. Artikel ini akan memandu Anda melalui proses otomatisasi analisis promosi menggunakan API Ozon.

Apa itu API Ozon?

Ozon API adalah alat canggih yang menyediakan akses terprogram ke sistem periklanan internal Ozon. API ini memungkinkan pengguna untuk mengambil statistik terperinci dan mengotomatiskan tugas promosi. Tidak seperti banyak API lainnya, API Ozon bersifat asinkron dan mengembalikan data dalam format file yang diarsipkan, menjadikannya unik dan sedikit lebih rumit untuk ditangani.

Menyiapkan Lingkungan Anda

Sebelum mendalami kodenya, penting untuk menyiapkan lingkungan Anda. Anda memerlukan beberapa pustaka utama untuk proses ini: requests, python-dotenv, Dan pandas. Menyiapkan lingkungan virtual dapat membantu mengelola dependensi dan menjaga proyek Anda tetap teratur.

Mendapatkan Kredensial API

Untuk berinteraksi dengan API Ozon, Anda perlu mendapatkan ID Klien dan Rahasia Klien dari akun pribadi Anda di Ozon. Kredensial ini penting untuk menghasilkan 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')

Menghasilkan Token Akses

Langkah pertama dalam menggunakan API adalah membuat token akses. Token ini berlaku selama 30 menit dan harus digunakan untuk mengautentikasi 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 Kampanye

Setelah Anda memiliki token akses, Anda dapat mulai mengambil data dari API. Misalnya, untuk mendapatkan daftar kampanye iklan Anda, Anda dapat menggunakan kode 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 Promosi

Untuk mendapatkan statistik promosi, Anda perlu mengirimkan permintaan POST dengan rentang tanggal dan ID kampanye. API akan mengembalikan ID laporan, yang dapat Anda gunakan untuk memeriksa status laporan dan mendownloadnya jika sudah siap.

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

Memeriksa Status Laporan dan Pengunduhan

Setelah meminta laporan, periksa statusnya secara berkala hingga siap diunduh. Laporan biasanya tersedia sebagai file ZIP jika terdapat beberapa kampanye.

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)

Mengekstraksi dan Memproses Data

Setelah file ZIP diunduh, ekstrak isinya dan proses file 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 Tabel: Statistik Promosi

Kesimpulan

Mengotomatiskan analisis promosi menggunakan API Ozon dapat meningkatkan efisiensi pemasaran Anda dan memberikan wawasan yang lebih mendalam tentang kampanye Anda. Dengan mengikuti langkah-langkah yang diuraikan dalam artikel ini, Anda dapat memanfaatkan kekuatan API Ozon untuk menyederhanakan upaya promosi Anda. Jangan lupa untuk memeriksa status laporan Anda secara rutin dan menangani data yang diekstraksi dengan hati-hati untuk memastikan analisis yang akurat. Selamat mengotomatisasi!