Kuidas automatiseerida reklaamide analüüsi Ozon API-ga?

Venemaa üks suurimaid e-kaubanduse platvorme Ozon pakub API-t, mis võimaldab müüjatel automatiseerida oma äri erinevaid aspekte, sealhulgas reklaamide analüüse. Ozoni API mõistmine ja kasutamine võib teie turundustegevust märkimisväärselt tõhustada ja toiminguid sujuvamaks muuta. See artikkel juhendab teid reklaamide analüütika automatiseerimise protsessis Ozoni API abil.

Mis on Ozon API?

Ozon API on võimas tööriist, mis pakub programmilist juurdepääsu Ozoni sisemisele reklaamisüsteemile. See API võimaldab kasutajatel hankida üksikasjalikku statistikat ja automatiseerida reklaamitoiminguid. Erinevalt paljudest teistest API-dest on Ozoni API asünkroonne ja tagastab andmed arhiveeritud failivormingus, muutes selle ainulaadseks ja käsitlemise pisut keerukamaks.

Oma keskkonna seadistamine

Enne koodisse sukeldumist on ülioluline oma keskkond seadistada. Selle protsessi jaoks vajate mõnda võtmeteeki. requests, python-dotenvja pandas. Virtuaalse keskkonna seadistamine võib aidata hallata sõltuvusi ja hoida projekti korrastatuna.

API mandaatide hankimine

Ozoni API-ga suhtlemiseks peate hankima oma isiklikult Ozoni kontolt kliendi ID ja kliendi saladuse. Need mandaadid on olulised juurdepääsuloa loomiseks, mida kasutatakse kõigi järgnevate API päringute jaoks.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Juurdepääsuloa genereerimine

API kasutamise esimene samm on juurdepääsuluba loomine. See tunnus kehtib 30 minutit ja seda tuleb kasutada kõigi API taotluste autentimiseks.

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

Kampaania andmete toomine

Kui teil on juurdepääsuluba, võite alustada andmete toomist API-st. Näiteks saate oma reklaamikampaaniate loendi hankimiseks kasutada järgmist koodi:

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

Reklaamistatistika taotlemine

Pakkumise statistika saamiseks peate saatma POST-i päringu koos kuupäevavahemiku ja kampaania ID-dega. API tagastab aruande ID, mida saate kasutada aruande oleku kontrollimiseks ja selle allalaadimiseks, kui see on valmis.

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

Aruande oleku kontrollimine ja allalaadimine

Pärast aruande taotlemist kontrollige selle olekut perioodiliselt, kuni see on allalaadimiseks valmis. Kui kampaaniaid on mitu, on aruanne tavaliselt saadaval ZIP-failina.

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)

Andmete ekstraheerimine ja töötlemine

Kui ZIP-fail on alla laaditud, eraldage selle sisu ja töödelge andmete analüüsimiseks CSV-faile.

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)

Näitetabel: Edutamise statistika

Kokkuvõte

Reklaamianalüütika automatiseerimine Ozoni API abil võib oluliselt suurendada teie turunduse tõhusust ja anda teie kampaaniatest sügavama ülevaate. Järgides selles artiklis kirjeldatud samme, saate kasutada Ozoni API võimsust oma reklaamitegevuse tõhustamiseks. Ärge unustage regulaarselt kontrollida oma aruannete olekut ja käsitleda ekstraheeritud andmeid hoolikalt, et tagada täpne analüüs. Head automatiseerimist!