Wie automatisiert man Promotion-Analysen mit der Ozon-API?

Ozon, eine der größten E-Commerce-Plattformen in Russland, bietet eine API, mit der Verkäufer verschiedene Aspekte ihres Geschäfts automatisieren können, darunter auch die Werbeanalyse. Wenn Sie die API von Ozon verstehen und nutzen, können Sie Ihre Marketingbemühungen erheblich verbessern und Ihre Abläufe rationalisieren. Dieser Artikel führt Sie durch den Prozess der Automatisierung der Werbeanalyse mithilfe der API von Ozon.

Was ist die Ozon-API?

Die Ozon-API ist ein leistungsstarkes Tool, das programmgesteuerten Zugriff auf Ozons internes Werbesystem bietet. Mit dieser API können Benutzer detaillierte Statistiken abrufen und Werbeaufgaben automatisieren. Im Gegensatz zu vielen anderen APIs ist die API von Ozon asynchron und gibt Daten in einem archivierten Dateiformat zurück, was sie einzigartig und etwas komplexer in der Handhabung macht.

Einrichten Ihrer Umgebung

Bevor Sie sich in den Code vertiefen, müssen Sie unbedingt Ihre Umgebung einrichten. Für diesen Vorgang benötigen Sie einige wichtige Bibliotheken: requests, python-dotenv, Und pandas. Das Einrichten einer virtuellen Umgebung kann dabei helfen, Abhängigkeiten zu verwalten und Ihr Projekt zu organisieren.

API-Anmeldeinformationen abrufen

Um mit der API von Ozon interagieren zu können, müssen Sie die Client-ID und das Client-Geheimnis von Ihrem persönlichen Ozon-Konto abrufen. Diese Anmeldeinformationen sind für die Generierung eines Zugriffstokens erforderlich, das für alle nachfolgenden API-Anfragen verwendet wird.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Generieren eines Zugriffstokens

Der erste Schritt bei der Verwendung der API besteht darin, ein Zugriffstoken zu generieren. Dieses Token ist 30 Minuten lang gültig und muss zur Authentifizierung aller API-Anfragen verwendet werden.

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

Abrufen von Kampagnendaten

Sobald Sie das Zugriffstoken haben, können Sie mit dem Abrufen von Daten aus der API beginnen. Um beispielsweise eine Liste Ihrer Werbekampagnen abzurufen, können Sie den folgenden Code verwenden:

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

Promotion-Statistiken anfordern

Um Werbestatistiken zu erhalten, müssen Sie eine POST-Anfrage mit dem Datumsbereich und den Kampagnen-IDs senden. Die API gibt eine Berichts-ID zurück, mit der Sie den Berichtsstatus überprüfen und ihn herunterladen können, wenn er fertig ist.

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

Überprüfen des Berichtsstatus und Herunterladen

Überprüfen Sie nach Anforderung des Berichts regelmäßig seinen Status, bis er zum Download bereit steht. Bei mehreren Kampagnen ist der Bericht in der Regel als ZIP-Datei verfügbar.

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)

Extrahieren und Verarbeiten von Daten

Sobald die ZIP-Datei heruntergeladen ist, extrahieren Sie ihren Inhalt und verarbeiten Sie die CSV-Dateien, um die Daten zu analysieren.

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)

Beispieltabelle: Werbestatistiken

Abschluss

Die Automatisierung von Werbeanalysen mithilfe der API von Ozon kann Ihre Marketingeffizienz erheblich steigern und Ihnen tiefere Einblicke in Ihre Kampagnen bieten. Indem Sie die in diesem Artikel beschriebenen Schritte befolgen, können Sie die Leistungsfähigkeit der API von Ozon nutzen, um Ihre Werbemaßnahmen zu optimieren. Vergessen Sie nicht, den Status Ihrer Berichte regelmäßig zu überprüfen und die extrahierten Daten sorgfältig zu behandeln, um eine genaue Analyse zu gewährleisten. Viel Spaß beim Automatisieren!