처리 시간 및 수수료

이 튜토리얼에서는 다음을 안내합니다.

  1. 지원되는 수수료 및 주문 처리 시간 사용 사례에 대한 대략적인 설명
  2. 서비스 피드의 주문 처리 시간과 수수료를 지정하는 방법에 관한 구체적인 안내
  3. 정확성 요구사항

주문 처리 시간 및 수수료 사용을 보여주는 전체 피드 샘플은 주문 리디렉션 EPA 샘플을 참고하세요.

요금

다음과 같이 수수료를 지정하는 여러 가지 방법을 제공합니다.

  • 고정 수수료: '배송비 $5' 또는 '서비스 수수료 $5'
  • 비율 수수료: '배송비 5%' 또는 '서비스 수수료 5%'
  • 수수료 범위: '배송비 $2~$10'
  • 개방형 범위 '서비스 수수료 최대 20달러'

수수료는 배송비 또는 서비스 수수료로 지정할 수 있습니다. 여러 수수료를 지정할 수도 있습니다 (예: '서비스 수수료 5%, 배송비 $5').

사용자 정보에 따라 수수료가 변경되어야 하는 사용 사례는 지원되지 않습니다.

수수료 예시

배송 및 수령 수수료

애플리케이션은 `DELIVERY` 및 `SERVICE` 수수료 유형을 지원합니다.

배달

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

서비스

{
  "fee": {
    "fee_id": "12345/service_fee",
    "fee_type": "SERVICE",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

다양한 수수료 유형

다음은 선택한 수수료 유형을 지정하는 데 사용할 수 있는 간단한 예시입니다.

고정

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

장바구니 비율

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "cart_percentage": {
      "base_value": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "percentage_of_cart_value": 10
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

범위

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "range_amount": {
      "min_amount": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "max_amount": {
        "currency_code": "USD",
        "units": 5,
        "nanos": 600000000
      }
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

처리 시간

정확한 데이터를 제공할 수 있도록 여러 가지 형식으로 재고 시간을 지정할 수 있습니다. 다음은 지원되는 다양한 사용 사례와 사용자가 프런트엔드에서 보게 될 언어와 유사한 몇 가지 예시를 설명합니다.

  • 고정 시간: '30분 내 배송' 또는 '15분 내 수령'
  • 시간 범위: '30분~1시간 내 배송' 또는 '15~20분 내 픽업'

일반 형식(아래 설명 참고)을 사용하여 픽업과 배송 모두에 대해 처리 시간을 지정할 수 있습니다.

사용자 정보에 따라 ETA가 변경되어야 하는 사용 사례는 지원되지 않습니다.

처리 시간 예

작업 링크의 주문 처리 시간은 서비스 피드 ETA 메시지에 FoodOrderingService 필드의 일부로 포함됩니다.

고정

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
        },
        "action_link_id": "action-link-id"
    }
},

기간

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
            "max_lead_time_duration": "1200s"

        },
        "action_link_id": "action-link-id"
    }
},

처리 기간

ServiceHours를 사용하면 특정 기간에 대한 처리 시간을 설정할 수 있습니다. 서비스 시간 외 시간대에는 FoodOrderingService에 설정된 기본 lead_time가 사용됩니다.

이 예시에서 2400s의 lead_time는 오전 11시부터 오후 1시 30분까지 표시됩니다.
1200s의 lead_time는 오전 11시 이전과 오후 1시 30분 이후에 표시됩니다. 
{
  "data": [
    {
      "service": {
        "service_id": "merchant-1-service-delivery",
        "service_type": "DELIVERY",
        "parent_entity_id": "merchant-1",
        "lead_time": {
          "min_lead_time_duration": "1200s"
        },
        "action_link_id": "merchant-1-takeout-delivery-action"
      }
    },
    {
      "service_hours": {
        "hours_id": "merchant-1-advance-hours-delivery",
        "service_ids": ["merchant-1-service-delivery"],
        "asap_hours": [
          {
            "time_windows": {
              "time_windows": {
                "open_time": {
                  "hours": 11
                },
                "close_time": {
                  "hours": 13,
                  "minutes": 30
                }
              }
            },
            "lead_time": {
              "min_lead_time_duration": "2400s"
            }
          }
        ]
      }
    }
  ]
}

수수료 및 처리 시간 정확성

수수료 정확성

판매자의 수수료 데이터를 제공할 때는 수수료를 정확하게 표시해야 합니다. 주문에 적용될 수 있는 모든 배송비 및 서비스 수수료를 포함해야 합니다.

수수료는 시간이 지남에 따라 그리고 사용자마다 다를 수 있습니다. 이러한 이유로 Google에서는 개방형 범위를 포함하여 수수료를 범위로 지정하는 기능을 제공합니다. 수수료가 크게 달라질 수 있는 경우 제공된 범위에 사용자가 거래 중에 볼 수 있는 수수료가 포함되어야 합니다.

구체적으로 어떤 정보가 필요한지 잘 모르겠다면 Actions Center 담당자에게 문의하세요.

주문 처리 시간 정확도

주문 처리 시간의 세부사항은 다양한 요인에 따라 달라집니다. 이러한 요소는 다음과 같습니다.

  • 주문 크기에 따른 주문 처리 시간 변경
  • 주문 및 결제 완료 시간에 따른 주문 처리 시간 변경
  • 피드를 통해 주문 처리 시간 변경사항이 업데이트되는 시점과
  • 사용자의 배송 주소입니다.

이러한 요인으로 인해 사용자에게 처음에 표시되는 주문 처리 시간이 결제 시 표시되는 정확한 처리 시간과 다를 수 있습니다. 주문 처리 시간 구현의 목표는 이러한 상황을 완전히 없애는 것이 아니라 가능한 한 자주 사용자에게 명확한 정보를 제공하는 것입니다.

파트너는 최선을 다해 사용자에게 정확한 주문 처리 시간이 표시되도록 하는 구현을 가능한 한 자주 제공해야 합니다. 이러한 요인으로 인해 시간에 상당한 변동이 있는 경우 해당 변동을 포함하는 시간 범위를 제공하는 것이 좋습니다. 또한 주문 세부정보로 인해 처리 시간이 변경되는 경우 주문 흐름에 도달할 때 사용자에게 명확하게 표시해야 합니다.

구체적으로 어떤 정보가 필요한지 잘 모르겠다면 Actions Center 담당자에게 문의하세요.

수수료 및 예상 도착 시간의 적시 업데이트

일반 피드 업로드를 사용한 변경사항은 처리하는 데 최소 2시간이 걸릴 수 있습니다. ETA를 자주 변경할 계획이라면 특히 이 점에 유의해야 합니다.

파트너는 5분 이내에 서비스 피드 (수수료 및 예상 도착 시간 포함)를 변경하는 API 호출을 지원하는 실시간 업데이트를 구현하는 것이 좋습니다.

이전
서비스 피드
다음
피드 Proto 번들