¿Cómo automatizar el análisis de promociones con la API de Ozon?

Ozon, una de las plataformas de comercio electrónico más grandes de Rusia, ofrece una API que permite a los vendedores automatizar varios aspectos de su negocio, incluido el análisis de promociones. Comprender y utilizar la API de Ozon puede mejorar significativamente sus esfuerzos de marketing y optimizar sus operaciones. Este artículo lo guiará a través del proceso de automatización del análisis de promociones utilizando la API de Ozon.

¿Qué es la API de Ozon?

La API de Ozon es una poderosa herramienta que proporciona acceso programático al sistema de publicidad interno de Ozon. Esta API permite a los usuarios recuperar estadísticas detalladas y automatizar tareas promocionales. A diferencia de muchas otras API, la API de Ozon es asíncrona y devuelve datos en un formato de archivo archivado, lo que la hace única y un poco más compleja de manejar.

Configurando su entorno

Antes de profundizar en el código, es fundamental configurar su entorno. Necesitará algunas bibliotecas clave para este proceso: requests, python-dotenvy pandas. Configurar un entorno virtual puede ayudar a gestionar las dependencias y mantener su proyecto organizado.

Obtención de credenciales API

Para interactuar con la API de Ozon, debe obtener el ID de cliente y el secreto de cliente de su cuenta personal en Ozon. Estas credenciales son esenciales para generar un token de acceso, que se utilizará para todas las solicitudes API posteriores.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Generando un token de acceso

El primer paso para utilizar la API es generar un token de acceso. Este token es válido durante 30 minutos y debe usarse para autenticar todas las solicitudes de 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')

Obteniendo datos de campaña

Una vez que tenga el token de acceso, puede comenzar a obtener datos de la API. Por ejemplo, para obtener una lista de sus campañas publicitarias, puede utilizar el siguiente código:

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

Solicitar estadísticas de promoción

Para obtener estadísticas de promoción, debe enviar una solicitud POST con el rango de fechas y los ID de la campaña. La API devolverá un ID de informe, que puede utilizar para comprobar el estado del informe y descargarlo cuando esté listo.

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

Comprobación del estado del informe y descarga

Después de solicitar el informe, verifique su estado periódicamente hasta que esté listo para descargar. El informe suele estar disponible como un archivo ZIP si hay varias campañas.

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)

Extracción y procesamiento de datos

Una vez descargado el archivo ZIP, extraiga su contenido y procese los archivos CSV para analizar los datos.

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)

Tabla de ejemplo: Estadísticas de promoción

Conclusión

Automatizar el análisis de promociones utilizando la API de Ozon puede mejorar enormemente la eficiencia de su marketing y proporcionar información más profunda sobre sus campañas. Si sigue los pasos descritos en este artículo, podrá aprovechar el poder de la API de Ozon para optimizar sus esfuerzos promocionales. No olvide comprobar periódicamente el estado de sus informes y manejar los datos extraídos con cuidado para garantizar un análisis preciso. ¡Feliz automatización!