Como automatizar análises de promoção com API Ozon?

Ozon, uma das maiores plataformas de comércio eletrônico da Rússia, oferece uma API que permite aos vendedores automatizar vários aspectos de seus negócios, incluindo análises de promoção. Compreender e utilizar a API da Ozon pode melhorar significativamente seus esforços de marketing e agilizar suas operações. Este artigo irá guiá-lo através do processo de automatização da análise de promoção usando a API da Ozon.

O que é API Ozon?

A API Ozon é uma ferramenta poderosa que fornece acesso programático ao sistema interno de publicidade da Ozon. Esta API permite aos usuários recuperar estatísticas detalhadas e automatizar tarefas promocionais. Ao contrário de muitas outras APIs, a API do Ozon é assíncrona e retorna dados em um formato de arquivo arquivado, tornando-a única e um pouco mais complexa de manusear.

Configurando seu ambiente

Antes de mergulhar no código, é crucial configurar seu ambiente. Você precisará de algumas bibliotecas principais para este processo: requests, python-dotenve pandas. Configurar um ambiente virtual pode ajudar a gerenciar dependências e manter seu projeto organizado.

Obtenção de credenciais de API

Para interagir com a API do Ozon, você precisa obter o Client ID e o Client Secret da sua conta pessoal no Ozon. Essas credenciais são essenciais para gerar um token de acesso, que será usado para todas as solicitações de API subsequentes.

import requests
import os
from dotenv import load_dotenv

load_dotenv()

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

Gerando um token de acesso

A primeira etapa para usar a API é gerar um token de acesso. Este token é válido por 30 minutos e deve ser usado para autenticar todas as solicitações de 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')

Buscando dados de campanha

Depois de obter o token de acesso, você pode começar a buscar dados da API. Por exemplo, para obter uma lista de suas campanhas publicitárias, você pode usar o seguinte código:

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

Solicitando estatísticas de promoção

Para obter estatísticas de promoção, você precisa enviar uma solicitação POST com o intervalo de datas e os IDs da campanha. A API retornará um ID de relatório, que você pode usar para verificar o status do relatório e baixá-lo quando estiver pronto.

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

Verificando o status do relatório e baixando

Após solicitar o relatório, verifique seu status periodicamente até que esteja pronto para download. O relatório geralmente está disponível como um arquivo ZIP se houver várias campanhas.

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)

Extraindo e processando dados

Após o download do arquivo ZIP, extraia seu conteúdo e processe os arquivos CSV para analisar os dados.

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)

Tabela de exemplo: estatísticas de promoção

Conclusão

Automatizar a análise de promoção usando a API da Ozon pode aumentar muito a eficiência de seu marketing e fornecer insights mais profundos sobre suas campanhas. Seguindo as etapas descritas neste artigo, você pode aproveitar o poder da API da Ozon para agilizar seus esforços promocionais. Não se esqueça de verificar regularmente o status dos seus relatórios e manusear os dados extraídos com cuidado para garantir uma análise precisa. Boa automação!