Come automatizzare l'analisi delle promozioni con l'API Ozon?

Ozon, una delle più grandi piattaforme di e-commerce in Russia, offre un'API che consente ai venditori di automatizzare vari aspetti della propria attività, inclusa l'analisi delle promozioni. Comprendere e utilizzare l'API di Ozon può migliorare significativamente i tuoi sforzi di marketing e semplificare le tue operazioni. Questo articolo ti guiderà attraverso il processo di automazione dell'analisi delle promozioni utilizzando l'API di Ozon.

Cos'è l'API Ozon?

L'API Ozon è un potente strumento che fornisce accesso programmatico al sistema pubblicitario interno di Ozon. Questa API consente agli utenti di recuperare statistiche dettagliate e automatizzare le attività promozionali. A differenza di molte altre API, l'API di Ozon è asincrona e restituisce i dati in un formato di file archiviato, rendendolo unico e leggermente più complesso da gestire.

Configurazione dell'ambiente

Prima di immergersi nel codice, è fondamentale configurare l'ambiente. Avrai bisogno di alcune librerie di chiavi per questo processo: requests, python-dotenv, e pandas. La configurazione di un ambiente virtuale può aiutare a gestire le dipendenze e a mantenere organizzato il progetto.

Ottenere le credenziali API

Per interagire con l'API di Ozon, devi ottenere Client ID e Client Secret dal tuo account personale su Ozon. Queste credenziali sono essenziali per generare un token di accesso, che verrà utilizzato per tutte le successive richieste API.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Generazione di un token di accesso

Il primo passaggio nell'utilizzo dell'API è generare un token di accesso. Questo token è valido per 30 minuti e deve essere utilizzato per autenticare tutte le richieste 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')

Recupero dei dati della campagna

Una volta ottenuto il token di accesso, puoi iniziare a recuperare i dati dall'API. Ad esempio, per ottenere un elenco delle tue campagne pubblicitarie, puoi utilizzare il seguente codice:

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

Richiesta di statistiche sulla promozione

Per ottenere le statistiche sulla promozione, devi inviare una richiesta POST con l'intervallo di date e gli ID campagna. L'API restituirà un ID report che puoi utilizzare per verificare lo stato del report e scaricarlo quando è pronto.

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

Controllo dello stato e del download del report

Dopo aver richiesto il report, controlla periodicamente il suo stato finché non è pronto per il download. Il report è generalmente disponibile come file ZIP se sono presenti più campagne.

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)

Estrazione ed elaborazione dei dati

Una volta scaricato il file ZIP, estrai il suo contenuto ed elabora i file CSV per analizzare i dati.

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)

Tabella di esempio: statistiche sulle promozioni

Conclusione

Automatizzare l'analisi delle promozioni utilizzando l'API di Ozon può migliorare notevolmente l'efficienza del tuo marketing e fornire informazioni più approfondite sulle tue campagne. Seguendo i passaggi delineati in questo articolo, puoi sfruttare la potenza dell'API di Ozon per semplificare i tuoi sforzi promozionali. Non dimenticare di controllare regolarmente lo stato dei tuoi report e di gestire con attenzione i dati estratti per garantire un'analisi accurata. Buona automazione!