Jak zautomatyzować analitykę promocji za pomocą Ozon API?

Ozon, jedna z największych platform e-commerce w Rosji, oferuje API, które pozwala sprzedawcom zautomatyzować różne aspekty ich działalności, w tym analitykę promocji. Zrozumienie i wykorzystanie API firmy Ozon może znacznie zwiększyć skuteczność działań marketingowych i usprawnić działania. Ten artykuł poprowadzi Cię przez proces automatyzacji analityki promocji przy użyciu API Ozon.

Co to jest API Ozonu?

Ozon API to potężne narzędzie, które zapewnia programowy dostęp do wewnętrznego systemu reklamowego Ozon. To API umożliwia użytkownikom pobieranie szczegółowych statystyk i automatyzację zadań promocyjnych. W przeciwieństwie do wielu innych interfejsów API, interfejs API Ozon jest asynchroniczny i zwraca dane w zarchiwizowanym formacie pliku, co czyni go wyjątkowym i nieco bardziej skomplikowanym w obsłudze.

Konfigurowanie środowiska

Przed zagłębieniem się w kod ważne jest skonfigurowanie środowiska. Do tego procesu będziesz potrzebować kilku kluczowych bibliotek: requests, python-dotenvoraz pandas. Skonfigurowanie środowiska wirtualnego może pomóc w zarządzaniu zależnościami i utrzymaniu porządku w projekcie.

Uzyskiwanie poświadczeń API

Aby wejść w interakcję z API Ozon, musisz uzyskać identyfikator klienta i sekret klienta ze swojego konta osobistego w Ozon. Te dane uwierzytelniające są niezbędne do wygenerowania tokena dostępu, który będzie używany przy wszystkich kolejnych żądaniach API.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Generowanie tokenu dostępu

Pierwszym krokiem w korzystaniu z API jest wygenerowanie tokena dostępowego. Token ten jest ważny przez 30 minut i należy go używać do uwierzytelniania wszystkich żądań 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')

Pobieranie danych kampanii

Gdy już zdobędziesz token dostępu, możesz rozpocząć pobieranie danych z API. Na przykład, aby uzyskać listę swoich kampanii reklamowych, możesz użyć następującego kodu:

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

Żądanie statystyk promocji

Aby otrzymać statystyki promocji należy wysłać żądanie POST z zakresem dat i identyfikatorami kampanii. Interfejs API zwróci identyfikator raportu, którego możesz użyć do sprawdzenia statusu raportu i pobrania go, gdy będzie gotowy.

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

Sprawdzanie statusu raportu i pobieranie

Po zażądaniu raportu sprawdzaj okresowo jego status, aż będzie gotowy do pobrania. Jeśli istnieje wiele kampanii, raport jest zwykle dostępny w postaci pliku ZIP.

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)

Wyodrębnianie i przetwarzanie danych

Po pobraniu pliku ZIP wyodrębnij jego zawartość i przetwórz pliki CSV w celu analizy danych.

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)

Przykładowa tabela: Statystyki promocji

Wnioski

Automatyzacja analityki promocji za pomocą API Ozon może znacznie zwiększyć skuteczność marketingu i zapewnić głębszy wgląd w Twoje kampanie. Wykonując kroki opisane w tym artykule, możesz wykorzystać możliwości interfejsu API firmy Ozon, aby usprawnić swoje działania promocyjne. Nie zapomnij regularnie sprawdzać statusu swoich raportów i ostrożnie obchodzić się z wyodrębnionymi danymi, aby zapewnić dokładną analizę. Miłej automatyzacji!