Package madden.ingestion.offer

Indeks

ActionType

[START action_type_definition] Reprezentuje tryb realizacji oferty. Jeśli oferta może być udostępniana w kilku trybach realizacji, należy utworzyć zduplikowane oferty dla każdego trybu realizacji.

Wartości w polu enum
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY Oferta dotyczy usług dostawy jedzenia.
ACTION_TYPE_FOOD_TAKEOUT Oferta dotyczy zamówień jedzenia na wynos lub z odbiorem.
ACTION_TYPE_DINING Oferta dotyczy posiłków na miejscu w restauracji.
ACTION_TYPE_SHOPPING_IN_STORE Oferta dotyczy zakupów offline w sklepie stacjonarnym.

AdditionalFee

[START additional_fee_definition]

Pola
name

string

Nazwa opłaty dodatkowej. Przykłady: opłata manipulacyjna, opłata za obsługę itp. Wymagane.
fee

Fee

Kupon

[START coupon_definition]

Pola
text

string

Tekst kuponu, który dostawca oferty chce wyświetlać użytkownikom.
code

string

Aby skorzystać z oferty, musisz użyć kodu kuponu. Wymagane.

Opłata

[START fee_definition] Następny identyfikator: 5

Pola
unit

FeeUnit
type

FeeType

Pole zbiorcze cost.

Pole cost może mieć tylko jedną z tych wartości:
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

Wartości w polu enum
FEE_TYPE_UNSPECIFIED W plikach danych nie należy używać wartości wyliczeniowej UNSPECIFIED ani domyślnej.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Wartości w polu enum
FEE_UNIT_UNSPECIFIED W plikach danych nie należy używać wartości wyliczeniowej UNSPECIFIED ani domyślnej.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

Pola
amounts[]

Money

