Comment automatiser l'analyse des promotions avec l'API Ozon ?

Ozon, l'une des plus grandes plateformes de commerce électronique de Russie, propose une API qui permet aux vendeurs d'automatiser divers aspects de leur activité, notamment l'analyse des promotions. Comprendre et utiliser l'API d'Ozon peut améliorer considérablement vos efforts de marketing et rationaliser vos opérations. Cet article vous guidera tout au long du processus d'automatisation de l'analyse des promotions à l'aide de l'API d'Ozon.

Qu'est-ce que l'API Ozon ?

L'API Ozon est un outil puissant qui fournit un accès programmatique au système de publicité interne d'Ozon. Cette API permet aux utilisateurs de récupérer des statistiques détaillées et d'automatiser les tâches promotionnelles. Contrairement à de nombreuses autres API, l'API d'Ozon est asynchrone et renvoie les données dans un format de fichier archivé, ce qui la rend unique et légèrement plus complexe à gérer.

Configuration de votre environnement

Avant de plonger dans le code, il est crucial de configurer votre environnement. Vous aurez besoin de quelques bibliothèques clés pour ce processus : requests, python-dotenvet pandas. La configuration d'un environnement virtuel peut aider à gérer les dépendances et à garder votre projet organisé.

Obtention des informations d'identification API

Pour interagir avec l'API d'Ozon, vous devez obtenir l'ID client et le secret client à partir de votre compte personnel sur Ozon. Ces informations d'identification sont essentielles pour générer un jeton d'accès, qui sera utilisé pour toutes les requêtes API ultérieures.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Générer un jeton d'accès

La première étape de l'utilisation de l'API consiste à générer un jeton d'accès. Ce jeton est valable 30 minutes et doit être utilisé pour authentifier toutes les requêtes 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')

Récupération des données de campagne

Une fois que vous disposez du jeton d'accès, vous pouvez commencer à récupérer les données de l'API. Par exemple, pour obtenir la liste de vos campagnes publicitaires, vous pouvez utiliser le code suivant :

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

Demander des statistiques de promotion

Pour obtenir des statistiques de promotion, vous devez envoyer une requête POST avec la plage de dates et les identifiants de campagne. L'API renverra un ID de rapport, que vous pourrez utiliser pour vérifier l'état du rapport et le télécharger lorsqu'il sera prêt.

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

Vérification de l'état du rapport et téléchargement

Après avoir demandé le rapport, vérifiez son statut périodiquement jusqu'à ce qu'il soit prêt à être téléchargé. Le rapport est généralement disponible sous forme de fichier ZIP s'il existe plusieurs campagnes.

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)

Extraction et traitement des données

Une fois le fichier ZIP téléchargé, extrayez son contenu et traitez les fichiers CSV pour analyser les données.

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)

Exemple de tableau : Statistiques de promotion

Conclusion

L'automatisation des analyses de promotion à l'aide de l'API d'Ozon peut considérablement améliorer votre efficacité marketing et fournir des informations plus approfondies sur vos campagnes. En suivant les étapes décrites dans cet article, vous pouvez tirer parti de la puissance de l'API d'Ozon pour rationaliser vos efforts promotionnels. N'oubliez pas de vérifier régulièrement l'état de vos rapports et de traiter les données extraites avec soin pour garantir une analyse précise. Bonne automatisation !