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

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

شما می‌توانید داده‌های مربوط به سفارش‌هایی که از طریق سایت فروشنده تکمیل شده‌اند را ارسال کنید. داده‌هایی که ارسال می‌کنید، مکمل اطلاعات پیکربندی ارسالی است که به عنوان بخشی از تنظیمات حساب مرکز فروشندگان خود ارائه می‌دهید. به عنوان مثال، اگر شما تخمین‌های ارسال ۳ تا ۷ روزه را به خریداران ارائه می‌دهید، اما پیگیری سفارش‌های اخیر شما نشان می‌دهد که سفارش‌های شما معمولاً در برخی مناطق ظرف ۳ روز به دستشان می‌رسد، گوگل می‌تواند فهرست‌های شما را به‌روزرسانی کند تا تخمین دقیق‌تری را در اختیار مشتریان قرار دهد.

این راهنما نحوه استفاده از سرویس 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 استفاده می‌شود.