Keitaro — Integration

Minimal instructions to get started with Keitaro integration in PostTrack.

---

What You'll Need

• Keitaro URL domain (e.g., tracker.example.com)
• Admin API key for Keitaro

---

Where to Get the API Key in Keitaro

1. Log in to Keitaro as admin.
2. Open Profile → API keys.
3. Click Create (Create a new key). (It's recommended to use a key with read-only access)
4. Copy the generated value — it's shown only once.

If you lose the key, create a new one and delete the old one.

---

Where to Insert the Key in PostTrack

1. Go to PostTrack Admin → Integrations → Keitaro.
2. Enable the integration (toggle On).
3. Fill in the fields:
   • Tracker Domain — tracker.example.com (without trailing http/https)
   • API Key — paste the copied key
4. Click Save.

---

Verifying Operation

• Click Check connection (if the button is available). The status should be "OK".
• Open the dashboard/report in PostTrack and verify that data is pulled for the selected period.

---

Common Errors

Symptom	Cause	Solution
401/403	Invalid or expired API key	Create a new key in Profile → API keys, update in PostTrack
404/timeout	Incorrect Tracker URL or domain unreachable	Check domain, HTTPS certificate, network accessibility
Empty reports	No data for the period or timezone mismatch	Change period, ensure clicks/conversions exist in Keitaro

---

Notes

• The integration uses Admin API in read-only mode and doesn't modify anything in Keitaro.
• It's recommended to standardize sub_id_* assignment in traffic sources (buyer / offer / geo) for convenient report filtering.

---