기프트 카드 (상품권)

이 가이드에서는 혜택 피드에 기프트 카드 (바우처라고도 함)를 구현하기 위한 요구사항, 데이터 모델링 권장사항, 권장사항을 설명합니다. 이러한 권장사항은 표준 작업 센터 문서를 보완하고 기프트 카드 관련 통합 측면을 다룹니다.

혜택 모드 및 분류

기프트 카드 인벤토리를 제출할 때 다음 핵심 속성이 올바르게 구성되어 있는지 확인하세요.

  • 혜택 모드: offer_modes는 항상 "OFFER_MODE_GIFT_CARD_PURCHASE"이 포함된 싱글턴 배열로 설정해야 합니다.

    "offer_modes": ["OFFER_MODE_GIFT_CARD_PURCHASE"]

  • 저장된 금액 상품권과 오프라인 즉시 할인 비교:

    • gift_card_info는 사전 구매한 저장된 금액 바우처 및 기프트 카드 (OFFER_MODE_GIFT_CARD_PURCHASE)에만 사용됩니다.
    • 고객이 나중에 사용할 바우처 코드를 구매하지 않고 현장에서 오프라인 매장 카운터에서 즉시 할인된 가격으로 결제하는 경우, OFFER_MODE_WALK_IN 메시지를 생략하고 gift_card_info 메시지를 완전히 생략하여 혜택을 표준 매장 방문 할인으로 모델링합니다.

  • 금액 모델링: 기프트 카드 금액은 바우처의 가치 (사용할 수 있는 금액)를 나타내야 하며 사용자가 지불하는 금액 (사용자는 할인된 가격을 지불함)을 나타내면 안 됩니다.

  • 여러 액면가 통합: 할인율과 약관이 정확히 동일하지만 액면가가 다른 여러 쿠폰은 하나의 혜택 항목으로 그룹화해야 합니다. denomination_type는 oneof로 작동하므로 파트너는 fixed_denominations 또는 custom_range를 설정해야 합니다.

    • 고정 금액: 개별적으로 사전 설정된 기프트 카드 금액이 제공되는 경우에 사용합니다 (예: 500루피, 1,000루피, 2,000루피 모두 10% 할인). 방문 페이지에서 매진되었거나 사용할 수 없는 고정 금액은 피드 제출에서 명시적으로 제외해야 합니다.
    • 맞춤 범위: 사용자가 구매 페이지에서 정의된 범위 내의 임의의 액면가를 자유롭게 입력할 수 있는 경우에만 사용합니다 (예: 5% 할인이 적용된 ₹100~₹5,000 사이의 값). 대상 방문 페이지에서 개별적인 사전 설정 금액을 제공하는 경우 fixed_denominations에 따라 인벤토리를 엄격하게 모델링합니다. 또한 혜택에 고정 금액과 맞춤 금액이 모두 제공되는 경우 파트너는 유연한 맞춤 범위를 설정해야 합니다.

여러 위치 체인 처리

여러 관심 장소 (POI)에서 약관이 동일한 대형 소매 또는 식당 체인에 적용되는 기프트 상품권의 경우 매장 위치마다 별도의 혜택 객체를 제공하지 마세요. 대신 참여하는 모든 매장 항목 ID (entity_ids) 목록이 포함된 단일 혜택 객체를 제공하여 집계된 피드 접근 방식을 사용하세요.

포털 브랜딩 (brand_id)

일부 쿠폰은 기본 판매자 사이트가 아닌 특정 은행 또는 포인트 포털 (예: 은행 포인트 프로그램 또는 파트너 플랫폼)을 통해 제공됩니다. 이러한 포털의 브랜딩이 정확하도록 파트너는 최상위 제품 객체에 brand_id 필드를 입력해야 합니다.

brand_id를 생략하면 계정의 기본 브랜드가 기본값으로 설정되며 계정의 기본 브랜드를 사용하는 경우 brand_id가 필요하지 않지만, brand_id를 명시적으로 입력하면 인벤토리가 해당 브랜드 포털과 정확하게 연결되어 사용자에게 올바른 파트너별 로고와 이름이 표시됩니다. 브랜드 구성에 대한 자세한 내용은 브랜드 구성을 참고하세요.

유효성 구조 (ValidityScope)

