سیگنال های ردیابی سفارش

سیگنال‌های ردیابی سفارش به شما این امکان را می‌دهند که داده‌های ردیابی سفارش تاریخی خود را برای سفارش‌هایی که از طریق سایت تاجر انجام شده‌اند، در اختیار Google قرار دهید. این به خریداران تخمین های حمل و نقل دقیق تر و دقیق تری ارائه می دهد. سیگنال‌های ردیابی سفارش همچنین به شما امکان می‌دهند فهرست‌های خود را با حاشیه‌نویسی حمل و نقل رایگان و سریع ارتقا دهید.

می‌توانید داده‌ها را هم برای سفارش‌های تکمیل‌شده از طریق سایت تاجر و هم از طریق خرید در Google ارسال کنید. داده‌هایی که ارسال می‌کنید، اطلاعات پیکربندی حمل‌ونقل را که به‌عنوان بخشی از راه‌اندازی حساب Merchant Center ارائه می‌دهید، تحسین می‌کند. برای مثال، اگر تخمین‌های حمل و نقل 3 تا 7 روزه را به خریداران ارائه دهید، اما ردیابی سفارش‌های تاریخی اخیر شما نشان می‌دهد که سفارش‌های شما معمولاً ظرف 3 روز در برخی مناطق می‌رسند، Google می‌تواند فهرست‌های شما را به‌روزرسانی کند تا برآورد دقیق‌تری به مشتریان ارائه دهد.

این راهنما نحوه استفاده از سرویس ordertrackingsignals را برای ارسال اطلاعات ردیابی سفارش تاریخی خود توضیح می دهد.

از سرویس ordertrackingsignals استفاده کنید

سرویس ordertrackingsignals شامل یک نقطه پایانی create واحد است که به شما امکان می‌دهد اطلاعات ردیابی سفارش تاریخی خود را ارسال کنید. فقط برای سفارش هایی که تحویل داده شده اند، داده ها را ارسال کنید تا بتوانیم زمان ارسال را بررسی کنیم. برای هر درخواست می توانید یک سفارش ارسال کنید. در بدنه درخواست می توانید اطلاعات زیر را ارسال کنید:

  • اطلاعات سفارش شامل شناسه سفارش و زمان ایجاد سفارش، کد پستی تحویل و کد منطقه
  • هزینه ارسال به خریدار پرداخت می شود ( customer_shipping_fee )
  • اطلاعات حمل و نقل ( shippingInfo ) از جمله حامل، ردیابی، مبدا، مقصد، و زمان حمل برای هر محموله مرتبط با سفارش
  • اطلاعات مورد خط سفارش ( lineItems )، از جمله محصولات موجود در سفارش
  • نقشه برداری از اقلام خط سفارش برای ارسال سفارش ( shipment_line_item_mapping )

  • شناسه تجاری تاجری که برای آن داده ارسال می کنید ( merchant_id ). این فیلد اختیاری است و به شما امکان می دهد از طرف یک تاجر دیگر داده ها را ارائه دهید. اگر مقداری برای این فیلد ارائه نکنید، داده ها با حسابی که آن را ارسال می کند مرتبط می شود.

برای اطلاعات بیشتر در مورد فیلدهای ردیابی سفارش ضروری و اختیاری، به مستندات مرجع برای منبع ordertrackingsignals مراجعه کنید.

اطلاعات سیگنال های ردیابی سفارش جدید را ارسال کنید

در اینجا یک نمونه درخواست برای ارسال اطلاعات ردیابی سفارش جدید آمده است:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/ordertrackingsignals

{
  "merchantId": "987654321",
  "orderCreatedTime": {
    "year": 2020,
    "month": 1,
    "day": 2,
    "hours": 0,
    "minutes": 0,
    "seconds": 0,
    "timeZone": {
      "id": "America/Los_Angeles"
    }
  },
  "orderId": "123456789",
  "shippingInfo": [
    {
      "shipmentId": "1",
      "trackingId": "100",
      "carrierName": "FEDEX",
      "carrierServiceName": "GROUND",
      "shippedTime": {
        "year": 2020,
        "month": 1,
        "day": 3,
        "hours": 0,
        "minutes": 0,
        "seconds": 0,
        "timeZone": {
          "id": "America/Los_Angeles"
        }
      },
      "shippingStatus": "DELIVERED"
    },
    {
      "shipmentId": "2",
      "earliestDeliveryPromiseTime": {
        "year": 2020,
        "month": 1,
        "day": 4,
        "hours": 0,
        "minutes": 0,
        "seconds": 0,
        "timeZone": {
          "id": "America/Los_Angeles"
        }
      },
      "latestDeliveryPromiseTime": {
        "year": 2020,
        "month": 1,
        "day": 5,
        "hours": 0,
        "minutes": 0,
        "seconds": 0,
        "timeZone": {
          "id": "America/Los_Angeles"
        }
      },
      "actualDeliveryTime": {
        "year": 2020,
        "month": 1,
        "day": 5,
        "hours": 0,
        "minutes": 0,
        "seconds": 0,
        "timeZone": {
          "id": "America/Los_Angeles"
        }
      },
      "shippedTime": {
        "year": 2020,
        "month": 1,
        "day": 3,
        "hours": 0,
        "minutes": 0,
        "seconds": 0,
        "timeZone": {
          "id": "America/Los_Angeles"
        }
      },
      "shippingStatus": "DELIVERED"
    }
  ],
  "lineItems": [
    {
      "lineItemId": "item1",
      "productId": "online:en:US:item1",
      "quantity": "3"
    },
    {
      "lineItemId": "item2",
      "productId": "online:en:US:item2",
      "quantity": "5"
    }
  ],
  "shipmentLineItemMapping": [
    {
      "shipmentId": "1",
      "lineItemId": "item1",
      "quantity": "1"
    },
    {
      "shipmentId": "2",
      "lineItemId": "item1",
      "quantity": "2"
    },
    {
      "shipmentId": "1",
      "lineItemId": "item2",
      "quantity": "4"
    },
    {
      "shipmentId": "2",
      "lineItemId": "item2",
      "quantity": "1"
    }
  ],
  "customerShippingFee": {
    "value": "4.5",
    "currency": "USD"
  },
  "deliveryPostalCode": "94043",
  "deliveryRegionCode": "US"
}

اطلاعات سیگنال های ردیابی سفارش موجود را به روز کنید

برای اصلاح داده‌های ردیابی سفارش ارسال‌شده از قبل، درخواستی را ارسال کنید که حاوی داده‌های جدیدی با همان orderId باشد. برای برآورد حمل و نقل و نشان سریع و رایگان، فقط از آخرین داده های ارسالی برای هر orderId استفاده می شود.