# پست‌بک‌ها

پست‌بک به همکارتان (شبکه همکاری در فروش، شبکه تبلیغاتی، پنل پیامک یا سرور خودتان) خبر می‌دهد که یک تبدیل از طرف او آمده است؛ با یک آدرس که مقدارهایی مثل شناسه کلیک و مبلغ سفارش در آن قرار می‌گیرد. هر تراکنش فقط یک بار ارسال می‌شود.

## پست‌بک چیست

بسیاری از شبکه‌های همکاری در فروش و شبکه‌های تبلیغاتی برای پرداخت کمیسیون یا بهینه‌کردن کمپین، به یک «پست‌بک» نیاز دارند: درخواستی به آدرس آن‌ها که شناسه کلیک خودشان و مبلغ سفارش در آن است. صفحه «پست‌بک‌ها» در منوی «لینک‌ها» قرار دارد (`/links/postbacks`) و برای ساختن آن به دسترسی ویرایش تنظیمات وب‌سایت نیاز دارید.

## ساخت پست‌بک

1. در «پست‌بک‌ها» روی «پست‌بک جدید» بزنید.
2. یکی از الگوها را انتخاب کنید و آدرس را با آدرسی که همکارتان داده است جایگزین کنید.
3. روی هر ماکرو کلیک کنید تا در جای مکان‌نما اضافه شود؛ مثلا `https://partner.example/pb?cid={click_id}&payout={revenue}`.
4. در «زمان ارسال» رویدادهای کلیدی را روشن بگذارید یا نام رویدادهای دیگر را بنویسید.
5. در «کدام تبدیل‌ها» مشخص کنید همکار کدام لینک‌های کمپین یا کدام منابع ترافیک است.
6. در «پارامتر شناسه کلیک همکار» نام پارامتری را بنویسید که همکار به لینک‌هایش اضافه می‌کند، مثلا `click_id`.
7. ذخیره کنید و با «ارسال آزمایشی» یک درخواست نمونه بفرستید.

> **درخواست آزمایشی را چطور تشخیص دهیم**
>
> در ارسال آزمایشی، پارامتر `test=1` به انتهای آدرس اضافه می‌شود تا همکار آن را با تبدیل واقعی اشتباه نگیرد.

## ماکروها

| ماکرو | مقدار |
| --- | --- |
| `{click_id}` | شناسه کلیک همکار؛ اگر نبود، شناسه کلیک xen |
| `{param:<name>}` | هر پارامتری که از آدرس صفحه ورود ذخیره شده است |
| `{event_name}` `{event_id}` | نام و شناسه رویداد |
| `{transaction_id}` | شناسه تراکنش یا سفارش |
| `{revenue}` `{currency}` | مبلغ و واحد پول سفارش |
| `{timestamp}` `{timestamp_ms}` | زمان رویداد |
| `{link_code}` `{link_name}` | کد و نام لینک کمپین |
| `{recipient_ref}` | کد مرجعی که برای لینک هر شماره بارگذاری کرده‌اید |
| `{source}` `{medium}` `{campaign}` `{content}` `{term}` | آخرین تعامل کمپینی |

هیچ ماکرویی ایمیل، شماره تلفن یا IP را ارسال نمی‌کند.

## کدام تبدیل‌ها ارسال می‌شوند

در حالت «فقط تبدیل‌های همین همکار»، پست‌بک وقتی ارسال می‌شود که آخرین تعامل کمپینی پیش از تبدیل از یکی از لینک‌ها یا منابع همین همکار باشد و در بازه تعیین‌شده (پیش‌فرض ۳۰ روز) رخ داده باشد. حالت «همه تبدیل‌ها» برای ارسال به سرور یا سیستم گزارش‌گیری خودتان است.

## پرسش‌های پرتکرار

### اگر مشتری صفحه تشکر را دو بار باز کند، دو پست‌بک ارسال می‌شود؟

خیر. شناسه تراکنش (transaction_id یا order_id) کلید ارسال است و هر تراکنش برای هر پست‌بک فقط یک بار فرستاده می‌شود.

### خریدهایی که از WHMCS یا سرور خودم ثبت می‌شوند هم ارسال می‌شوند؟

بله. تبدیل‌هایی که از طریق S2S می‌رسند هم مثل تبدیل‌های مرورگر بررسی می‌شوند و اگر به همکار تعلق داشته باشند پست‌بک می‌گیرند.

### اگر بعد از کلیک روی لینک همکار، کاربر از تبلیغ گوگل برگردد و خرید کند چه می‌شود؟

در حالت «فقط تبدیل‌های همین همکار»، آخرین تعامل کمپینی تعیین‌کننده است. اگر آخرین تعامل تبلیغ گوگل باشد، پست‌بک به همکار ارسال نمی‌شود.

## مطالب مرتبط

- [لینک‌های کمپین](https://docs.adpix.io/fa/analytics/marketing/tracked-links/)
- [رویدادهای کلیدی](https://docs.adpix.io/fa/analytics/collect/key-events/)
- [هشدارها و وب‌هوک‌ها](https://docs.adpix.io/fa/analytics/admin/alerts-and-webhooks/)
- [وب هوک ها و امضای HMAC](https://docs.adpix.io/fa/developers/analytics/developers/webhooks-and-hmac/)

---

[مستندات](https://docs.adpix.io/fa/analytics/marketing/postbacks/) · AdPix