기프트 카드에는 혜택을 구매할 수 있는 기간과 카드를 등록할 수 있는 기간을 구분하는 고유한 유효성 구조가 있습니다. 파트너는 항상 관련 ValidityScope 열거형 값을 사용해야 합니다.

  • VALIDITY_SCOPE_CLAIM: 기프트 카드 혜택을 파트너 플랫폼에서 구매할 수 있는 기간을 정의합니다. 이 항목은 항상 있어야 합니다. 피드를 제출할 때 정확한 피드 제출 날짜부터 시작하는 청구 유효 기간을 입력합니다. 또한 방문 페이지에서 캠페인 종료일을 명시적으로 광고하는 경우 클레임 기간을 무기한으로 두지 마세요. valid_through_time를 광고된 만료일에 맞추세요.
  • VALIDITY_SCOPE_REDEEM: 구매 후 사용 기간 (사용자가 구매 후 매장에서 쿠폰을 사용해야 하는 기간으로, 기간 또는 기간으로 지정할 수 있음)을 정의합니다.

작업 유형 매핑

파트너는 '온라인/오프라인 사용 가능', '온라인/매장', '매장'과 같은 구조를 사용하여 쿠폰을 분류하는 경우가 많습니다. 피드 제출에서 제품이 소비되는 방식을 정확하게 정의하려면 이 값이 ActionType enum에 매핑되어야 합니다.

  • 식사 / 음식 카테고리: '매장 내 식사' 기프트 카드를 ACTION_TYPE_DINING에 매핑합니다. '배송' 기프트 카드를 ACTION_TYPE_FOOD_DELIVERY에 매핑합니다. '테이크아웃' 기프트 카드를 ACTION_TYPE_FOOD_TAKEOUT에 매핑
  • 쇼핑 소매업: '오프라인' 기프트 카드를 ACTION_TYPE_SHOPPING_IN_STORE에 매핑합니다. (참고: 온라인 전용 소매업체 상품권은 지원되지 않습니다.)
  • 단일 채널 매핑: 각 offer_id는 하나의 ActionType에만 속할 수 있습니다. 인벤토리 항목이 여러 주문 처리 채널(예: 음식 배달과 테이크아웃 모두)을 지원하는 경우 각 모드에 고유한 ID가 있는 별도의 Offer 객체를 만듭니다.

단계별 할인 및 부가기능 혜택

  • 결제 수단별 등급 할인: 사용된 특정 결제 수단 (예: 신용카드 대비 전자 지갑의 할인율이 더 높음)에 따라 다른 할인율이 제공되는 경우 별도의 혜택 객체로 모델링해야 합니다. 파트너는 안정적인 할인 경험을 보장하기 위해 지원되는 모든 결제 수단 (예: 전자 지갑, 신용카드, 체크카드, 온라인 뱅킹)에 걸쳐 포괄적인 프로모션 범위를 제공해야 합니다. 혜택이 플랫폼에서 허용되는 모든 결제 수단에 보편적으로 적용되는 경우 결제 수단 필드를 설정하면 안 됩니다.
  • 부가 혜택 구성: 은행별 리워드 포인트 또는 기프트 카드 구매에 적용되는 추가 캐시백과 같은 중첩된 혜택을 나타내려면 적절한 OfferCategory enum(OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER)을 사용하여 완전히 별도의 부가 혜택으로 제출하세요. OfferDetails.other_offer_details_text 내에서 리워드를 설명하고 (예: '최대 5배 리워드 포인트') OfferRestrictions.combinable_offer_ids에 기본 기프트 카드의 offer_id를 입력하여 기본 기프트 카드 혜택에 연결합니다.

이용약관 및 특별 조건

파트너는 terms.terms_and_conditions를 사용하여 기프트 카드 또는 쿠폰의 전체 법적 용어 및 조건을 제공해야 합니다. 사용자 대상 안내와 사용 가이드라인을 모두 이 필드에 통합합니다.

중요한 제한사항에 전용 UI 강조가 필요한 경우 (예: 일회용 잔액 만료, 환불 불가, '청구서당 바우처를 최대 2개까지 결합할 수 있습니다'와 같은 거래 결합 한도) offer_restrictions.special_conditions에서 강조 표시합니다.

제품 이름 추천

제품명 길이는 40자(영문 기준) 미만이어야 합니다. offer_display_text에서 판매자 브랜드 이름을 삭제합니다. 혜택은 판매자의 전용 장소 시트에 직접 표시되기 때문입니다. 다음과 같은 제목 형식을 사용하는 것이 좋습니다.

