[NEWS] Allegro Affiliate Business - udostępniliśmy zasób do pobierania informacji o konwersji CPS / Allegro Affiliate Business - we have provided a resource for retrieving CPS conversion information

[Allegro Affiliate Business](https://allegro.pl/programy-lojalnosciowe/allegro-affiliate?srsltid=AfmBOoo7pybe55TbmROKEX2V9_jMePyN0SIozHtRq74ywpPraqyttmjZ) to program partnerski Allegro, który ma na celu zwiększenie sprzedaży milionów produktów dostępnych na platformie, jednocześnie stanowiąc świetną okazję dla wydawców afiliacyjnych do zwiększenia swoich dochodów. Gdy klient kupi polecony produkt lub usługę za pośrednictwem linku afiliacyjnego, wydawca otrzymuje prowizję. W rezultacie reklamodawcy mogą znacznie poszerzyć swoje zasięgi i bazę klientów, a afilianci mają szansę na generowanie dochodu pasywnego, wykorzystując swoją obecność i pozycję w internecie.

**Co zmieniliśmy?**

Udostępniliśmy dzisiaj w wersji beta zasób [GET /affiliate/conversions/cps](https://developer.allegro.pl/documentation/#operation/getCpsConversions), który pozwala na pobranie listy konwersji CPS (Cost Per Sale). Aby skorzystać z zasobu, przekaż nagłówek Accept w postaci “**application/vnd.allegro.beta.v1+json**”.

**Przykładowy request:**

```json5
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:**

```json5
{
"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"
}
}
]
}
```
>
**Dlaczego wprowadziliśmy zmianę?**

Wprowadziliśmy zmianę, aby zapewnić wydawcom Allegro Affiliate Business szybki i wygodny dostęp do danych, w tym informacji o konwersjach CPS. Dzięki temu mogą oni łatwiej analizować wyniki i optymalizować swoje działania afiliacyjne w czasie rzeczywistym.

Więcej informacji o nowym zasobie znajdziesz w [naszym poradniku](https://developer.allegro.pl/tutorials/afiliacja-0A1bPnwVwUq).

-----

[Allegro Affiliate Business](https://allegro.pl/programy-lojalnosciowe/allegro-affiliate?srsltid=AfmBOoo7pybe55TbmROKEX2V9_jMePyN0SIozHtRq74ywpPraqyttmjZ) is Allegro's affiliate program designed to increase sales of the millions of products available on the platform, while providing a great opportunity for affiliate publishers to increase their income. When a customer buys a referred product or service through an affiliate link, the publisher receives a commission. As a result, advertisers can greatly expand their reach and customer base, and affiliates have the opportunity to generate passive income by leveraging their online presence and position.

**What have we changed?**

We have released today in beta a [GET /affiliate/conversions/cps](https://developer.allegro.pl/documentation/#operation/getCpsConversions) resource that allows you to retrieve a list of CPS (Cost Per Sale) conversions. To use the resource, pass an Accept header in the form “**application/vnd.allegro.beta.v1+json**”.

**Sample request:**

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

```json5
{
"conversions": [ // conversions list
{
"id": "2991e29e-5fbc-46f5-963a-65c326ba65c2", // identifier of the conversion
"status": "CONFIRMED", // conversion status, available values: CREATED, REJECTED, CONFIRMED
"lastModifiedAt": "2024-11-30T15:17:05.130Z", // date of last conversion change
"orderCreatedAt": "2024-11-25T15:00:05.150Z", // order creation date
"quantity": 5, // number of items
"marketplace": { // marketplace identifier
"id": "allegro-pl"
},
"offer": {
"id": "11223344556", // offer identifier
"category": {
"id": "257929" // category
},
"unitPrice": { // unit price
"amount": "100.00", // amount
"currency": "PLN" // currency
},
"seller": {
"login": "login" // seller login
}
},
"commission": {
"publisher": { // publisher's commission
"amount": "1.00", // amount
"currency": "PLN" // currency
},
"allegro": { // Allegro's commission
"amount": "10.00", // amount
"currency": "PLN" // currency
}
},
"publisherUrlParameters": { // parameters present in the link from which the conversion was made. Only parameters whose keys
"param1": "value1", // were passed in the query parameter “includePublisherUrlParameters” are sent.
"param2": "value2",
"param3": "value3"
}
}
]
}
```
>
**Why have we made the change?**

We made the change to provide Allegro Affiliate Business publishers with fast and convenient access to data, including information on CPS conversions. This makes it easier for them to analyze results and optimize their affiliate efforts in real time.

You can find more information about the new resource in [our guide](https://developer.allegro.pl/tutorials/afiliacja-0A1bPnwVwUq).