Algorytmy

Algorytmy emisji określają sposób doboru reklam w poszczególnych jednostkach reklamowych. Każde miejsce reklamowe może mieć przypisany konkretny algorytm, który decyduje o strategii wyszukiwania i rankingu produktów lub banerów.

Algorytmy dla ofert sponsorowanych

Bestsellery

Algorytm dobierający popularne produkty na podstawie wskaźników popularności.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia

Parametry opcjonalne:

searchData - fraza wyszukiwania do filtrowania
categories / categoryPaths - kategorie do filtrowania
productTitle - tytuł produktu do uwzględnienia
excludedShopProductIds - produkty do wykluczenia
priceMin / priceMax - zakres cenowy
currency - waluta
brand - marka
attributes - dodatkowe atrybuty
adType - typ reklamy (ALL/AUTOPROMO/SPONSORED)

Uwaga: Wariant BESTSELLERS_WIDE ignoruje filtrowanie po priceMin/priceMax, brand, categoryPaths ani attributes.

POST https://dispatcher.ahevds.com/v1/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
      "adCount": 3,
      "searchData": "zabawki",
      "categoryPaths": ["Dziecko > Zabawki"]
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
          "adCount": 3,
          "searchData": "zabawki",
          "categoryPaths": ["Dziecko > Zabawki"]
        }
      ]
    }'

Dopasowanie do kontekstu

Algorytm dopasowujący produkty na podstawie frazy wyszukiwania i/lub kategorii.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
searchData LUB (categories / categoryPaths) - wymagane są searchData lub kategorie (co najmniej jeden z parametrów)

Parametry opcjonalne:

excludedShopProductIds - produkty do wykluczenia
priceMin / priceMax - zakres cenowy
currency - waluta
brand - marka
attributes - dodatkowe atrybuty
adType - typ reklamy

POST https://dispatcher.ahevds.com/v1/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
      "adCount": 2,
      "searchData": "karma dla kota",
      "categoryPaths": ["Zwierzęta > Koty > Karma"]
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
          "adCount": 2,
          "searchData": "karma dla kota",
          "categoryPaths": ["Zwierzęta > Koty > Karma"]
        }
      ]
    }'

Produkty o podobnej kategorii i tytule

Algorytm wyszukujący produkty podobne do bieżącego na podstawie analizy tytułu.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
productTitle - tytuł produktu referencyjnego

Parametry opcjonalne:

excludedShopProductIds - produkty do wykluczenia
priceMin / priceMax - zakres cenowy
currency - waluta
brand - marka
categories / categoryPaths - kategorie do filtrowania
attributes - dodatkowe atrybuty
adType - typ reklamy

POST https://dispatcher.ahevds.com/v1/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
      "adCount": 4,
      "productTitle": "Kosz na Zabawki Duży - Silver Mint",
      "excludeShopProductsIds": ["BAS-FOR-TOY-SIL-MIN"]
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
          "adCount": 4,
          "productTitle": "Kosz na Zabawki Duży - Silver Mint",
          "excludeShopProductsIds": ["BAS-FOR-TOY-SIL-MIN"]
        }
      ]
    }'

Produkty o podobnym tytule

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
productTitle - tytuł produktu referencyjnego

Parametry opcjonalne:

excludedShopProductIds - produkty do wykluczenia
priceMin / priceMax - zakres cenowy
currency - waluta
brand - marka
categories / categoryPaths - kategorie do filtrowania
attributes - dodatkowe atrybuty
adType - typ reklamy

Produkty o podobnej kategorii

Algorytm wyszukujący podobne produkty na podstawie kategorii.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
categories LUB categoryPaths - kategorie referencyjne

Parametry opcjonalne:

productTitle - tytuł produktu do uwzględnienia
excludedShopProductIds - produkty do wykluczenia
priceMin / priceMax - zakres cenowy
currency - waluta
brand - marka
attributes - dodatkowe atrybuty
adType - typ reklamy

Podobne produkty (wg ID produktu)

Algorytm wyszukujący produkty podobne do konkretnego produktu o określonym ID.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
productId - ID produktu referencyjnego. Dopuszalne jest g:id oraz ah:productId z feeda.

Parametry opcjonalne:

excludedShopProductIds - produkty do wykluczenia
currency - waluta
adType - typ reklamy

POST https://dispatcher.ahevds.com/v1/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
      "adCount": 3,
      "productId": "BAS-FOR-TOY-SIL-MIN"
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
          "adCount": 3,
          "productId": "BAS-FOR-TOY-SIL-MIN"
        }
      ]
    }'

Inni kupowali również

Algorytm rekomendacji oparty na uczeniu maszynowym wykorzystujący silnik rekomendacji.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
shopProductId - ID produktu dla którego generowane są rekomendacje

Parametry opcjonalne:

excludedShopProductIds - produkty do wykluczenia
adType - typ reklamy

POST https://dispatcher.ahevds.com/v1/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
      "adCount": 5,
      "shopProductId": "BAS-FOR-TOY-SIL-MIN"
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
          "adCount": 5,
          "shopProductId": "BAS-FOR-TOY-SIL-MIN"
        }
      ]
    }'

Dopasowanie zewnętrzne (EXACT_PRODUCT_ID)

