Package madden.ingestion.offer

색인

ActionType

[START action_type_definition] 혜택의 처리 모드를 나타냅니다. 여러 주문 처리 모드에서 혜택을 공유할 수 있는 경우 각 주문 처리 모드에 대해 중복 혜택이 생성됩니다.

열거형
ACTION_TYPE_UNSPECIFIED
ACTION_TYPE_FOOD_DELIVERY 이 혜택은 음식 배달 서비스에 적용됩니다.
ACTION_TYPE_FOOD_TAKEOUT 이 혜택은 음식 테이크아웃 또는 픽업 주문에 적용됩니다.
ACTION_TYPE_DINING 이 혜택은 레스토랑 내 식사에 적용됩니다.
ACTION_TYPE_SHOPPING_IN_STORE 이 혜택은 오프라인 매장 쇼핑 구매에 적용됩니다.

AdditionalFee

[START additional_fee_definition]

필드
name

string

추가 수수료의 이름입니다. 예: 편의 수수료, 취급 수수료 등. 필수입니다.
fee

Fee

쿠폰

[START coupon_definition]

필드
text

string

혜택 제공업체가 사용자에게 표시하고자 하는 쿠폰 텍스트입니다.
code

string

혜택을 사용하려면 쿠폰 코드가 필요합니다. 필수 항목입니다.

수수료

[START fee_definition] 다음 ID: 5

필드
unit

FeeUnit
type

FeeType

통합 필드 cost.

cost는 다음 중 하나여야 합니다.
amount

Money
amount_range

MoneyRange

FeeType

[START fee_type_definition]

열거형
FEE_TYPE_UNSPECIFIED UNSPECIFIED 또는 기본 enum 값은 피드에서 사용하면 안 됩니다.
FEE_TYPE_FIXED
FEE_TYPE_VARIABLE

FeeUnit

[START fee_unit_definition]

열거형
FEE_UNIT_UNSPECIFIED UNSPECIFIED 또는 기본 enum 값은 피드에서 사용하면 안 됩니다.
FEE_UNIT_PER_GUEST
FEE_UNIT_PER_TRANSACTION

FixedDenominations

필드
amounts[]

Money

사용 가능한 모든 개별 금액 목록입니다 (예: [100, 500, 1000]).

FoodOfferRestrictions

[START food_offer_restrictions_definition]

필드
meal_types[]

MealType

혜택이 적용될 수 있는 식사 유형(예: 점심 또는 저녁)입니다. 설정하지 않으면 혜택이 모든 식사 유형에 적용될 수 있습니다.
restricted_to_certain_courses

bool

혜택이 특정 과정에만 적용될 수 있는지 여부입니다.

GiftCardInfo

[START gift_card_info_definition]

필드

통합 필드 denomination_type.

denomination_type는 다음 중 하나여야 합니다.
fixed_denominations

FixedDenominations

기프트 카드가 특정 고정 금액으로 제공되는 경우에 사용됩니다.
custom_range

MoneyRange

브랜드에서 사용자가 정의된 범위 내에서 맞춤 (유연한) 액면가를 선택할 수 있도록 허용하는 경우에 사용됩니다.

MealType

[START meal_type_definition]

열거형
MEAL_TYPE_UNSPECIFIED UNSPECIFIED 또는 기본 enum 값은 피드에서 사용하면 안 됩니다.
MEAL_TYPE_BREAKFAST
MEAL_TYPE_LUNCH
MEAL_TYPE_DINNER

MoneyRange

[START money_range_definition]

필드
min_amount

Money
max_amount

Money

혜택

LINT.IfChange(offer_definition) [START offer_definition] 다음 태그: 26

필드
offer_id

string

혜택의 고유 ID입니다. 필수 항목입니다.
entity_ids[]

string

이 혜택에 참여하는 판매자 목록입니다.
add_on_offer_applicable_to_all_entities

bool

true인 경우 이 혜택은 애그리게이터의 모든 항목에 적용됩니다. 부가기능 혜택에만 적용됩니다.
offer_source

