Подарочные карты (или ваучеры)

Примечание: Это пилотный выпуск.

Внимание: Этот документ находится в стадии разработки. Информация может часто меняться.

В этом руководстве изложены требования, рекомендации по моделированию данных и лучшие практики внедрения подарочных карт (также известных как ваучеры) в ваш фид предложений. Эти рекомендации дополняют стандартную документацию Центра действий и затрагивают аспекты интеграции, специфичные для подарочных карт.

Режим предложения и категоризация

При отправке данных об подарочных картах убедитесь, что следующие основные атрибуты настроены правильно:

• Режим предложения : 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, 1000 и 2000 рупий, все со скидкой 10%). Убедитесь, что любые подарочные карты фиксированного номинала, которые распроданы или недоступны на целевой странице, явно исключены из отправки данных в фид.
  • Диапазон пользовательских значений : Используйте этот параметр строго в тех случаях, когда пользователи могут свободно вводить любое произвольное номинальное значение в пределах заданных границ на странице покупки (например, любое значение от 100 до 5000 рупий со скидкой 5%). Если на целевой странице предлагаются дискретные, предустановленные суммы, моделируйте ассортимент строго в рамках параметра fixed_denominations . Кроме того, если для предложения доступны как фиксированные, так и пользовательские номиналы, партнеры должны установить гибкий диапазон пользовательских значений.

Управление сетями с несколькими филиалами

Для подарочных сертификатов, действующих в крупных розничных или ресторанных сетях, где условия одинаковы для нескольких точек интереса (POI), не следует создавать отдельный объект Offer для каждого отдельного магазина. Вместо этого используйте агрегированный подход, предоставляя единый объект Offer, содержащий список всех идентификаторов сущностей участвующих магазинов ( entity_ids ).

Примечание: Исключение составляет случай, когда URL целевой страницы ( offer_url ) уникален для каждой торговой точки. В таких случаях партнеры должны отправлять отдельный объект Offer для каждой торговой точки.

Брендинг портала ( brand_id )

Некоторые ваучеры предлагаются через определенные банковские или партнерские порталы (например, банковские программы лояльности или партнерские платформы), а не через основной сайт продавца. Для обеспечения корректного брендинга на этих порталах партнеры должны заполнить поле brand_id в объектах Offer верхнего уровня.

Хотя при отсутствии brand_id по умолчанию используется основной бренд учетной записи (и brand_id не требуется при использовании бренда учетной записи по умолчанию), явное заполнение brand_id обеспечивает точную связь товаров с соответствующим фирменным порталом, гарантируя отображение пользователям правильных логотипов и названий партнеров. Дополнительные инструкции по настройке брендов можно найти в разделе «Настройка брендов» .

Структура валидности ( ValidityScope )

Подарочные карты имеют уникальную структуру срока действия, различающую период покупки предложения и период использования карты. Партнеры всегда должны использовать соответствующие значения перечисления ValidityScope :

• VALIDITY_SCOPE_CLAIM : Определяет период времени, в течение которого подарочная карта доступна для покупки на партнерской платформе. Этот параметр должен присутствовать всегда. При отправке фидов укажите период действия заявки, начиная с точной даты отправки фида. Кроме того, никогда не оставляйте периоды действия заявок открытыми, если на целевой странице явно указана дата окончания кампании; сопоставьте valid_through_time с указанной датой истечения срока действия.
• VALIDITY_SCOPE_REDEEM : Определяет продолжительность действия ваучера после покупки (период времени, в течение которого пользователи должны использовать ваучер в магазине после покупки, который может быть указан как продолжительность или временной интервал).

Сопоставление типов действий

Партнеры часто классифицируют ваучеры, используя такие конструкции, как «можно использовать онлайн/офлайн», «онлайн/в аутлете» или «в магазине». В данных, отправляемых в фид, это необходимо сопоставить с перечислением ActionType , чтобы точно определить, как используется продукт:

