تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمنح رابط الإجراء المستخدمين إمكانية التفاعل مع رابط لصفحة في التطبيق
ينقل إلى الموقع الإلكتروني للشريك لتنفيذ إجراء. يتم عرض الروابط لصفحات في التطبيق
في بطاقة معلومات التاجر. سيوضّح هذا الدليل كيفية
إضافة روابط إجراءات إلى الخلاصات.
يمكن تقديم روابط الإجراءات في مكانَين:
خلاصة التاجر
- يمكنك تنفيذ روابط الإجراءات من خلال خلاصات التجار، عندما يكون لدى تاجر واحد خدمات متعددة
تؤدي إجراءً مشابهًا.
خلاصة الخدمات
- يمكنك استخدام روابط الإجراءات من خلال خلاصات الخدمات عندما يكون لدى تاجر واحد خدمات متعددة
تُنفّذ إجراءات مختلفة.
روابط الإجراءات على مستوى التاجر
يجب تقديم رابط إجراء من خلال خلاصات التجار عندما تعيد كل الخدمات
للتاجر المحدّد توجيه المستخدم إلى الصفحة المقصودة نفسها على
الموقع الإلكتروني للشريك.
وعادةً ما يكون هذا هو الحلّ الوحيد ذي الصلة بتجربة تناول الطعام،
لأنّ هناك خدمة واحدة فقط لكل تاجر.
في ما يلي مثال:
يقدّم التاجر خدمات متعدّدة، مثل:
صفوف اليوغا، وصفوف الملاكمة، وصفوف ركوب الدراجات، وقصّ الشعر، وتلوين الشعر، والشامبو.
يعيد رابط الإجراء توجيهك إلى صفحة مقصودة
تعرض قائمة الخدمات الكاملة للتاجر.
يجب تحديد نوع الإجراء باستخدام ActionLinkType الذي يشكّل جزءًا من
ActionLink
في خلاصة التجّار.
يجب تقديم رابط إجراء من خلال خلاصة "الخدمات" عندما يكون لدى التاجر
روابط لصفحات في التطبيق مختلفة لكل خدمة أو عندما يكون لدى التاجر خدمات متعددة
تؤدي إجراءات مختلفة، مثل طلب الطعام وحجز المطعم.
في ما يلي مثال:
يقدّم مطعم خدمة حجز وجبات الطعام وطلبها. يعيد رابط أحد الإجراءات توجيه المستخدِم إلى صفحة حجز المطعم، ويعيد رابط آخر توجيه المستخدِم إلى صفحة طلب الطعام.
يمكن تحديد نوع الإجراء باستخدام ServiceType في
الخدمات وActionLinkType التي تشكّل جزءًا من
ActionLink في خلاصة التجّار.
يتم استخدام OrderOnlineMetadata لتحديد المعلومات التي سيتم عرضها
للمستخدم حول أي رسوم والحد الأدنى لمبالغ الطلبات ومدى توفّر methods المختلفة
للتسليم في التسوّق على الإنترنت. عند تضمين هذه البيانات الوصفية، يتم تضمينها
مع رابط الإجراء في خلاصة التاجر.
للحصول على معلومات إضافية عن كيفية تضمين هذه المعلومات بشكل صحيح في
خلاصاتك إذا كان الدمج يتطلّب ذلك، يمكنك الاطّلاع على مستندات
التالية:
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis legacy tutorial explains how to add action links (deep links to partner websites) to Merchant and Services feeds for existing Actions Center integrations.\u003c/p\u003e\n"],["\u003cp\u003eAction links in Merchant feeds are suitable when all services for a merchant lead to the same landing page, while Services feeds are used for distinct service actions or multiple service types.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eActionLinkType\u003c/code\u003e and \u003ccode\u003eServiceType\u003c/code\u003e enums define the specific action associated with a link and are mandatory for starter integrations; using \u003ccode\u003eUNSPECIFIED\u003c/code\u003e types is discouraged.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eOrderOnlineMetadata\u003c/code\u003e should only be included by partners participating in Retail Ordering actions, providing details on fees, minimum order amounts, and fulfillment availability.\u003c/p\u003e\n"],["\u003cp\u003eNew integrations should refer to the up-to-date tutorial linked at the beginning of the document.\u003c/p\u003e\n"]]],["Action links, directing users to partner websites, are added to merchant or services feeds. Merchant-level links suit when a merchant's services share a landing page; services-level links are for when services have distinct deep links or offer diverse actions. Action types are specified using `ActionLinkType` or `ServiceType`. `OrderOnlineMetadata`, used for retail ordering, details fees, minimums, and fulfillment options. It is noted that this is a legacy tutorial.\n"],null,["# Specify action links (Legacy)\n\n| **Warning:** This is a legacy tutorial and should only be used to maintain existing integrations. New integrations must used the [up-to-date tutorial](/actions-center/verticals?vertical_redirect_fragment=guides/tutorials/tutorial-specifying-action-links).\n\n\u003cbr /\u003e\n\n| **Note:** This guide only applies to partners who are integrating with the Actions Center Legacy Starter integration.\n\nAn action link provides the ability for users to interact with a deep link\nwhich links out to the partner's website to perform an action. Deep links\nare displayed on the merchant's knowledge panel. This guide will describe how\nto add action links to the feeds.\n\nAction links can be provided in two places:\n\n- [Merchant feed](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed) - Implement action links via the merchant feeds, when a single merchant has multiple services performing a similar action.\n- [Services feed](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/services-feed) - Implement action links via the services feeds, when a single merchant has multiple services performing different actions.\n\nMerchant level action links\n---------------------------\n\nYou should provide an action link via the Merchant feeds when all services\nfor a given merchant redirects the user to the same landing page on the\npartner's website.\n\nThis is usually the only meaningful implementation for dining\nas there is only one service per merchant.\n\nAn example is:\n\n- A merchant provides multiple services like yoga classes, boxing classes, cycling classes, haircut, hair coloring, shampoo. The action link redirects to a landing page displaying the entire service catalog for the merchant.\n\n| **Note:** Currently, only one action link is displayed for a single merchant on the merchant knowledge panel for a particular [`ActionLinkType`](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed#ActionLink-definition) (e.g.: food ordering or making a dining reservation, making an appointment for in-person or online). Therefore, only deeplinks listing all services can be surfaced.\n\nThe type of action must be specified using the `ActionLinkType` which is part of\n[`ActionLink`](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed#ActionLink-definition)\nin the merchants feed. \n\n```gdscript\n // Predetermined type of action associated with an action link.\n enum ActionLinkType {\n // The action link type is unspecified.\n ACTION_LINK_TYPE_UNSPECIFIED = 0;\n\n // The action link type is booking an appointment.\n ACTION_LINK_TYPE_BOOK_APPOINTMENT = 1;\n\n // The action link type is booking an online appointment.\n ACTION_LINK_TYPE_BOOK_ONLINE_APPOINTMENT = 2;\n\n // The action link type is ordering food for delivery or takeout or both.\n ACTION_LINK_TYPE_ORDER_FOOD = 3;\n\n // The action link type is ordering food for delivery.\n ACTION_LINK_TYPE_ORDER_FOOD_DELIVERY = 4;\n\n // The action link type is ordering food for takeout.\n ACTION_LINK_TYPE_ORDER_FOOD_TAKEOUT = 5;\n\n // The action link type is making a dining reservation.\n ACTION_LINK_TYPE_MAKE_DINING_RESERVATION = 6;\n\n // The action link type allows users to shop from the given merchant. It\n // could either be delivery or pickup.\n ACTION_LINK_TYPE_SHOP_ONLINE = 7;\n }\n```\n\nServices level action links\n---------------------------\n\nYou should provide an action link via the Services feed when the merchant has\ndifferent deep links per service or the merchant has multiple services\nperforming different actions like food ordering and dining reservation.\n\nAn example is:\n\n- A restaurant provides dining reservation and food ordering. One action link redirects the user to the dining reservation page and another redirects the user to the food ordering page\n\nThe type of action can be specified using the `ServiceType` in\nthe services and `ActionLinkType` which is part of\n`ActionLink` in the merchants feed.\n**Note:** Specifying `ServiceType` or `ActionLinkType` is mandatory for starter integration. \n\n```gdscript\n enum ServiceType {\n SERVICE_TYPE_UNSPECIFIED = 0;\n\n // Service that provides dining reservation.\n SERVICE_TYPE_DINING_RESERVATION = 1;\n\n // Service that provides food ordering in general, could be either takeout\n // or delivery or both.\n SERVICE_TYPE_FOOD_ORDERING = 2;\n\n // Service that only provides food delivery.\n SERVICE_TYPE_FOOD_DELIVERY = 6;\n\n // Service that only provides food takeout.\n SERVICE_TYPE_FOOD_TAKEOUT = 7;\n\n // Services that provide event based ticketing (e.g. concerts, sporting\n // events, shows). Do not use for Reserve with Google integrations.\n SERVICE_TYPE_EVENT_TICKET = 3;\n SERVICE_TYPE_TRIP_TOUR = 4;\n\n // Service that provides appointments or classes. Recommended for (1) health\n // and fitness, (2) spa and beauty, and (3) financial consults and\n // evaluations services. Please see the supported service types:\n // https://developers.google.com/maps-booking/guides/end-to-end-integration/overview\n SERVICE_TYPE_APPOINTMENT = 5;\n\n // Service that provides appointment for an online class or session which\n // will be fully virtual. Must be set if enabling virtual service bookings.\n SERVICE_TYPE_ONLINE_APPOINTMENT = 8;\n\n // Service that allows users to shop from the given merchant. It could\n // either be delivery or pickup.\n SERVICE_TYPE_SHOPPING = 9;\n }\n```\n| **Note:** We do not recommend using `SERVICE_TYPE_UNSPECIFIED` or `ACTION_LINK_TYPE_UNSPECIFIED` for any of your actions links.\n\nUsing OrderOnlineMetadata\n-------------------------\n\n| **Note:** OrderOnlineMetadata should only be included by partners who participate in Retail Ordering actions. Please do not include this information in your feeds unless you have been instructed to do so by your Actions Center contact.\n\nThe OrderOnlineMetadata is used to specify information to be displayed to\nthe user about any fees, minimum order amounts, and availability for different\nonline shopping fulfillment methods. When included, this metadata is included\nwith the action link in the Merchant feed.\n\nFor additional information on how to properly include this information in\nyour feeds if your integration requires it can be found in the following\ndocumentation:\n\n- [Retail Ordering Feed samples](/actions-center/verticals/shopping/samples/starter-feed-samples/shopping-with-metadata) that include this metadata\n- A tutorial on [adding and updating availability metadata](/actions-center/verticals/shopping/guides/tutorials/tutorial-adding-shopping-availability)\n- [OrderOnlineMetadata](/actions-center/verticals?vertical_redirect_fragment=reference/feed-specifications/merchants-feed#orderonlinemetadata_definition) Reference definition for"]]