Package madden.ingestion.offer

Indice

ActionType

[START action_type_definition] Rappresenta la modalità di evasione dell'offerta. Se un'offerta può essere condivisa tra più modalità di evasione, è necessario creare offerte duplicate per ogni modalità di evasione.

Enum
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY L'offerta è applicabile ai servizi di consegna di cibo.
ACTION_TYPE_FOOD_TAKEOUT L'offerta è applicabile agli ordini di cibo da asporto o con ritiro.
ACTION_TYPE_DINING L'offerta è valida per i pasti consumati in loco presso un ristorante.
ACTION_TYPE_SHOPPING_IN_STORE L'offerta è applicabile agli acquisti offline in negozio.

AdditionalFee

[START additional_fee_definition]

Campi
name

string

Il nome della tariffa aggiuntiva. Esempi: commissione di servizio, costo di gestione e così via. Obbligatorio.
fee

Fee

Coupon

[START coupon_definition]

Campi
text

string

Il testo del coupon che il fornitore dell'offerta vuole mostrare agli utenti.
code

string

Codice promozionale richiesto per utilizzare l'offerta. Obbligatorio.

Commissione

[START fee_definition] Next ID: 5

Campi
unit

FeeUnit
type

FeeType

Campo unione cost.

cost può essere solo uno dei seguenti tipi:
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

Enum
FEE_TYPE_UNSPECIFIED Il valore enum UNSPECIFIED o predefinito non deve essere utilizzato nei feed.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

Enum
FEE_UNIT_UNSPECIFIED Il valore enum UNSPECIFIED o predefinito non deve essere utilizzato nei feed.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

Campi
amounts[]

Money