• Рестораны / Сфера питания : Сопоставьте подарочные карты «В ресторане» с ACTION_TYPE_DINING . Сопоставьте подарочные карты «С доставкой» с ACTION_TYPE_FOOD_DELIVERY . Сопоставьте подарочные карты «На вынос» с ACTION_TYPE_FOOD_TAKEOUT .
• Вертикаль розничной торговли : Сопоставьте подарочные карты для покупок в магазине с типом действия ACTION_TYPE_SHOPPING_IN_STORE . (Примечание: ваучеры для покупок в розничных магазинах, доступных только онлайн, не поддерживаются).
• Одноканальное сопоставление : Каждый offer_id может принадлежать строго одному ActionType . Если товар на складе поддерживает несколько каналов выполнения (например, доставку еды и самовывоз), создайте отдельные объекты Offer с уникальными идентификаторами для каждого режима.

Многоуровневые скидки и дополнительные предложения

• Многоуровневые скидки для разных способов оплаты : Если предлагаются разные проценты скидки в зависимости от используемого способа оплаты (например, более высокая скидка для электронного кошелька по сравнению с кредитной картой), их необходимо моделировать как отдельные объекты «Предложение». Партнеры должны обеспечить исчерпывающее описание рекламной акции для всех поддерживаемых способов оплаты (например, электронные кошельки, кредитные карты, дебетовые карты, интернет-банкинг), чтобы гарантировать надежную экономию. Если предложение применяется ко всем способам оплаты, принимаемым на платформе, поле «Способ оплаты» не должно быть заполнено.
• Дополнительные предложения : Чтобы представить суммируемые преимущества, такие как бонусные баллы банка или дополнительный кэшбэк, применимые к покупке подарочной карты, представьте их как совершенно отдельные дополнительные предложения, используя соответствующее перечисление OfferCategory - OFFER_CATEGORY_ADD_ON_PAYMENT_OFFER . Опишите вознаграждение в OfferDetails.other_offer_details_text (например, "До 5X бонусных баллов" ) и свяжите его с базовым предложением подарочной карты, заполнив OfferRestrictions.combinable_offer_ids значением offer_id базовой подарочной карты.

Условия и особые положения

Партнеры должны использовать файл terms.terms_and_conditions для предоставления полного юридического текста Условий использования подарочной карты или ваучера. В этом поле следует объединить все инструкции для пользователей и рекомендации по использованию.

Если критически важные ограничения требуют выделенного отображения в пользовательском интерфейсе (например, истечение срока действия одноразового баланса, невозможность возврата средств или ограничения на объединение транзакций, такие как «В одном счете можно объединить максимум 2 ваучера» ), выделите их в offer_restrictions.special_conditions .

Важно: любое критическое условие, указанное в special_conditions должно быть также полностью включено в основную строку terms.terms_and_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 (бренд отображается в виде миниатюры по идентификатору бренда )
Дополнительные предложения	Flat/Up to 5X reward points/ <Platform> coins

Требования к целевой странице

Каждый рекламируемый offer_url должен возвращать HTTP 200 OK напрямую, без промежуточных перенаправлений, и вести на активную целевую страницу, подтверждающую предложение.

В ленте не должно быть товаров распроданных или недоступных номиналов. Необходимо поддерживать строгую синхронизацию данных о наличии товара между полями с указанием номиналов и вариантами покупки на целевой странице.

На целевой странице следует четко указать, что предложение распространяется исключительно на подарочные карты или ваучеры.

Например, если на целевой странице партнера отображаются только общие призывы к действию при оплате, такие как «Оплатить счет», без явного указания на то, что завершение транзакции приведет к выдаче подарочного сертификата с предоплаченным балансом, пользователи, перенаправленные с Google в ожидании покупки подарочной карты, могут запутаться или отказаться от покупки. Даже если уведомление о сертификате появляется на последующем этапе оформления заказа, необходима четкая ясность на начальной целевой странице.

Предложения с промокодами

Для некоторых предложений требуется ввод промокода пользователем, например: «Примените код SAVE20, чтобы получить скидку 20% на общую сумму». Важно отметить, что Google не отображает промокоды из описания купона . Партнеры могут включать эту информацию в OfferDetails.offer_display_text для отображения пользователям. Предложения на основе купонов обычно делятся на две категории:

• Разрешены предложения, в рамках которых купон автоматически отображается при оформлении заказа любому пользователю, перешедшему с сайта Google.
• Запрещены предложения, требующие от пользователя ввода промокода при оформлении заказа, но не содержащие инструкций по его применению на целевой странице, или предложения, которые не применяют купон автоматически при переходе по ссылке.

Пример предложения подарочной карты в формате 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"
    }
  ]
}