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

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

شما در زبلاین میتوانید رویدادهای مرتبط با محصولات خود را رهگیری کنید.

توجه

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

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

توضیحات

• هر رویداد محصول باید نامی با حداکثر 50 عدد کاراکتر داشته باشد.
• مقادیر برای event data میتواند فقط شامل String, Number, Boolean, Date, JSON Array, JSON Object. JSON Object باشد.
• هر رویداد محصول حداکثر میتواند 25 عدد پارامتر خصوصیت در خود داشته باشد.

ساختار رویدادهای محصول:

رویداد های محصول در زبلاین در قالب یک فایل JSON دریافت و ذخیره میشوند.هر رویداد محصول دارای چهار بخش اصلی است:

{
    "productId": "value",
    "userId": "value" or "null",
    "eventName": "value",
    "eventTime": "2019-12-09T11:29:00",
    "eventData": {
        "1st-data": "value",
        "2nd-data": "value",
        "3rd-data": "value"
    }
}

/productsevents

Method:

POST

Route:

{HOST}/v1/accounts/{YOUR_ZEBLINE_LICENCE_CODE}/productsevents

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}/productsevents'
 \ --header 'Content-Type: application/json' \
 --header 'Authorization: bearer {YOUR_ZEBLINE_ACCESS_TOKEN}' \
 --data '{"productId":"AX22", "userId": "TX111", "eventName": "purchase", "eventTime": "2020-11-16T08:29:00-0800",
 "eventData": { "price" : "123" } }'

PHP

<?php require_once 'HTTP/Request2.php';
 $request = new HTTP_Request2();
  $request->setUrl('{HOST}/v1/accounts/{YOUR_ZEBLINE_LICENCE_CODE}/productsevents');
  $request->setMethod(HTTP_Request2::METHOD_POST);
   $request->setConfig(array( 'follow_redirects' => TRUE ));
  $request->setHeader(array( 'Content-Type' => 'application/json',
   Authorization' => 'bearer {YOUR_ZEBLINE_ACCESS_TOKEN}' ));
   $request->setBody('{"productId":"AX22", "userId" : "wlygvmciosntssb", "eventName" : "product",
"eventTime" : "2020-09-27T22:29:00-0800", "eventData" : { "category" : { "digital":"tehran" } } }');
try { $response = $request->send(); if ($response->getStatus() == 200) { echo $response->getBody(); }
else { echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' . $response->getReasonPhrase(); } }
   catch(HTTP_Request2_Exception $e) { echo 'Error: ' . $e->getMessage(); }

JS

var data = JSON.stringify
({"productId":"AX22", "userId": "wlygvmciosntssb", "eventName": "product", "eventTime": "2020-09-27T22:29:00-0800", 
"eventData": { "category": { "digital": "tehran" } } });
 var xhr = new XMLHttpRequest(); xhr.withCredentials = true;
 xhr.addEventListener("readystatechange", function() { if(this.readyState === 4) { console.log(this.responseText); } });
  xhr.open("POST", "{HOST}/v1/accounts/{YOUR_ZEBLINE_LICENCE_CODE}/productsevents"); 
  xhr.setRequestHeader("Content-Type", "application/json"); xhr.setRequestHeader("Authorization", "bearer {YOUR_ZEBLINE_ACCESS_TOKEN}");
   xhr.send(data);

توجه

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

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

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