استخدِم سمة "نوع قيمة القسيمة" [coupon_value_type] للإشارة إلى نوع العرض الترويجي الذي تقدّمه. بهذه الطريقة، يمكن لـ Google إجراء مراجعة مبرمَجة يمكن أن تؤدي إلى تسريع الموافقة على عرضك الترويجي.
حالات الاستخدام
اختيارية لجميع العروض الترويجية
التنسيق
اتّبِع إرشادات التنسيق هذه لضمان فهمنا للبيانات التي ترسلها.
| النوع | أحرف Unicode (ننصح باستخدام ASCII فقط) |
| حقل متكرّر | لا |
| تنسيق الملف | مثال |
| خلاصات نصية | القِيم المسموح بها:
|
| خلاصات XML | <g:coupon_value_type>no_structured_data</g:coupon_value_type> |
عند استخدام سمة "نوع قيمة القسيمة" [coupon_value_type]، قد تحتاج أيضًا إلى إضافة سمات أخرى استنادًا إلى القيمة التي ترسلها. على سبيل المثال، إذا أرسلت القيمة money_off، يجب أيضًا استخدام سمة "قيمة الخصم النقدي المقدَّم في عرض ترويجي" [money_off_amount].
تعرض قائمة القِيم المسموح بها التالية السمات المطلوبة والاختيارية لكل قيمة:
بدون بيانات منظَّمة [no_structured_data]
- السمات المطلوبة: ما مِن سمات مطلوبة
- السمات الاختيارية: الحدّ الأدنى لمبلغ الشراء
[minimum_purchase_amount]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]، والحدّ الأقصى المسموح به لكمية السلع الممكن شراؤها باستخدام العرض الترويجي[limit_quantity]، والحدّ الأقصى لسعر المنتج في العرض الترويجي[limit_value]، وسعر العرض الترويجي[promotion_price]، وقيمة الخصم النقدي المقدَّم في عرض ترويجي[money_off_amount]، والنسبة المئوية للخصم[percent_off]، والكمية المؤهلة ليسري عليها العرض الترويجي[get_this_quantity_discounted]، والقيمة المالية للهدية المجانية [free_gift_value]، ومعرّف الهدية المجانية[free_gift_item_id]، ووصف الهدية المجانية[free_gift_description]
الخصم المالي [money_off]
- السمات المطلوبة: قيمة الخصم النقدي المقدَّم في عرض ترويجي
[money_off_amount] - السمات الاختيارية: الحدّ الأدنى لمبلغ الشراء
[minimum_purchase_amount]
النسبة المئوية للخصم [percent_off]
- السمات المطلوبة: النسبة المئوية للخصم
[percent_off] - السمات الاختيارية: الحدّ الأدنى لمبلغ الشراء
[minimum_purchase_amount]
خصم بمقدار n عند شراء m [buy_m_get_n_money_off]
- السمات المطلوبة: قيمة الخصم النقدي المقدَّم في عرض ترويجي
[money_off_amount]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]، والكمية المؤهلة ليسري عليها العرض الترويجي[get_this_quantity_discounted] - السمات الاختيارية: ما مِن سمات اختيارية
خصم بنسبة n عند شراء m [buy_m_get_n_percent_off]
- السمات الاختيارية: النسبة المئوية للخصم
[percent_off]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]، والكمية المؤهلة ليسري عليها العرض الترويجي[get_this_quantity_discounted] - السمات الاختيارية: ما مِن سمات اختيارية
خصم على السعر عند شراء m [buy_m_get_money_off]
- السمات المطلوبة: قيمة الخصم النقدي المقدَّم في عرض ترويجي
[money_off_amount]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity] - السمات الاختيارية: ما مِن سمات اختيارية
خصم بنسبة مئوية معيّنة عند شراء m [buy_m_get_percent_off]
- السمات المطلوبة: النسبة المئوية للخصم
[percent_off]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity] - السمات الاختيارية: ما مِن سمات اختيارية
هدية مجانية [free_gift]
- السمات المطلوبة: وصف الهدية المجانية
[free_gift_description] - السمات الاختيارية: الحدّ الأدنى لمبلغ الشراء
[minimum_purchase_amount]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]
القيمة المالية للهدية المجانية [free_gift_with_value]
- السمات المطلوبة: القيمة المالية للهدية المجانية
[free_gift_value] - السمات الاختيارية: الحدّ الأدنى لمبلغ الشراء [minimum_purchase_amount]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي
[buy_this_quantity]
معرّف الهدية المجانية [free_gift_with_item_id]
- السمات المطلوبة: معرّف الهدية المجانية
[free_gift_item_id] - السمات الاختيارية: الحدّ الأدنى لمبلغ الشراء
[minimum_purchase_amount]، وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]
شحن مجاني عادي [free_shipping_standard]
- السمات المطلوبة: ما مِن سمات مطلوبة
- السمات الاختيارية: نوع الشحن المجاني
[free_shipping_type]والحدّ الأدنى لمبلغ الشراء[minimum_purchase_amount]وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]
شحن مجاني في اليوم التالي [free_shipping_overnight]
- السمات المطلوبة: ما مِن سمات مطلوبة
- السمات الاختيارية: نوع الشحن المجاني
[free_shipping_type]والحدّ الأدنى لمبلغ الشراء[minimum_purchase_amount]وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]
شحن مجاني في غضون يومَين [free_shipping_two_day]
- السمات المطلوبة: ما مِن سمات مطلوبة
- السمات الاختيارية: نوع الشحن المجاني
[free_shipping_type]والحدّ الأدنى لمبلغ الشراء[minimum_purchase_amount]وأدنى كمية للعناصر المطلوب شراؤها للاستفادة من العرض الترويجي[buy_this_quantity]
شحن مجاني من خلال إعداد خدمة الشحن [free_shipping_with_shipping_config]
- السمات المطلوبة: ما مِن سمات مطلوبة
- السمات الاختيارية: ما مِن سمات اختيارية
لتنسيق بياناتك بما يتوافق مع Merchant API، اطّلِع على المرجع Merchant API.
أمثلة
| عرض ترويجي يقدّم خصمًا بقيمة 5 دولار أمريكي على طلباتك | |
| السمة | القيمة |
معرّف العرض الترويجي [promotion_id] |
five_dollar_off_friday |
عنوان العرض الترويجي [long_title] |
خصم بقيمة 5 دولار أمريكي يوم الجمعة |
نوع قيمة القسيمة [coupon_value_type] |
money_off |
قيمة الخصم النقدي المقدَّم في عرض ترويجي [money_off_amount] |
5.00 USD |