Jak automatizovat analýzu propagace pomocí Ozon API?

Ozon, jedna z největších platforem elektronického obchodu v Rusku, nabízí API, které prodejcům umožňuje automatizovat různé aspekty jejich podnikání, včetně analýzy propagace. Pochopení a využití Ozon API může výrazně zlepšit vaše marketingové úsilí a zefektivnit vaše operace. Tento článek vás provede procesem automatizace analýzy propagace pomocí rozhraní API společnosti Ozon.

Co je Ozon API?

Ozon API je výkonný nástroj, který poskytuje programový přístup k internímu reklamnímu systému Ozon. Toto API umožňuje uživatelům získávat podrobné statistiky a automatizovat propagační úkoly. Na rozdíl od mnoha jiných API je Ozon API asynchronní a vrací data v archivovaném formátu souboru, díky čemuž je jedinečné a o něco složitější na zpracování.

Nastavení vašeho prostředí

Než se ponoříte do kódu, je důležité nastavit vaše prostředí. Pro tento proces budete potřebovat několik klíčových knihoven: requests, python-dotenv, a pandas. Nastavení virtuálního prostředí může pomoci spravovat závislosti a udržovat váš projekt organizovaný.

Získání pověření API

Chcete-li komunikovat s rozhraním API společnosti Ozon, musíte získat ID klienta a tajný klíč klienta ze svého osobního účtu na Ozonu. Tyto přihlašovací údaje jsou nezbytné pro generování přístupového tokenu, který bude použit pro všechny následné požadavky API.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Generování přístupového tokenu

Prvním krokem při používání API je vygenerování přístupového tokenu. Tento token je platný 30 minut a musí být použit k ověření všech požadavků 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')

Načítání dat kampaně

Jakmile budete mít přístupový token, můžete začít načítat data z API. Chcete-li například získat seznam svých reklamních kampaní, můžete použít následující kód:

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

Vyžádání statistik propagace

Chcete-li získat statistiky propagace, musíte odeslat požadavek POST s časovým obdobím a ID kampaně. Rozhraní API vrátí ID přehledu, které můžete použít ke kontrole stavu přehledu a stáhnout si ho, až budete připraveni.

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

Kontrola stavu sestavy a stahování

Po vyžádání přehledu pravidelně kontrolujte jeho stav, dokud nebude připraven ke stažení. Pokud existuje více kampaní, zpráva je obvykle k dispozici jako soubor 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)

Získávání a zpracování dat

Jakmile je soubor ZIP stažen, extrahujte jeho obsah a zpracujte soubory CSV za účelem analýzy dat.

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)

Příklad tabulky: Statistika propagace

Závěr

Automatizace analýzy propagace pomocí rozhraní API společnosti Ozon může výrazně zvýšit efektivitu vašeho marketingu a poskytnout hlubší vhled do vašich kampaní. Dodržováním kroků popsaných v tomto článku můžete využít sílu Ozon API k zefektivnění vašich propagačních aktivit. Nezapomeňte pravidelně kontrolovat stav svých reportů a zacházejte s extrahovanými daty opatrně, abyste zajistili přesnou analýzu. Šťastnou automatizaci!