OfferSource

혜택은 애그리게이터, 개별 판매자 또는 서드 파티가 부가기능으로 제공할 수 있습니다. 필수 항목입니다.
action_type

ActionType

혜택을 제공하는 서비스입니다. offer_id는 하나의 action_type에만 속할 수 있습니다. 혜택을 여러 서비스 유형에서 공유할 수 있는 경우 각 서비스 유형에 대해 고유한 ID가 있는 중복 혜택이 생성되어야 합니다. 필수 항목입니다.
offer_modes[]

OfferMode

혜택을 이용할 수 있는 방법(예: 방문, 예약, 온라인)입니다. 필수입니다.
offer_category

OfferCategory

혜택의 카테고리입니다. 필수 항목입니다.
source_assigned_priority

int32

소스에서 할당한 혜택의 우선순위 수준을 나타내는 음수가 아닌 정수 ([1~100], 1이 가장 높은 우선순위)입니다. 동일한 판매자에 대해 여러 혜택이 제공되는 경우 이는 혜택 순위 지정의 신호가 됩니다. 0은 우선순위가 설정되지 않았음을 나타냅니다.
offer_details

OfferDetails

할인, 예약 비용 등 혜택의 세부정보입니다. 필수입니다.
offer_restrictions

OfferRestrictions

혜택이 제한되는 방식을 설명합니다(예: 정기 결제/결제 수단이 필요한지, 이 혜택을 다른 혜택과 결합할 수 있는지(및 어떤 유형인지) 등). 필수입니다.
coupon

Coupon

쿠폰의 세부정보입니다. offer_category가 OFFER_CATEGORY_ADD_ON_COUPON_OFFER인 경우 필수입니다.
payment_instrument

PaymentInstrument

결제 수단의 세부정보입니다. offer_category가 OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER인 경우 필수입니다.
subscription

Subscription

정기 결제의 세부정보입니다. offer_category가 OFFER_CATEGORY_ADD_ON_SUBSCRIPTION_OFFER인 경우 필수입니다.
terms

Terms

혜택 이용약관입니다. 필수 항목입니다.
validity_periods[]

ValidityPeriod

혜택의 유효 기간입니다. 시작 시간, 종료 시간, 요일 등 혜택이 유효한 기간을 설명합니다. 필수입니다.
offer_url

string

판매자의 혜택 페이지 URL입니다. offer_category가 OFFER_CATEGORY_BASE_OFFER인 경우 필수입니다.
image_url

string

판매자의 혜택 이미지 URL입니다.
tags[]

OfferTag

혜택과 연결된 특수 태그입니다. '연말연시', '인기', '가장 많이 예약됨'과 같은 특별 혜택을 식별하는 데 사용됩니다.
brand_id

string

기프트 카드 거래에서 거래를 제공하는 브랜드를 식별하는 데 필요합니다.

OfferCategory

[START offer_category_definition] 혜택의 카테고리입니다. 기본 혜택은 모든 고객에게 제공되는 표준 혜택입니다(예: 100달러 이상 지출 시 10% 할인). 쿠폰 또는 결제 수단으로 제한된 기본 혜택에는 해당 필드가 설정됩니다. ADD_ON_PAYMENT_OFFER와 같은 애드온 x 혜택도 있습니다. 이러한 혜택은 다른 혜택에 추가하여 추가 할인을 받을 수 있습니다.

열거형
OFFER_CATEGORY_UNSPECIFIED UNSPECIFIED 또는 기본 enum 값은 피드에서 사용하면 안 됩니다.
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]

필드
description

string

OfferDetails

[START offer_details_definition] 다음 태그: 15

필드
offer_display_text

string

상품 제공업체가 검색 결과 페이지에 고객에게 표시하고자 하는 상품 텍스트입니다. 필수 항목입니다.
max_discount_value

Money

이용할 수 있는 최대 할인입니다. 예를 들어 최대 100달러까지 10% 할인됩니다.
min_spend_value

