Phân biệt giữa đường liên kết đến hành động Đặt món ăn giao tận nơi và Mang đi (cũ)

Cảnh báo: Đây là một hướng dẫn cũ và bạn chỉ nên sử dụng hướng dẫn này để duy trì các chế độ tích hợp hiện có. Các hoạt động tích hợp mới phải sử dụng hướng dẫn mới nhất.

Lưu ý: Hướng dẫn này chỉ áp dụng cho những đối tác tích hợp Actions Center Legacy Starter cung cấp action_link(các) cho phép người dùng thực hiện hành động Đặt hàng.

Mục tiêu: Hướng dẫn này giải thích cách các đối tác có thể cung cấp thông tin cho Trung tâm hành động về những hành động liên quan đến thực phẩm mà người dùng có thể hoàn tất thông qua một action_link cụ thể.

Các đối tác Tích hợp gói Starter cũ có thể liên kết nhiều action_link_type với action_link(các) của họ. action_link_type giúp xác định loại hành động mà người dùng có thể thực hiện khi họ được chuyển hướng đến trang web của đối tác bằng đường liên kết đó.

• Bạn chỉ có thể liên kết một action_link_type với mỗi action_link.

Khi đặt đồ ăn, người dùng có thể yêu cầu thực hiện 2 hành động sau:

• Yêu cầu tự đến lấy đồ ăn tại nhà hàng (Đặt món mang đi)
• Yêu cầu giao đồ ăn đến một địa điểm cụ thể (Đặt đồ ăn giao tận nơi)

Tất cả đối tác tham gia Hành động về thực phẩm đều nên sử dụng phương thức này. Nếu hiện đang gửi cho chúng tôi action_link(s) bằng action_link_type = ACTION_LINK_TYPE_ORDER_FOOD hoặc service_type = SERVICE_TYPE_FOOD_ORDERING, bạn nên cập nhật nguồn cấp dữ liệu của mình để phù hợp với phương pháp hiện tại.

Lưu ý: Chúng tôi vẫn sẽ tiếp tục hỗ trợ phương thức triển khai cũ.

Người bán hỗ trợ đặt món ăn đến lấy hàng

Lưu ý quan trọng: Để gắn thẻ action_link(s) chỉ là Đồ ăn mang đi, bạn phải sử dụng action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT

Người bán

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Dịch vụ

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Reservation",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/reserve_table/merch1",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Người bán hỗ trợ đặt hàng giao đồ ăn

Lưu ý quan trọng: Để gắn thẻ action_link(các) chỉ là Dịch vụ giao đồ ăn, bạn phải sử dụng action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY.

Người bán

{
 "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/fooddelivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Dịch vụ

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/reserve_table/merch1",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Người bán hỗ trợ dịch vụ đến lấy hàng và giao đồ ăn mang đi

Nếu người bán hỗ trợ cả hai hành động, tức là Giao đơn đặt món ăn và Đến lấy đơn đặt món ăn, bạn nên cung cấp hai action_link(các) riêng biệt và liên kết chúng với các hành động thích hợp.

Lưu ý: Đảm bảo rằng đường liên kết sâu action_link(các) dẫn đến hành động thích hợp chứ không phải trang đích chung chung.

Người bán

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        },
        {
          "url": "https://www.partnerwebsite.com/fooddelivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Dịch vụ

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Order",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodpickup/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    },
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/fooddelivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}

Người bán hỗ trợ cả hai hành động thông qua một URL duy nhất

Ví dụ: khi action_link liên kết sâu đến trang đặt hàng chung cho nhà hàng, nơi người dùng phải chọn giữa Giao đồ ăn và Tự đến lấy đồ ăn, bạn nên làm theo những điều sau

Gửi URL action_link hai lần, liên kết mỗi phiên bản với action_link_type thích hợp như đề cập bên dưới:

• Đối với phiên bản đầu tiên, hãy gắn thẻ action_link bằng action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY
• Đối với phiên bản thứ hai, hãy gắn thẻ action_link bằng action_link_type = ACTION_LINK_TYPE_ORDER_FOOD_PICKUP

Người bán

{
  "merchant": [
    {
      "merchant_id": "merch10",
      "name": "Sample Restaurant",
      "telephone": "[phone]",
      "url": "https://www.restaurantsamplewebsite.com",
      "category": "restaurant",
      "geo": {
        "address": {
          "street_address": "803 11th Avenue",
          "locality": "Sunnyvale",
          "region": "CA",
          "country": "USA",
          "postal_code": "94089"
        }
      },
      "action_link": [
        {
          "url": "https://www.partnerwebsite.com/foodtakeout+delivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        },
        {
          "url": "https://www.partnerwebsite.com/foodtakeout+delivery/merch34",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }

      ]
    }
  ]
}

Dịch vụ

{
  "service": [
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Order",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Order"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodtakeout+delivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    },
    {
      "merchant_id": "merch10",
      "service_id": "10",
      "localized_service_name": {
        "value": "Food Delivery",
        "localized_value": [
          {
            "locale": "en",
            "value": "Food Delivery"
          }
        ]
      },
      "action_link": [
        {
          "url": "https://www.rwgpartnerwebsite.com/foodtakeout+delivery/merch10",
          "action_link_type": "ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY",
          "language": "en",
          "platform": "ACTION_PLATFORM_WEB_APPLICATION"
        }
      ]
    }
  ]
}