Algorytm wyszukujący dokładnie określone produkty na podstawie listy ID.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
productIds - tablica ID produktów (maksymalnie 100 elementów). Dopuszalne jest g:id oraz ah:productId z feeda.

Parametry opcjonalne:

excludedShopProductIds - produkty do wykluczenia
priceMin / priceMax - zakres cenowy
currency - waluta
brand - marka
categories / categoryPaths - kategorie do filtrowania
attributes - dodatkowe atrybuty
adType - typ reklamy

Walidacja: Lista productIds jest wymagana i może zawierać maksymalnie 100 elementów.

POST https://dispatcher.ahevds.com/v1/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
      "adCount": 2,
      "productIds": [
        "BAS-FOR-TOY-SIL-MIN",
        "BAS-FOR-TOY-BLU-MIN"
      ]
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "a64bb352-32c4-4742-8108-f6fd3358e4e3",
          "adCount": 2,
          "productIds": [
            "BAS-FOR-TOY-SIL-MIN",
            "BAS-FOR-TOY-BLU-MIN"
          ]
        }
      ]
    }'

Algorytmy dla reklamy graficznej

DISPLAY

Podstawowy algorytm wyświetlania banerów z kompleksowym targetowaniem.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
country - kod kraju (jedyny walidowany jako wymagany)

Parametry opcjonalne:

searchData - fraza wyszukiwania
currency - waluta
productTitle - tytuł produktu
productId - ID produktu w kontekście
categoryPaths - ścieżki kategorii
brand - marka
profiles - profile użytkownika
adType - typ reklamy
adFormatIds - ID formatów reklamowych

Dodatkowe: Obsługuje nagłówek Referer dla targetowania na podstawie URL.

POST https://dispatcher.ahevds.com/v1/banner/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "8cc4ba26-bb96-46f1-975c-a6a21243bb05",
      "adCount": 1,
      "country": "PL",
      "searchData": "zabawki",
      "categoryPaths": ["Dziecko > Zabawki"]
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/banner/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "8cc4ba26-bb96-46f1-975c-a6a21243bb05",
          "adCount": 1,
          "country": "PL",
          "searchData": "zabawki",
          "categoryPaths": ["Dziecko > Zabawki"]
        }
      ]
    }'

DISPLAY_PHRASE_OR_CATEGORY

Algorytm targetowania banerów na podstawie fraz wyszukiwania lub kategorii.

Parametry wymagane:

slotHash - identyfikator jednostki reklamowej
adCount - liczba reklam do zwrócenia
country - kod kraju (jedyny walidowany jako wymagany)

Parametry opcjonalne:

searchData - fraza wyszukiwania
categoryPaths - ścieżki kategorii
productId - ID produktu
brand - marka
profiles - profile użytkownika
adType - typ reklamy
adFormatIds - ID formatów reklamowych

POST https://dispatcher.ahevds.com/v1/banner/dsa/raw/batch HTTP/2
Content-Type: application/json
cid: {cid}
uid: {uid}

{
  "targeting": [
    {
      "slotHash": "8cc4ba26-bb96-46f1-975c-a6a21243bb05",
      "adCount": 2,
      "country": "PL",
      "searchData": "telefony",
      "categoryPaths": ["Elektronika > Telefony"],
      "profiles": ["premium_client"]
    }
  ]
}

curl --location --request POST 'https://dispatcher.ahevds.com/v1/banner/dsa/raw/batch' \
    --header 'Content-Type: application/json' \
    --header 'cid: {cid}' \
    --header 'uid: {uid}' \
    --data-raw '{
      "targeting": [
        {
          "slotHash": "8cc4ba26-bb96-46f1-975c-a6a21243bb05",
          "adCount": 2,
          "country": "PL",
          "searchData": "telefony",
          "categoryPaths": ["Elektronika > Telefony"],
          "profiles": ["premium_client"]
        }
      ]
    }'

Parametry globalne

Parametry dostępne dla wszystkich algorytmów:

Parametr	Opis	Zastosowanie
Nagłówki
`cid`	Client ID	Wszystkie algorytmy
`uid`	User ID	Wszystkie algorytmy
`Referer`	URL strony	Algorytmy banerowe
Filtry
`excludeShopProductsIds`	Produkty do wykluczenia	Algorytmy produktowe
`priceMin` / `priceMax`	Zakres cenowy	Wszystkie algorytmy
`currency`	Waluta (ISO-4217)	Wszystkie algorytmy
`brand`	Marka	Wszystkie algorytmy
`attributes`	Dodatkowe atrybuty	Wszystkie algorytmy
`adType`	Typ reklamy (ALL/AUTOPROMO/SPONSORED)	Wszystkie algorytmy
Targetowanie
`businessSlotId`	ID slotu biznesowego	Wszystkie algorytmy
`categories` / `categoryPaths`	Kategorie	Wszystkie algorytmy
`profiles`	Profile użytkownika	Algorytmy banerowe
Meta
`lang`	Język	Wszystkie algorytmy
`country`	Kraj	Wszystkie algorytmy

Różnice między wariantami WIDE

Warianty algorytmów z sufiksem _WIDE zapewniają szersze dopasowanie z bardziej elastycznymi ograniczeniami:

Standardowe algorytmy: Ściślejsze kryteria dopasowania, wyższy precision
Warianty WIDE: Luźniejsze kryteria dopasowania, wyższy recall

Informacje o emisji Sponsored Products Deprecated