Money

할인을 받기 위한 최소 지출 금액입니다. 예를 들어 총 가격이 100달러 이상인 경우 10% 할인됩니다.
booking_cost

Money

이 혜택을 예약하는 데 드는 비용입니다. 예를 들어 테이블을 $15에 예약하면 최종 청구액에서 $100 할인됩니다.
booking_cost_unit

FeeUnit

예약 비용의 단위입니다. 예를 들어 사용자별, 거래별로 설정할 수 있습니다.
convenience_fee

Fee
booking_cost_adjustable

bool

예약 비용이 조정 가능한지 여부입니다. 즉, 예약 비용이 최종 청구서에서 차감됩니다. 예: 예약 시 저녁 식사 30% 할인 예약 비용은 15달러이며 최종 청구서에 적용됩니다. 따라서 최종 청구액은 총 지출액 - 30% - $15입니다.
additional_fees[]

AdditionalFee

사용자에게 청구되는 추가 수수료입니다. 예: 편의, 취급, 배송, 포장, 서비스 수수료 등
gift_card_info

GiftCardInfo

기프트 카드 할인에 대한 세부정보입니다.
통합 필드 offer_specification. 할인은 총 금액에서 차감되는 비율 또는 고정 금액일 수 있습니다. 예: 1. 최종 청구서 10% 할인 2. 주문 시 15달러 할인 판매자는 관련 사양 필드를 통해 '하나 구매 시 하나 무료'와 같은 맞춤 할인을 제공할 수도 있습니다. 필수 항목입니다. offer_specification은 다음 중 하나여야 합니다.
discount_percent

float

할인된 청구서의 비율입니다. [0, 100] 전체 식사에 적용되는 1+1 또는 50% 할인 혜택 (예: 1+1 뷔페, 전체 청구서 1+1, 세트 메뉴 1+1)의 경우 이 값을 50으로 설정할 수 있습니다.
discount_value

Money

할인의 고정 값입니다.
other_offer_detail_text

string

할인을 설명하는 자유 형식 텍스트입니다. 특정 1+1 혜택 (예: 1+1 음료, +1 메인 요리, 1+1 선택 메뉴 항목)의 경우 세부정보를 여기에 설명해야 합니다.

OfferMode

[START offer_mode_definition] 사용자가 혜택을 이용할 수 있는 방법 또는 채널을 지정합니다.

열거형
OFFER_MODE_OTHER 다른 특정 모드에서 다루지 않는 주문 처리 방법에 사용됩니다.
OFFER_MODE_WALK_IN 사전 예약 없이 현장 방문 시 혜택을 이용할 수 있습니다.
OFFER_MODE_FREE_RESERVATION 이 혜택은 사용자가 선불 요금이 필요하지 않은 예약을 할 때 적용됩니다.
OFFER_MODE_PAID_RESERVATION 이 혜택은 사용자가 선불 결제가 필요한 예약을 할 때 적용됩니다.
OFFER_MODE_ONLINE_ORDER 이 혜택은 웹사이트 또는 디지털 플랫폼을 통해 주문한 경우에 유효합니다.
OFFER_MODE_GIFT_CARD_PURCHASE 기프트 카드 구매가 혜택을 획득하는 데 필요한 기본 단계임을 나타냅니다.

OfferRestrictions

[START offer_restrictions_definition] 다음 태그: 11

필드
combinable_with_other_offers

bool

이 혜택을 다른 혜택과 함께 사용할 수 있는지 여부입니다. true인 경우 파트너는 이 혜택과 결합할 수 있는 혜택을 지정할 수 있습니다. combinable_offer_categories와 combinable_offer_ids가 모두 설정된 경우 위의 조건 중 하나와 일치하는 혜택은 조합 가능합니다.
combinable_offer_categories[]

OfferCategory

