Ozon API ile Promosyon Analitiği Nasıl Otomatikleştirilir?

Rusya'nın en büyük e-ticaret platformlarından biri olan Ozon, satıcıların promosyon analitiği de dahil olmak üzere işlerinin çeşitli yönlerini otomatikleştirmesine olanak tanıyan bir API sunuyor. Ozon'un API'sini anlamak ve kullanmak, pazarlama çalışmalarınızı önemli ölçüde geliştirebilir ve operasyonlarınızı kolaylaştırabilir. Bu makale, Ozon'un API'sini kullanarak promosyon analizlerini otomatikleştirme sürecinde size rehberlik edecektir.

Ozon API'si nedir?

Ozon API, Ozon'un dahili reklam sistemine programlı erişim sağlayan güçlü bir araçtır. Bu API, kullanıcıların ayrıntılı istatistikler almasına ve tanıtım görevlerini otomatikleştirmesine olanak tanır. Diğer birçok API'den farklı olarak Ozon'un API'si eşzamansızdır ve verileri arşivlenmiş bir dosya biçiminde döndürür, bu da onu benzersiz ve işlenmesini biraz daha karmaşık hale getirir.

Ortamınızı Kurma

Koda dalmadan önce ortamınızı ayarlamanız çok önemlidir. Bu işlem için birkaç anahtar kütüphaneye ihtiyacınız olacak: requests, python-dotenvve pandas. Sanal bir ortam oluşturmak bağımlılıkları yönetmenize ve projenizi düzenli tutmanıza yardımcı olabilir.

API Kimlik Bilgilerini Alma

Ozon'un API'si ile etkileşime geçmek için Ozon'daki kişisel hesabınızdan Müşteri Kimliğini ve Müşteri Sırrını almanız gerekir. Bu kimlik bilgileri, sonraki tüm API istekleri için kullanılacak bir erişim belirteci oluşturmak için gereklidir.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Erişim Belirteci Oluşturma

API'yi kullanmanın ilk adımı bir erişim belirteci oluşturmaktır. Bu belirteç 30 dakika süreyle geçerlidir ve tüm API isteklerinin kimliğini doğrulamak için kullanılmalıdır.

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

Kampanya Verileri Getiriliyor

Erişim jetonunu aldıktan sonra API'den veri almaya başlayabilirsiniz. Örneğin, reklam kampanyalarınızın bir listesini almak için aşağıdaki kodu kullanabilirsiniz:

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

Promosyon İstatistiklerini Talep Etme

Promosyon istatistiklerini elde etmek için tarih aralığını ve kampanya kimliklerini içeren bir POST isteği göndermeniz gerekir. API, rapor durumunu kontrol etmek ve hazır olduğunda indirmek için kullanabileceğiniz bir rapor kimliği döndürecektir.

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

Rapor Durumunu Kontrol Etme ve İndirme

Raporu talep ettikten sonra, indirilmeye hazır olana kadar durumunu düzenli aralıklarla kontrol edin. Birden fazla kampanya varsa rapor genellikle ZIP dosyası olarak sunulur.

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)

Verilerin Çıkarılması ve İşlenmesi

ZIP dosyası indirildikten sonra içeriğini çıkarın ve verileri analiz etmek için CSV dosyalarını işleyin.

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)

Örnek Tablo: Promosyon İstatistikleri

Sonuç

Ozon'un API'sini kullanarak promosyon analizlerini otomatikleştirmek, pazarlama verimliliğinizi büyük ölçüde artırabilir ve kampanyalarınız hakkında daha derin bilgiler sağlayabilir. Bu makalede özetlenen adımları izleyerek tanıtım çalışmalarınızı kolaylaştırmak için Ozon API'sinin gücünden yararlanabilirsiniz. Doğru analiz sağlamak için raporlarınızın durumunu düzenli olarak kontrol etmeyi ve çıkarılan verileri dikkatli bir şekilde kullanmayı unutmayın. Mutlu otomasyon!