이 가이드에서는 음식 주문 혜택의 요구사항과 예를 강조합니다.
자격 요건 및 정책
이 섹션에서는 파트너가 혜택을 제공할 때 준수해야 하는 중요한 자격 기준을 강조합니다. 샌드박스 피드 테스트 중에 출시할 계획인 모든 혜택 유형을 테스트하는 것이 중요합니다. 혜택을 받을 수 있는지 확실하지 않은 경우 Google 담당자에게 문의하세요.
개인 맞춤 혜택 및 일회성 혜택 제외
고품질의 일관된 사용자 환경을 보장하려면 파트너가 특정 사용자 하위 집합으로 제한된 혜택을 포함하지 않아야 합니다. 특정 사용자만을 위해 생성된 맞춤 혜택은 자격 요건을 충족하지 않습니다. 모든 사용자(예: 신규 사용자 또는 특정 레스토랑에서 처음 주문하는 사용자)가 이용할 수 있는 플랫폼 전체 혜택은 모든 사용자에게 혜택 방문 페이지에 표시되는 경우에 한해 허용됩니다. 혜택 조건은 혜택 제목과 혜택 URL 방문 페이지에 명확하게 명시되어야 합니다. 로그아웃 상태이거나 사이트 또는 앱에 로그인한 상태일 때 모든 사용자에게 혜택 방문 페이지에 혜택이 표시되어야 합니다.
쿠폰 코드가 있는 혜택
'SAVE20 코드를 적용하여 총 청구액을 20% 할인받으세요'와 같이 사용자가 쿠폰 코드를 입력해야 하는 혜택이 있습니다. Google은 쿠폰 정의의 쿠폰 코드를 표시하지 않습니다. 파트너는 이 정보를 OfferDetails.offer_display_text 내에 포함하여 사용자에게 표시할 수 있습니다. 쿠폰 기반 혜택은 일반적으로 다음 두 가지 카테고리로 나뉩니다.
- Google에서 도착한 모든 사용자에게 결제 시 쿠폰이 자동으로 표시되는 혜택입니다. 이는 허용됩니다.
- 사용자가 결제 시 쿠폰 코드를 입력해야 하지만 혜택 URL 방문 페이지에 쿠폰 코드를 적용하는 방법에 관한 안내가 제공되지 않거나 혜택 URL을 따를 때 쿠폰이 자동으로 적용되지 않는 혜택은 허용되지 않습니다.
콘텐츠 및 구조 제공
이 섹션에서는 구조화된 메타데이터의 예를 비롯해 피드에 제공된 혜택의 콘텐츠 및 구조에 관한 요구사항을 자세히 설명합니다.
할인 혜택 표시 텍스트 및 할인 혜택 사양
OfferDetails.offer_display_text는 Google 검색의 혜택 섹션에 즉시 표시되는 간결한 헤드라인 역할을 하는 필수 필드입니다(예: '10달러 할인', '15% 할인').
OfferDetails.offer_specification은 OfferDetails 내의 필수 '하나' 필드입니다. 즉, 혜택을 지정하려면 다음 세 필드 중 정확히 하나를 제공해야 합니다.
discount_valuediscount_percentageother_offer_details_text
OfferDetails.other_offer_details_text 필드는 혜택을 고정 할인 값이나 비율로 표현할 수 없는 경우 offer_display_text를 보완하는 데 사용되는 자유 형식 텍스트 필드입니다. offer_display_text이 이미 상품에 관한 모든 필수 정보를 전달하기에 충분한 경우 other_offer_details_text 필드에 offer_display_text과 동일한 텍스트를 입력해야 합니다. 하지만 복잡한 거래의 경우 이 필드에 보상에 대한 구체적인 설명을 제공해야 합니다.
구조화된 메타데이터 필드
혜택의 명확성을 개선하고 더 나은 순위 지정 및 필터링을 지원하려면 파트너가 해당 구조화된 필드에 혜택 메타데이터를 제공해야 합니다. terms.terms_and_conditions 필드는 필수입니다. 값에는 혜택을 사용하는 방법에 관한 조건이 포함되어야 합니다. 예를 들어 혜택 방문 페이지에서 사용자에게 표시되는 세부 약관을 이 필드에 입력할 수 있습니다.
혜택 JSON 예시
20달러 할인
예: 화요일에 15달러 이상 구매 시 20달러 할인
{ "offer_id": "offer-example-1-takeout", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "$20 off on Tuesdays", "discount_value": { "currency_code": "USD", "units": 20 }, "min_spend_value": { "currency_code": "USD", "units": 15 } }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 9 }, "close_time": { "hours": 20, "minutes": 59, "seconds": 59 } }, "day_of_week": ["TUESDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": false }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders with $15 minimum spend. Single use per order. Offer may not be combined with any other offers, discounts, or promotions. Valid only on Tuesdays." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_1" }
1+1 혜택
예: 월요일부터 목요일까지 유효한 전채 요리 1+1 혜택
{ "offer_id": "offer-example-2-delivery", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "Buy one appetizer, get one free", "other_offer_detail_text": "Buy one appetizer, get one free" }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "time_windows": { "open_time": { "hours": 10 }, "close_time": { "hours": 23, "minutes": 59, "seconds": 59 } }, "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "inclusions": [ { "description": "appetizers" } ] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Valid on all menu appetizers. Offer may be combined with any other offers, discounts, or promotions. Valid Monday through Thursday." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_4" }
할인율 혜택
예: 샌드위치 25% 할인
{ "offer_id": "offer-example-3-delivery", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "25% off on Sandwitches", "discount_percent": 25.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Applies to specific items only. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_2" }
무료 배송 혜택
예: 30,000원 이상 주문 시 무료 배송 그 외의 경우 배송비는 7달러입니다.
{ "offer_id": "offer-example-4-delivery", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_DELIVERY", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "Free delivery on orders over $30", "discount_value": { "currency_code": "USD", "units": 7 }, "min_spend_value": { "currency_code": "USD", "units": 30 } }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } } } ], "offer_restrictions": { "combinable_with_other_offers": true }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery orders with $30 minimum spend. Delivery is $7.00 otherwise. Single use per order. May be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_3" }
부가기능 혜택이 포함된 기본 혜택 예시
예: 한 레스토랑에서 평일 점심에만 10% 할인을 제공하고 특정 신용카드로 결제 시 언제든지 5% 할인을 제공합니다.
[ { "offer_id": "offerId1", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_BASE_OFFER", "offer_details": { "offer_display_text": "10% off", "discount_percent": 10.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "combinable_offer_categories": ["OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER"] }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/base_offer_5" }, { "offer_id": "offerId2", "offer_source": "OFFER_SOURCE_AGGREGATOR", "action_type": "ACTION_TYPE_FOOD_TAKEOUT", "offer_modes": ["OFFER_MODE_ONLINE_ORDER"], "offer_category": "OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER", "offer_details": { "offer_display_text": "5% off", "discount_percent": 5.0 }, "validity_periods": [ { "valid_period": { "valid_from_time": { "seconds": 1768953600 }, "valid_through_time": { "seconds": 1795219200 } }, "time_of_day": [ { "day_of_week": ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY"] } ] } ], "offer_restrictions": { "combinable_with_other_offers": true, "combinable_offer_ids": ["offerId1"] }, "payment_instrument": { "items": [ { "type": "PAYMENT_INSTRUMENT_CREDIT_CARD", "name": "Participating Credit Card" } ], "provider_name": "Card Provider" }, "terms": { "terms_and_conditions": "For use only at the participating restaurant location on qualifying delivery or takeout orders. Single use per order. Offer may be combined with any other offers, discounts, or promotions." }, "entity_ids": ["dining-1"], "offer_url": "https://www.example-restaurant.com/offer/addon_offer_1" } ]
이행 및 제약 조건
이 섹션에서는 혜택 이행 사양 및 관련 제약 조건과 관련된 요구사항과 권장사항을 자세히 설명합니다.
주문 처리 모드 (배달 및 테이크아웃)
배달과 테이크아웃 모두에 적용되는 혜택이 하나인 경우 피드에 혜택이 두 개 있어야 합니다. 각 항목에는 전용 ActionType이 있어야 합니다.
ACTION_TYPE_FOOD_DELIVERYACTION_TYPE_FOOD_TAKEOUT
이렇게 하면 파트너 사이트로 이동하는 사용자에게 올바른 주문 처리 컨텍스트가 표시됩니다.
기간
로그아웃하거나 사이트 또는 앱에 로그인한 모든 사용자에게 혜택이 혜택 방문 페이지에 표시되어야 합니다. 혜택이 특정 기간에 유효한 경우 validity_periods.valid_period 필드를 포함하여 유효 기간을 지정해야 합니다. 이렇게 하면 기간 외에는 혜택이 표시되지 않습니다. 혜택이 특정 시간대에 혜택 URL에 표시되는 경우 시간대도 설정해야 합니다. 예를 들어 식당이 문을 닫았을 때 방문 페이지에 혜택이 표시되지 않는 경우 TimeOfDayWindow 영업시간과 종료 시간을 포함해야 합니다.
자정을 넘는 기간 처리
자정을 넘나드는 혜택 (예: 화요일 오후 10시부터 수요일 오전 2시까지 유효)은 수집 파이프라인에서 올바르게 처리되도록 세그먼트화해야 합니다. 요구사항: TimeOfDayWindow 필드를 사용하여 창을 두 개의 개별 세그먼트로 나눕니다.
- 세그먼트 1: 시작일 (예: 화요일) 오후 10시~오후 11시 59분 59초
- 세그먼트 2: 다음 날 (예: 수요일) 오전 12시~오전 2시
이렇게 하면 전체 기간 동안 혜택의 유효성이 정확하게 반영됩니다.
수수료 사양
배달 및 테이크아웃 수수료는 OfferDetails.additional_fees 필드를 사용하여 지정할 수 있습니다. 편의 수수료는 OfferDetails.convenience_fee를 사용하여 지정해야 합니다. 배송비가 사용자의 위치에 따라 변경되는 경우와 같이 변동 수수료에 수수료 범위 값을 사용합니다.