사용 사례 추천 제목
쿠폰에 적용되는 일괄 할인 X% off on Gift Cards
결제 수단에 따른 가변 할인 X% off on Gift Cards using {e-wallet}
다양한 금액에 대한 변동 할인 X% off on Gift Cards (할인을 별도의 혜택으로 전송)
B2B2C 기프트 카드 X% off on Gift Cards (브랜딩은 brand_id를 사용하여 썸네일을 통해 표시됨)
부가 혜택 Flat/Up to 5X reward points/ <Platform> coins

방문 페이지 요구사항

광고에 표시된 모든 offer_url는 중간 리디렉션 없이 직접 HTTP 200 OK를 반환하고 혜택을 입증하는 활성 도착 페이지로 연결되어야 합니다.

피드에 매진되었거나 사용할 수 없는 금액이 포함되어서는 안 됩니다. 피드 금액 필드와 대상 방문 페이지의 실시간 구매 옵션 간에 엄격한 인벤토리 동기화를 유지합니다.

도착 방문 페이지에서 혜택이 기프트 카드 또는 상품권에만 적용된다고 명시해야 합니다.

예를 들어 파트너 방문 페이지에 거래를 완료하면 저장된 금액의 기프트 카드 바우처가 발급된다는 점을 명시적으로 미리 밝히지 않고 '청구서 결제'와 같은 일반적인 결제 클릭 유도 문구만 표시되는 경우, 기프트 카드를 구매할 것으로 예상하고 Google에서 리디렉션된 사용자가 혼란을 느끼거나 이탈할 수 있습니다. 바우처 알림이 후속 결제 단계에 표시되더라도 초기 방문 페이지에 명확하게 표시되어야 합니다.

쿠폰 코드가 있는 혜택

'SAVE20 코드를 적용하여 총 청구액을 20% 할인받으세요'와 같이 사용자가 쿠폰 코드를 입력해야 하는 혜택이 있습니다. Google은 쿠폰 정의의 쿠폰 코드를 표시하지 않습니다. 파트너는 사용자에게 표시되도록 OfferDetails.offer_display_text 내에 이 정보를 포함할 수 있습니다. 쿠폰 기반 혜택은 일반적으로 다음 두 가지 카테고리로 분류됩니다.

  • Google에서 도착한 모든 사용자에게 결제 시 쿠폰이 자동으로 표시되는 혜택입니다. 이는 허용됩니다.
  • 사용자가 결제 시 쿠폰 코드를 입력해야 하지만 혜택 URL 방문 페이지에서 쿠폰 코드를 적용하는 방법에 관한 안내를 제공하지 않거나 혜택 URL을 따를 때 쿠폰이 자동으로 적용되지 않는 혜택은 허용되지 않습니다.

기프트 카드 혜택 JSON 예시

{
  "data": [
    {
      "offer_id": "example-dining-gift-card-10off",
      "entity_ids": [
        "dining-1",
        "dining-2"
      ],
      "offer_modes": [
        "OFFER_MODE_GIFT_CARD_PURCHASE"
      ],
      "action_type": "ACTION_TYPE_DINING",
      "offer_source": "OFFER_SOURCE_AGGREGATOR",
      "offer_category": "OFFER_CATEGORY_BASE_OFFER",
      "offer_details": {
        "offer_display_text": "10% off on Gift Cards",
        "discount_percent": 10.0,
        "gift_card_info": {
          "fixed_denominations": {
            "amounts": [
              {
                "units": 500,
                "currency_code": "INR"
              },
              {
                "units": 1000,
                "currency_code": "INR"
              },
              {
                "units": 2000,
                "currency_code": "INR"
              }
            ]
          }
        }
      },
      "offer_restrictions": {
        "combinable_with_other_offers": false,
        "special_conditions": [
          "Single-use balance expiration applies",
          "Maximum 2 gift card vouchers can be combined per bill",
          "No cash refund will be provided against this voucher"
        ]
      },
      "terms": {
        "restricted_to_certain_users": false,
        "terms_and_conditions": "1. Redeemable exclusively at participating dining outlets.\n2. Single-use balance expiration applies.\n3. Maximum 2 gift card vouchers can be combined per bill.\n4. No cash refund will be provided against this voucher."
      },
      "validity_periods": [
        {
          "valid_period": {
            "valid_from_time": {
              "seconds": "1774934350"
            },
            "valid_through_time": {
              "seconds": "1806470350"
            }
          },
          "validity_scope": "VALIDITY_SCOPE_CLAIM"
        },
        {
          "validity_duration_in_days": 365,
          "validity_scope": "VALIDITY_SCOPE_REDEEM"
        }
      ],
      "offer_url": "https://www.example-portal.com/dining-gift-cards/buy"
    }
  ]
}