ثبت تبدیل و فروش

اتصال سرور فروشگاه، شناسه کلیک و سفارش یکتا.

ثبت تبدیل از سرور شما

پس از کلیک، didnex_click_id به مقصد اضافه می‌شود؛ نام قدیمی madar_click_id برای سازگاری باقی است. با رضایت لازم و سیاست داده خودتان، شناسه را به رویداد سرور متصل کنید. مالک سازمان کلید conversions می‌سازد و آن را فقط در سرور نگه می‌دارد. کلیک باید معتبر، متعلق به همان تبلیغ‌دهنده و در پنجره هفت‌روزه باشد.

POST https://didnex.com/ad/v1/conversions
Authorization: Bearer md_YOUR_CONVERSIONS_KEY
Content-Type: application/json

{"clickId":"REQ_FROM_VALID_CLICK","externalId":"ORDER_OR_EVENT_001",
 "name":"purchase","valueRial":1000000}

externalId در سازمان یکتا است. تکرار یک رویداد برای همان کلیک دوباره شمرده نمی‌شود؛ اتصال همان شناسه به کلیک دیگر تعارض دارد. این API تبدیل، کیف پول را شارژ نمی‌کند.

سفارش، فروش و مرجوعی

POST https://didnex.com/ad/v1/commerce/order
Authorization: Bearer md_YOUR_CONVERSIONS_KEY
Content-Type: application/json

{"externalId":"YOUR_ORDER_ID","version":1,"clickId":"REQ_ID","status":"paid",
 "grossRial":1000000,"refundRial":0,"costRial":600000,"paidAt":ACTUAL_UNIX_MS}

مبلغ‌ها ریال صحیح و paidAt زمان واقعی پرداخت هستند. version برای هر تغییر سفارش افزایش می‌یابد؛ بازپخش همان نسخه و محتوا duplicate است، محتوای متفاوت یا نسخه قدیمی خطای 409 می‌دهد. refundRial تجمعی است و کاهش نمی‌یابد. مرجوعی کامل status=refunded و لغو status=cancelled دارد. سفارش بدون clickId در کل فروشگاه می‌ماند و به تبلیغ نسبت داده نمی‌شود.

پلاگین WooCommerce با شناسه نصب قدیمی madar-commerce برای جلوگیری از قلاب سفارش تکراری حفظ شده است؛ قبل از استفاده، اتصال را در فروشگاه staging آزمایش کنید. برای اپ، /ad/v1/business-events با kind برابر registration، activation یا retained_d7 وجود دارد؛ retained_d7 فقط پس از بازگشت واقعی از روز هفتم تا سی‌ام ارسال شود.