이 혜택과 결합할 수 있는 혜택 유형 목록입니다. 예를 들어 이 혜택은 다른 쿠폰과 함께 사용할 수 있습니다. combinable_with_other_offers가 true이고 이 필드가 설정되지 않은 경우 모든 유형을 결합할 수 있습니다.
combinable_offer_ids[]

string

이 혜택과 함께 사용할 수 있는 offer_id 목록입니다. 일부 혜택은 특정 다른 offer_id (상위 혜택으로 간주될 수 있음)와만 결합할 수 있습니다. combinable_with_other_offers가 true이고 이 필드가 설정되지 않은 경우 모든 혜택 ID를 결합할 수 있습니다.
inclusions[]

OfferCondition

혜택이 유효하려면 충족해야 하는 조건 목록 (예: 무알코올 음료, 음식)
exclusions[]

OfferCondition

혜택을 무효화하는 조건 목록 (예: 뷔페, 콤보 혜택, 칵테일)
min_guest

int32

혜택을 이용하는 데 필요한 최소 인원수입니다.
food_offer_restrictions

FoodOfferRestrictions

음식 혜택에 적용되는 제한사항입니다.
special_conditions[]

string

사용자에게 표시해야 하는 이 혜택의 특별 조건입니다. 예: '[지역]에서만 결제 가능', '온라인 결제 제외'

OfferSource

[START offer_source_definition]

열거형
OFFER_SOURCE_UNSPECIFIED
OFFER_SOURCE_AGGREGATOR

OfferTag

[START offer_tag_definition]

열거형
OFFER_TAG_UNSPECIFIED UNSPECIFIED 또는 기본 enum 값은 피드에서 사용하면 안 됩니다.
OFFER_TAG_NEW_YEAR_SPECIAL
OFFER_TAG_VALENTINES_SPECIAL

PaymentInstrument

[START payment_instrument_definition]

필드
items[]

PaymentInstrumentItem

혜택을 이용하는 데 사용할 수 있는 결제 수단 목록입니다. 필수 항목입니다.
provider_name

string

결제 수단 제공업체의 이름입니다. 은행 파트너, 은행 이름 등이 될 수 있습니다. 예를 들면 American Express, HDFC, ICICI가 있습니다.

PaymentInstrumentItem

[START payment_instrument_item_definition]

필드
type

PaymentInstrumentType

결제 수단의 유형입니다. 필수 항목입니다.
name

string

신용카드 이름과 같은 결제 수단 항목의 이름입니다. 예: HDFC Infinia, American Express Platinum 필수 항목입니다.

PaymentInstrumentType

[START payment_instrument_type_definition]

열거형
PAYMENT_INSTRUMENT_TYPE_UNSPECIFIED UNSPECIFIED 또는 기본 enum 값은 피드에서 사용하면 안 됩니다.
PAYMENT_INSTRUMENT_CREDIT_CARD
PAYMENT_INSTRUMENT_DEBIT_CARD
PAYMENT_INSTRUMENT_BANK_ACCOUNT
PAYMENT_INSTRUMENT_UPI
PAYMENT_INSTRUMENT_ONLINE_WALLET
PAYMENT_INSTRUMENT_NETBANKING

구독

[START subscription_definition]

필드
name

string

구독 이름입니다. 필수 항목입니다.
subscription_auto_added

bool

사용자가 이 혜택을 이용할 때 정기 결제가 자동으로 추가되는지 여부입니다.
cost

Money

구독 비용입니다. 필수 항목입니다.
subscription_duration

Duration

구독이 subscription_cost로 유효한 기간입니다. 필수 항목입니다.
terms_and_conditions_url

string

이 정기 결제와 관련된 파트너의 이용약관 URL입니다.

약관

[START terms_definition]

필드
url

string

파트너의 이용약관 URL입니다.
restricted_to_certain_users

bool

혜택이 특정 사용자에게만 제공되는지 여부입니다.
terms_and_conditions

string

파트너가 제공한 기본 T&C 텍스트입니다.
additional_terms_and_conditions[]

string

파트너의 기본 이용약관 외에 적용되는 이용약관