Lista wszystkich dostępnych nominałów (np. [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

Pola
meal_types[]

MealType

Rodzaje posiłków, do których można zastosować ofertę, np. lunch lub kolacja. Jeśli nie zostanie ustawiony, oferta może zostać zastosowana do wszystkich typów posiłków.
restricted_to_certain_courses

bool

Czy ofertę można zastosować tylko do określonych kursów.

GiftCardInfo

[START gift_card_info_definition]

Pola

Pole zbiorcze denomination_type.

Pole denomination_type może mieć tylko jedną z tych wartości:
fixed_denominations

FixedDenominations

Używane, gdy karta podarunkowa jest dostępna w określonych, stałych kwotach.
custom_range

MoneyRange

Używana, gdy marka umożliwia użytkownikom wybór niestandardowej (elastycznej) wartości nominalnej w określonym zakresie.

MealType

[START meal_type_definition]

Wartości w polu enum
MEAL_TYPE_UNSPECIFIED W plikach danych nie należy używać wartości wyliczeniowej UNSPECIFIED ani domyślnej.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

Pola
min_amount

Money
max_amount

Money

Oferta

LINT.IfChange(offer_definition) [START offer_definition] Next tag: 26

Pola
offer_id

string

Unikalny identyfikator oferty. Wymagane.
entity_ids[]

string

Lista sprzedawców, którzy biorą udział w tej ofercie.
add_on_offer_applicable_to_all_entities

bool

Jeśli wartość to „true”, oferta dotyczy wszystkich podmiotów w ramach agregatora. Dotyczy to tylko ofert dodatkowych.
offer_source

OfferSource

Oferta może być dostarczana przez agregatora, pojedynczego sprzedawcę, a nawet osobę trzecią jako dodatek. Wymagane.
action_type

ActionType

Usługa, która udostępnia ofertę. Identyfikator offer_id może należeć tylko do jednego typu action_type. Jeśli oferta może być udostępniana w ramach wielu typów usług, dla każdego typu usługi należy utworzyć zduplikowane oferty z unikalnymi identyfikatorami. Wymagane.
offer_modes[]

OfferMode

Sposoby skorzystania z oferty – wizyta w sklepie, rezerwacja, online itp. Wymagane.
offer_category

OfferCategory

Kategoria oferty. Wymagane.
source_assigned_priority

int32

Nieujemna liczba całkowita ([1–100], gdzie 1 oznacza najwyższy priorytet) wskazująca poziom priorytetu oferty przypisany przez źródło. Jeśli u tego samego sprzedawcy dostępnych jest kilka ofert, będzie to sygnał do rankingu ofert. Wartość 0 oznacza, że priorytet nie jest ustawiony.
offer_details

OfferDetails

Szczegóły oferty, takie jak rabat, koszt rezerwacji itp. Wymagane.
offer_restrictions

OfferRestrictions

Opisuje ograniczenia oferty, np. czy wymagana jest subskrypcja lub instrument płatniczy, czy ofertę można łączyć z innymi ofertami (i jakiego typu) itp. Wymagane.
coupon

Coupon

Szczegóły kuponu. Wymagany w przypadku offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.
payment_instrument

PaymentInstrument

Szczegóły instrumentu płatniczego. Wymagane w przypadku offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER.
subscription

Subscription

Szczegóły subskrypcji. Wymagany w przypadku offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER.
terms

Terms

Warunki oferty. Wymagane.
validity_periods[]

ValidityPeriod

Okres ważności oferty. Opisuje okres, w którym oferta jest ważna, w tym godziny rozpoczęcia i zakończenia, dni tygodnia itp. Wymagany.
offer_url

string

Adres URL strony z ofertą sprzedawcy. Wymagany w przypadku offer_category: OFFER_CATEGORY_BASE_OFFER.
image_url

string

Adres URL obrazu oferty sprzedawcy.
tags[]

OfferTag

Tagi specjalne powiązane z ofertą. Służy do identyfikowania ofert specjalnych, takich jak „Świąteczne”, „Najwyżej oceniane”, „Najczęściej rezerwowane” itp.
brand_id

string

Określa markę powiązaną z ofertą. Jeśli nie zostanie ustawiona, używana jest domyślna marka.

OfferCategory

[START offer_category_definition] Kategoria oferty. Oferta podstawowa to standardowa oferta dostępna dla wszystkich klientów, np. 10% zniżki na zakupy powyżej 100 zł. Oferta podstawowa ograniczona kuponem lub instrumentem płatniczym będzie miała ustawione odpowiednie pola. Mamy też oferty dodatków, takie jak ADD_ON_PAYMENT_OFFER. Takie oferty można łączyć z innymi, aby uzyskać dodatkowe rabaty.

Wartości w polu enum
OFFER_CATEGORY_UNSPECIFIED W plikach danych nie należy używać wartości wyliczeniowej UNSPECIFIED ani domyślnej.
OFFER_CATEGORY_BASE_OFFER
OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER
OFFER_CATEGORY_ADD_ON_COUPON_OFFER
OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER

OfferCondition

[START offer_condition_definition]

Pola
description

string

OfferDetails

[START offer_details_definition] Następny tag: 15

Pola
offer_display_text

string

Tekst oferty, który dostawca chce wyświetlać klientom na stronie wyników wyszukiwania. Wymagane.
max_discount_value

Money

Maksymalny rabat, jaki można uzyskać. Na przykład rabat 10% do 100 PLN.
min_spend_value

Money

Minimalne wydatki, aby skorzystać z rabatu. Na przykład 10% zniżki, gdy łączna cena wynosi co najmniej 100 PLN.
booking_cost

Money

Koszt rezerwacji tej oferty. Na przykład 100 zł zniżki na ostateczny rachunek, gdy stolik jest zarezerwowany za 15 zł.
booking_cost_unit

FeeUnit

Jednostka kosztu rezerwacji. np. za osobę lub za transakcję.
convenience_fee

Fee
booking_cost_adjustable

bool

Czy koszt rezerwacji można odliczyć, tzn. czy koszt rezerwacji jest odejmowany od rachunku końcowego. Na przykład: 30% zniżki na kolację po dokonaniu rezerwacji. Koszt rezerwacji wynosi 15 USD i zostanie doliczony do ostatecznego rachunku. Ostateczny rachunek: wydana kwota – 30% – 15 USD
additional_fees[]

AdditionalFee

Dodatkowe opłaty, które są pobierane od użytkownika. Przykłady: opłata za wygodę, obsługę, dostawę, opakowanie, usługę itp.
gift_card_info

GiftCardInfo

Szczegóły dotyczące ofert kart podarunkowych.
Pole zbiorcze offer_specification. Rabat może być wyrażony jako procent lub stała wartość odejmowana od łącznej wartości. Na przykład: 1. 10% zniżki od rachunku końcowego. 2. 15 USD zniżki na zamówienie. Sprzedawcy mogą też oferować niestandardowe rabaty, takie jak „kup jeden, drugi bezpłatnie”, korzystając z odpowiednich pól specyfikacji. Wymagane. offer_specification może mieć tylko jedną z tych wartości:
discount_percent

float

Procent rachunku, od którego naliczana jest zniżka. [0, 100] W przypadku ofert typu „1+1” lub „50% zniżki” obowiązujących na cały posiłek (np. 1+1 na bufet, 1+1 na cały rachunek, 1+1 na zestaw) wartość ta może wynosić 50.
discount_value

Money

Stała wartość rabatu.
other_offer_detail_text

string

Dowolny tekst opisujący rabat. W przypadku konkretnych ofert 1+1 (np. 1+1 napój, +1 danie główne, 1+1 wybrane pozycje menu) należy opisać te szczegóły tutaj.

OfferMode

[START offer_mode_definition] Określa metodę lub kanał, za pomocą którego użytkownik może skorzystać z oferty.

Wartości w polu enum
OFFER_MODE_OTHER Używaj w przypadku metod realizacji, które nie są objęte innymi konkretnymi trybami.
OFFER_MODE_WALK_IN Oferta jest dostępna w przypadku wizyt w obiekcie bez wcześniejszej rezerwacji.
OFFER_MODE_FREE_RESERVATION Oferta obowiązuje, gdy użytkownik dokonuje rezerwacji, która nie wymaga opłaty z góry.
OFFER_MODE_PAID_RESERVATION Oferta obowiązuje, gdy użytkownik dokonuje rezerwacji, która wymaga płatności z góry.
OFFER_MODE_ONLINE_ORDER Oferta dotyczy zamówień składanych na stronie internetowej lub platformie cyfrowej.
OFFER_MODE_GIFT_CARD_PURCHASE Oznacza, że zakup karty podarunkowej jest głównym krokiem wymaganym do skorzystania z oferty.

OfferRestrictions

[START offer_restrictions_definition] Next tag: 11

Pola
combinable_with_other_offers

bool

Czy tę ofertę można łączyć z innymi ofertami. Jeśli ta wartość jest prawdziwa, partnerzy mogą określić, z jakimi ofertami można łączyć tę ofertę. Jeśli ustawione są zarówno combinable_offer_categories, jak i combinable_offer_ids, można łączyć wszystkie oferty spełniające jeden z powyższych warunków.
combinable_offer_categories[]

OfferCategory

Lista typów ofert, z którymi można połączyć tę ofertę. Na przykład tę ofertę można łączyć z innymi kuponami. Jeśli atrybut combinable_with_other_offers ma wartość true, a to pole nie jest ustawione, wszystkie typy będą możliwe do łączenia.
combinable_offer_ids[]

string

Lista identyfikatorów ofert, z którymi można połączyć tę ofertę. Niektóre oferty można łączyć tylko z określonymi innymi identyfikatorami ofert (można je uznać za oferty nadrzędne). Jeśli parametr combinable_with_other_offers ma wartość „true”, a to pole nie jest ustawione, wszystkie identyfikatory ofert będą mogły być łączone.
inclusions[]

OfferCondition

Lista warunków, które muszą być spełnione, aby oferta była ważna (np. napoje bezalkoholowe, jedzenie).
exclusions[]

OfferCondition

Lista warunków, które unieważniają ofertę (np. bufet, oferty łączone i koktajle).
min_guest

int32

Minimalna liczba osób wymagana do skorzystania z oferty.
food_offer_restrictions

FoodOfferRestrictions

Ograniczenia dotyczące ofert gastronomicznych.
special_conditions[]

string

Specjalne warunki tej oferty, które muszą być wyświetlane użytkownikowi. Przykłady: „Tylko w przypadku płatności w [obszar]”, „Nie obejmuje płatności online”.

OfferSource

[START offer_source_definition]

Wartości w polu enum
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

Wartości w polu enum
OFFER_TAG_UNSPECIFIED W plikach danych nie należy używać wartości wyliczeniowej UNSPECIFIED ani wartości domyślnej.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

Pola
items[]

PaymentInstrumentItem

Lista instrumentów płatniczych, których można użyć do skorzystania z oferty. Wymagane.
provider_name

string

Nazwa dostawcy instrumentu płatniczego. Może to być partner bankowy, nazwa banku itp. Na przykład: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

Pola
type

PaymentInstrumentType

Rodzaj instrumentu płatniczego. Wymagane.
name

string

Nazwa elementu instrumentu płatniczego, np. nazwa karty kredytowej. Na przykład: HDFC Infinia, American Express Platinum. Wymagane.

PaymentInstrumentType

[START payment_instrument_type_definition]

Wartości w polu enum
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED W plikach danych nie należy używać wartości wyliczeniowej UNSPECIFIED ani wartości domyślnej.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

Subskrypcja

[START subscription_definition]

Pola
name

string

Nazwa subskrypcji. Wymagane.
subscription_auto_added

bool

Czy subskrypcja jest dodawana automatycznie, gdy użytkownik korzysta z tej oferty
cost

Money

Koszt subskrypcji. Wymagane.
subscription_duration

Duration

Okres ważności subskrypcji w ramach kosztu abonamentu. Wymagane.
terms_and_conditions_url

string

Adres URL warunków partnera dotyczących tej subskrypcji.

Warunki

[START terms_definition]

Pola
url

string

URL warunków korzystania z usługi partnera.
restricted_to_certain_users

bool

Czy oferta jest ograniczona do niektórych użytkowników.
terms_and_conditions

string

Główny tekst warunków dostarczony przez partnera.
additional_terms_and_conditions[]

string

Warunki dodatkowe oprócz głównych warunków partnera.