Un elenco di tutti i tagli discreti disponibili (ad es. [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

Campi
meal_types[]

MealType

I tipi di pasto a cui è possibile applicare l'offerta, ad esempio pranzo o cena. Se non viene impostato, l'offerta può essere applicata a tutti i tipi di pasti.
restricted_to_certain_courses

bool

Se l'offerta può essere applicata solo a determinati corsi.

GiftCardInfo

[START gift_card_info_definition]

Campi

Campo unione denomination_type.

denomination_type può essere solo uno dei seguenti tipi:
fixed_denominations

FixedDenominations

Utilizzato quando la carta regalo è disponibile in importi fissi specifici.
custom_range

MoneyRange

Utilizzato quando il brand consente agli utenti di scegliere un valore nominale personalizzato (flessibile) all'interno di un intervallo definito.

MealType

[START meal_type_definition]

Enum
MEAL_TYPE_UNSPECIFIED Il valore enum UNSPECIFIED o predefinito non deve essere utilizzato nei feed.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

Campi
min_amount

Money
max_amount

Money

Offerta

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

Campi
offer_id

string

ID univoco dell'offerta. Obbligatorio.
entity_ids[]

string

Elenco dei commercianti che partecipano a questa offerta.
add_on_offer_applicable_to_all_entities

bool

Se true, questa offerta è applicabile a tutte le entità dell'aggregatore. Valido solo per le offerte di componenti aggiuntivi.
offer_source

OfferSource

Un'offerta può essere fornita dall'aggregatore, da un singolo commerciante o anche da una terza parte come componente aggiuntivo. Obbligatorio.
action_type

ActionType

Il servizio che fornisce l'offerta. Un offer_id può appartenere a un solo action_type. Se un'offerta può essere condivisa tra più tipi di servizio, è necessario creare offerte duplicate con ID univoci per ogni tipo di servizio. Obbligatorio.
offer_modes[]

OfferMode

I metodi con cui è possibile usufruire dell'offerta: senza prenotazione, prenotazione, online e così via. Obbligatorio.
offer_category

OfferCategory

La categoria dell'offerta. Obbligatorio.
source_assigned_priority

int32

Numero intero non negativo ([1-100], dove 1 rappresenta la priorità più alta) che indica il livello di priorità dell'offerta assegnato dall'origine. Quando sono disponibili più offerte per lo stesso commerciante, questo sarà un indicatore per il ranking delle offerte. 0 indica che la priorità non è impostata.
offer_details

OfferDetails

Dettagli dell'offerta, ad esempio sconto, costo della prenotazione e così via. Obbligatorio.
offer_restrictions

OfferRestrictions

Descrive le limitazioni dell'offerta, ad esempio se è richiesto un abbonamento/strumento di pagamento, se l'offerta può essere combinata con altre offerte (e di quali tipi) e così via. Obbligatorio.
coupon

Coupon

Dettagli di un coupon. Obbligatorio per offer_category: OFFER_CATEGORY_ADD_ON_COUPON_OFFER.
payment_instrument

PaymentInstrument

Dettagli di uno strumento di pagamento. Obbligatorio per offer_category: OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER.
subscription

Subscription

Dettagli di una sottoscrizione. Obbligatorio per offer_category: OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER.
terms

Terms

Termini e condizioni dell'offerta. Obbligatorio.
validity_periods[]

ValidityPeriod

Il periodo di validità dell'offerta. Descrive il periodo di tempo per cui è valida l'offerta, incluse le ore di inizio e fine, i giorni della settimana e così via. Obbligatorio.
offer_url

string

URL della pagina dell'offerta del commerciante. Obbligatorio per offer_category: OFFER_CATEGORY_BASE_OFFER.
image_url

string

URL dell'immagine dell'offerta del commerciante.
tags[]

OfferTag

Tag speciali associati all'offerta. Viene utilizzato per identificare offerte speciali come "Festive", "Top Rated", "Most booked" e così via.
brand_id

string

Identifica il brand associato all'offerta. Se non impostato, viene utilizzato il brand predefinito.

OfferCategory

[START offer_category_definition] Category of the offer. Un'offerta di base è un'offerta standard disponibile per tutti i clienti, ad esempio uno sconto del 10% per una spesa superiore a 100 €. Un'offerta base limitata da un coupon o da uno strumento di pagamento avrà i rispettivi campi impostati. Abbiamo anche offerte aggiuntive x come ADD_ON_PAYMENT_OFFER. Queste offerte possono essere aggiunte ad altre offerte per ottenere sconti aggiuntivi.

Enum
OFFER_CATEGORY_UNSPECIFIED Il valore enum UNSPECIFIED o predefinito non deve essere utilizzato nei feed.
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]

Campi
description

string

OfferDetails

[START offer_details_definition] Next tag: 15

Campi
offer_display_text

string

Il testo dell'offerta che il fornitore dell'offerta vuole mostrare ai clienti nella pagina dei risultati di ricerca. Obbligatorio.
max_discount_value

Money

Lo sconto massimo di cui è possibile usufruire. Ad esempio, sconto del 10% fino a 100 €.
min_spend_value

Money

Il valore spesa minima per usufruire dello sconto. Ad esempio, 10% di sconto se il prezzo totale è pari o superiore a 100 $.
booking_cost

Money

Il costo per prenotare questa offerta. Ad esempio, 100 € di sconto sul conto finale quando un tavolo viene prenotato al costo di 15 €.
booking_cost_unit

FeeUnit

L'unità del costo di prenotazione. Ad esempio, per persona, per transazione.
convenience_fee

Fee
booking_cost_adjustable

bool

Se il costo della prenotazione è modificabile, ovvero se viene sottratto dalla fattura finale. Ad esempio: 30% di sconto sulla cena con prenotazione. Il costo della prenotazione è di 15 $e verrà applicato alla fattura finale. Quindi, la fattura finale sarà: Spesa totale - 30% - 15 $
additional_fees[]

AdditionalFee

Costi aggiuntivi addebitati all'utente. Esempi: commissioni di servizio, gestione, consegna, imballaggio, servizio e così via.
gift_card_info

GiftCardInfo

Dettagli specifici per le offerte sulle carte regalo.
Campo unione offer_specification. Lo sconto può essere una percentuale o un valore fisso sottratto dal valore totale. Ad esempio: 1. 10% di sconto sulla fattura finale. 2. 15 $ di sconto su un ordine. I commercianti possono anche offrire sconti personalizzati come "Prendi due, paghi uno" tramite i campi di specifica pertinenti. Obbligatorio. offer_specification può essere solo uno dei seguenti tipi:
discount_percent

float

Percentuale della fattura scontata. [0, 100] Per le offerte 1+1 o con sconto del 50% applicabili all'intero pasto (ad es. buffet 1+1, 1+1 sull'intero conto, 1+1 sul menu fisso), questo valore può essere impostato su 50.
discount_value

Money

Valore fisso dello sconto.
other_offer_detail_text

string

Testo in formato libero per descrivere lo sconto. Per offerte 1+1 specifiche (ad es. 1+1 bevande, +1 piatto principale, 1+1 voci di menu selezionate), questi dettagli devono essere descritti qui.

OfferMode

[START offer_mode_definition] Specifica il metodo o il canale tramite cui l'utente può usufruire dell'offerta.

