رهگیری محصولات

رهگیری محصولات

زبلاین برای رهگیری و به روز رسانی محصولات یک اند پوینت در نظر گرفته است.

توجه

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

شناسایی محصولات

برای شناسایی محصولات از طریق رست ای پی آی، شما می بایست به روش زیر عمل کنید:

• یک آی دی یکتا برای هر محصول در نظر بگیرید که در حقیقت در سمت زبلاین به نام productId شناخته می شود.
• هر محصول میتواند یک userId به عنوان مالک آن محصول داشته باشد و در صورتی که محصول مالک مشخص ندارم مقدار آن null میباشد.

توجه

فیلد productId در زمان ارسال اطلاعات محصولات اجباری است!

توضیحات

• هر productId میتواند حداکثر 100 کاراکتر داشته باشد.
• هر userId می تواند حداکثر 100 کاراکتر داشته باشد.
• بعد از تخصیص یک productId, دیگر نمی توان آن را تغییر داد.
• اگرچه productId میتواند از نوع رشته (استرینگ) باشد اما پیشنهاد می کنیم که حتما از تولید کننده های آی دی سیستی در دیتابیس خود برای آن استفاده کنید و از به کار بردن دیتای ایمیل و نام محصولی و ... در ساخت آن خودداری کنید.

توضیحات

• کلید های هر فیلد از مشخصات محصولات شما می بایست حداکثر 50 کاراکتر باشد و این نکته را در نظر بگیرید که زبلاین به کوچک و بزرگ بودن حروف حساس است.
• حداکثر 25 فیلد را می توانید در پارامتر های دیتایی یک محصول قرار دهید.

اتریبیوت های سفارشی

اتریبیوت های مختص به کسب و کار شما هستند که طبق نیاز شما تعیین و به لیست اتریبیوت های محصول اضافه میشود. این اتریبیوت ها به شما کمک میکند که درک بهتری از نیازها و سلیقه محصولات خود داشته باشید و بتوانید پیام های شخصی سازی شده متناسب برای آنها ارسال کنید. شناسه اختصاصی شناسه اختصاصی به قسمتی از اطلاعات محصولات گفته میشود که به ازای هر محصول مقدار یونیک دارد. در نتیجه میتوان با استفاده از آن محصولات را متمایز کرد. در زبلاین آیدی (productId) نقش شناسه اختصاصی را ایفا میکند و هر محصول آیدی یکتا و اختصاصی خود را در زبلاین خواهد داشت.

/products

Method:

POST

Route:

{HOST}/v1/accounts/{YOUR_ZEBLINE_LICENCE_CODE}/products

Authentication:

bearer {YOUR_ZEBLINE_ACCESS_TOKEN}

Traffic Limit

10,000 مرتبه در دقیقه

 10,000 requests per minute

پاسخ

{
    "response": {
        "status": "queued",
        "trackID": "c08c97d0-7b11-4490-9305-11ce321abd00"
    }
}

خطا

{
    "response": {
    "message":"productId cannot be empty!",
    "status":"error"
    }
}

توجه

در صورت نیاز به کمک، درخواست خودرا به پشتیبانی زبلاین ارسال کنید.

مثال

Curl

curl --location --request POST '{HOST}/v1/accounts/{YOUR_ZEBLINE_LICENCE_CODE}/products' 
--header 'Authorization: bearer {YOUR_ZEBLINE_ACCESS_TOKEN}' 
--header 'Content-Type: application/json' 
--data-raw '{ "productId": "p-1", "userId": "orbit", "properties": { "attr1": "value1" } }'

PHP

<?php $url = "{HOST}/v1/accounts/{YOUR_ZEBLINE_LICENCE_CODE}/products"; 
$curl = curl_init($url); curl_setopt($curl, CURLOPT_URL, $url); 
curl_setopt($curl, CURLOPT_POST, true); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); 
$headers = array( "Authorization: bearer {YOUR_ZEBLINE_ACCESS_TOKEN}", "Content-Type: application/json", ); 
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers); 
$data = <<<DATA { "productId": "p-1", "category": "gum4", "title": "orbit", "properties": { "attr1": "value1" } } DATA; 
curl_setopt($curl, CURLOPT_POSTFIELDS, $data); //for debug only! curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); 
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); $resp = curl_exec($curl); curl_close($curl); var_dump($resp); ?>

JS

var url = "{HOST}/v1/accounts/{YOUR_ZEBLINE_LICENCE_CODE}/products";

          var xhr = new XMLHttpRequest();
          xhr.open("POST", url);
          
          xhr.setRequestHeader("Authorization", "bearer {YOUR_ZEBLINE_ACCESS_TOKEN}");
          xhr.setRequestHeader("Content-Type", "application/json");
          
          xhr.onreadystatechange = function () {
             if (xhr.readyState === 4) {
                console.log(xhr.status);
                console.log(xhr.responseText);
             }};
        
          var data = {
            "productId": "p-1",
            "category": "gum4",
            "title": "orbit",
            "properties": {
            "attr1":  "value1" 
            }
          };
        xhr.send(data);
          

توجه

عبارت {Host} را با لینک API فرستاده شده به ایمیل خود جایگزین کنید.

عبارت {YOUR_ZEBLINE_LICENSE_CODE }را با لینک ارسال شده به ایمیل خود جایگزین کنید.

عبارت{YOUR_ACCESS_TOKEN} را با لینک ارسال شده به ایمیل خود جایگزین کنید.