Allegro REST API

gdzie?

Polska | polski | PLN
  • Pierwsze kroki
  • Informacje podstawowe
  • Główne procesy
  • Uwierzytelnianie i autoryzacja
  • Wzorzec Command
  • Glosariusz
  • Lista metod
  • Wystawianie oferty produktu
  • Serwisy zagraniczne Allegro
  • Zarządzanie ofertami
  • Oferty wielowariantowe
  • Pasuje do
  • Zarządzanie zgłoszeniami ofert do kampanii
  • Rabaty i promocje
  • Zamówienia
  • Wysyłam z Allegro
  • One Fulfillment by Allegro
  • Dyskusje i reklamacje
  • Konto i dane użytkownika
  • Centrum wiadomości
  • Sprawdzanie opłat
  • Wystawianie ogłoszeń
  • Afiliacja
  • Publiczne oferty
FAQ
  • Aktualności
  • Changelog
Dokumentacja
Regulamin
Kontakt
  • Moje aplikacje
  • Moje aplikacje (sandbox)
  • Newsletter
  • API Status
  1. Allegro REST API
  2. Afiliacja
Jak pobrać informacje o konwersji CPS

Afiliacja

Afiliacja to działalność Allegro mająca na celu wspieranie sprzedaży poprzez współpracę z partnerami, którzy promują oferty dostępne na platformie. To jednocześnie sposób na budowanie widoczności produktów oraz szansa dla partnerów na dodatkowy zarobek w oparciu o rzeczywiste efekty ich działań.

Zasoby z grupy Affiliate wykorzystują scope:

  • allegro:api:affiliate:read - umożliwia odczyt danych;
  • allegro:api:affiliate:write - umożliwia zarządzanie i edycję danych.

Zakres uprawnień Twojej aplikacji zmienisz z poziomu zakładki Zarządzanie aplikacjami Allegro.

Jak pobrać informacje o konwersji CPS

Aby pobrać listę konwersji CPS (Cost Per Sale) w ramach Allegro Affiliate Business, skorzystaj z GET /affiliate/conversions/cps. Przekaż nagłówek Accept w postaci “application/vnd.allegro.beta.v1+json”.

Listę możesz dostosować do swoich potrzeb za pomocą parametrów:

  • orderCreatedAt.gte - minimalna data i godzina utworzenia zamówienia;
  • orderCreatedAt.lte - maksymalna data i godzina utworzenia zamówienia;
  • lastModifiedAt.gte - minimalna data i godzina ostatniej zmiany konwersji;
  • lastModifiedAt.lte - maksymalna data i godzina ostatniej zmiany konwersji;
  • status - status konwersji, dostępne wartości: CREATED - utworzona , REJECTED - odrzucona, CONFIRMED - potwierdzona;
  • limit - określ liczbę konwersji, jaką chcesz otrzymać w odpowiedzi. Wartość domyślna to 1000, max 10000;
  • offset - wskaż miejsce, od którego chcesz pobrać następną porcję danych;
  • includePublisherUrlParameters - pole odpowiedzi o nazwie publisherUrlParameters zawiera parametry obecne w linku, z którego została dokonana konwersja. Parametry te przekazywane są w formie mapy, gdzie klucz to nazwa parametru, a wartość odpowiada wartości parametru. Wysyłane są jedynie parametry, których klucze zostały przekazane w parametrze zapytania o nazwie includePublisherUrlParameters, w celu zminimalizowania rozmiaru odpowiedzi.

Przykładowy request:

curl -X GET \
'https://api.allegro.pl/affiliate/conversions/cps’ \
-H 'Authorization: Bearer {token}' \
-H 'Accept: application/vnd.allegro.beta.v1+json' \

Przykładowy response:

{
  "conversions": [        // lista konwersji
    {
      "id": "2991e29e-5fbc-46f5-963a-65c326ba65c2",    // identyfikator konwersji
      "status": "CONFIRMED",    // status konwersji, dostępne wartości: CREATED, REJECTED, CONFIRMED
      "lastModifiedAt": "2024-11-30T15:17:05.130Z",    // data ostatniej zmiany konwersji
      "orderCreatedAt": "2024-11-25T15:00:05.150Z",    // data utworzenia zamówienia
      "quantity": 5,    // liczba przedmiotów
      "marketplace": {    // rynek zamówienia
        "id": "allegro-pl"
      },
      "offer": {
        "id": "11223344556",    // identyfikator oferty
        "category": {
          "id": "257929"    // kategoria
        },
        "unitPrice": {    // cena jednostkowa
          "amount": "100.00",    // kwota
          "currency": "PLN"    // waluta
        },
        "seller": {        
          "login": "login"    // login sprzedawcy
        }
      },
      "commission": {        
        "publisher": {    // prowizja wydawcy
          "amount": "1.00",    // kwota
          "currency": "PLN"    // waluta
        },
        "allegro": {    // prowizja Allegro
          "amount": "10.00",    // kwota
          "currency": "PLN"    // waluta
        }
      },
      "publisherUrlParameters": {    // parametry obecne w linku, z którego została dokonana konwersja. Wysyłane są jedynie parametry, 
        "param1": "value1",          // których klucze zostały przekazane w parametrze zapytania "includePublisherUrlParameters".
        "param2": "value2",
        "param3": "value3"
      }
    }
  ]
}

Zgłoś błąd lub zasugeruj zmianę

Czy ten artykuł był dla Ciebie przydatny?

Allegro

Serwisy Grupy Allegro

  • Allegro.cz
  • Allegro.sk
  • Allegro.hu
  • Mall.hr
  • Mimovrste.com
  • Onedelivery.cz

Dostosuj ustawienia wyświetlania

ustawienia dotyczą tylko tej przeglądarki