Enum
OFFER_MODE_OTHER Utilizza per metodi di evasione non coperti da altre modalità specifiche.
OFFER_MODE_WALK_IN L'offerta è disponibile per le visite in loco senza prenotazione preventiva.
OFFER_MODE_FREE_RESERVATION L'offerta si applica quando un utente effettua una prenotazione che non richiede una tariffa anticipata.
OFFER_MODE_PAID_RESERVATION L'offerta si applica quando un utente effettua una prenotazione che richiede un pagamento anticipato.
OFFER_MODE_ONLINE_ORDER L'offerta è valida per gli ordini effettuati tramite un sito web o una piattaforma digitale.
OFFER_MODE_GIFT_CARD_PURCHASE Indica che l'acquisto di una carta regalo è il passaggio principale richiesto per ottenere l'offerta.

OfferRestrictions

[START offer_restrictions_definition] Next tag: 11

Campi
combinable_with_other_offers

bool

Se questa offerta è cumulabile con altre offerte. Se impostato su true, i partner possono specificare con quali offerte è possibile combinare questa offerta. Se sono impostati sia combinable_offer_categories che combinable_offer_ids, qualsiasi offerta che corrisponde a una delle condizioni precedenti sarà combinabile.
combinable_offer_categories[]

OfferCategory

Elenco dei tipi di offerta con cui è possibile combinare questa offerta. Ad esempio, questa offerta potrebbe essere cumulabile con altri Coupon. Se combinable_with_other_offers è impostato su true e questo campo non è impostato, tutti i tipi saranno combinabili.
combinable_offer_ids[]

string

Elenco di offer_id con cui è possibile combinare questa offerta. Alcune offerte possono essere combinate solo con altri offer_id specifici (che possono essere considerati offerte principali). Se combinable_with_other_offers è true e questo campo non è impostato, tutti gli ID offerta saranno combinabili.
inclusions[]

OfferCondition

Elenco delle condizioni che devono essere soddisfatte affinché l'offerta sia valida (ad es. bevande analcoliche, cibo).
exclusions[]

OfferCondition

Elenco delle condizioni che invaliderebbero l'offerta (ad es. buffet, offerte combinate e cocktail).
min_guest

int32

Il numero minimo di persone richiesto per usufruire dell'offerta.
food_offer_restrictions

FoodOfferRestrictions

Limitazioni specifiche per le offerte di cibo.
special_conditions[]

string

Condizioni speciali per questa offerta che devono essere mostrate all'utente. Esempi: "Valido solo per il pagamento in [area]", "Esclude i pagamenti online"

OfferSource

[START offer_source_definition]

Enum
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

Enum
OFFER_TAG_UNSPECIFIED Il valore enum UNSPECIFIED o predefinito non deve essere utilizzato nei feed.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

Campi
items[]

PaymentInstrumentItem

Elenco degli strumenti di pagamento che possono essere utilizzati per usufruire dell'offerta. Obbligatorio.
provider_name

string

Nome del fornitore dello strumento di pagamento. Potrebbe trattarsi di un partner bancario, del nome di una banca e così via. Ad esempio: American Express, HDFC, ICICI.

PaymentInstrumentItem

[START payment_instrument_item_definition]

Campi
type

PaymentInstrumentType

Tipo di strumento di pagamento. Obbligatorio.
name

string

Nome dell'elemento dello strumento di pagamento, ad esempio il nome della carta di credito. Ad esempio: HDFC Infinia, American Express Platinum. Obbligatorio.

PaymentInstrumentType

[START payment_instrument_type_definition]

Enum
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED Il valore enum UNSPECIFIED o predefinito non deve essere utilizzato nei feed.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

Abbonamento

[START subscription_definition]

Campi
name

string

Il nome della sottoscrizione. Obbligatorio.
subscription_auto_added

bool

Indica se l'abbonamento viene aggiunto automaticamente quando un utente usufruisce di questa offerta
cost

Money

Il costo dell'abbonamento. Obbligatorio.
subscription_duration

Duration

La durata della validità dell'abbonamento al costo dell'abbonamento [subscription_cost]. Obbligatorio.
terms_and_conditions_url

string

URL dei Termini e condizioni del partner relativi a questo abbonamento.

Termini

[START terms_definition]

Campi
url

string

URL dei Termini e condizioni del partner.
restricted_to_certain_users

bool

Se l'offerta è limitata a determinati utenti.
terms_and_conditions

string

Testo dei Termini e condizioni principali fornito dal partner.
additional_terms_and_conditions[]

string

Termini e condizioni aggiuntivi rispetto ai T&C principali del partner.