> For the complete documentation index, see [llms.txt](https://docs.customerglu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.customerglu.com/miscellaneous-topics/testing-campaigns-with-user-logs.md).

# Testing Campaigns with User Logs

**User Logs** helps validate, test, and debug campaigns to ensure every element functions as expected. Use this guide to:

* Validate campaign flows from user registration to reward delivery.
* Debug issues effectively.
* Launch error-free campaigns confidently.

***

### What Are User Logs?

User Logs track the entire journey of a user through campaigns, from registration to reward issuance. They answer key questions such as:

* Is the user registered correctly?
* Are they added to the appropriate segment or audience?
* Are campaign events firing as expected?
* Are rewards and webhooks triggered successfully?

***

### When to Use User Logs

Use User Logs:

* After launching a campaign to verify workflows.
* While staging campaigns to validate setup.
* To troubleshoot issues with events, segments, or rewards.

***

### Step-by-Step Guide

#### 1. Accessing User Logs

1. Navigate to the **User Logs** section in your dashboard.
2. Use the search bar to:
   * Browse recently registered user IDs.
   * Search for a specific user ID to view its details.

<figure><img src="https://1004846827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0ahLW2WavtwcwNbSR9%2Fuploads%2F19Eiuwq5GMEHs9QAAGJa%2FScreenshot%202025-01-09%20at%206.54.10%E2%80%AFPM.png?alt=media&amp;token=788752e0-df39-4391-b4ea-3638a19b68e4" alt=""><figcaption></figcaption></figure>

***

#### 2. Verifying User Registration

* Check if the user is **registered** by reviewing:
  * The **registration timestamp**.
  * Any **errors** in the registration log.

**Common Issue:**

* If the user isn’t registered, confirm the registration event was triggered and verify API/webhook setup.

<figure><img src="https://1004846827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0ahLW2WavtwcwNbSR9%2Fuploads%2FOWwxSARkLe2skEYI9rJg%2FScreenshot%202025-01-09%20at%205.36.34%E2%80%AFPM.png?alt=media&amp;token=8d5a0bd9-d1a9-4220-85c3-37dbcf143f43" alt=""><figcaption></figcaption></figure>

***

#### 3. Checking Segment or Audience Association

* Confirm if the user belongs to the correct **segment** or **audience**:
  * If **no association** is visible:
    * Verify that the **entry rules** for the segment are correct.
    * Ensure the **required events** for segment entry are firing.

**Common Issue:**

* Event payloads may not match segment rules. Check the schema and alignment between events and entry criteria.

<figure><img src="https://1004846827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0ahLW2WavtwcwNbSR9%2Fuploads%2FchNZAaz9UWb1ZDZpOuST%2FScreenshot%202025-01-09%20at%205.36.44%E2%80%AFPM.png?alt=media&amp;token=6635b6e7-1b46-4973-8b4a-b78322be6132" alt=""><figcaption></figcaption></figure>

***

#### 4. Campaign Progression

* Check if the user is participating in campaigns tied to their **segment or audience**:
  * Expand the list of **campaigns** to confirm their enrollment.
  * Ensure they meet the criteria for campaign entry.

<figure><img src="https://1004846827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0ahLW2WavtwcwNbSR9%2Fuploads%2FQCWirzUQq2J8eEEg2KT6%2FScreenshot%202025-01-09%20at%205.36.54%E2%80%AFPM.png?alt=media&amp;token=78bc24d0-c2c3-4540-b8a6-b2d9ad03e70a" alt=""><figcaption></figcaption></figure>

***

#### 5. Analyzing Campaign Workflow

Expand a campaign to verify the user’s progress through each step:

1. **Activities**
   * Confirm if required activities (e.g., logins, clicks) are processed correctly.
   * If not processed, check the expected event trigger.
2. **Events**
   * Ensure mission events are being captured and processed.
3. **Rewards**
   * Validate that rewards are issued for completed activities.
   * Check if the webhook fired successfully and the endpoint responded.

**Common Issue:**

* **Rewards not issued:** Verify webhook configurations and ensure the endpoint is active.

<figure><img src="https://1004846827-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0ahLW2WavtwcwNbSR9%2Fuploads%2FuAY4N0sSLQY1PAp1R3zf%2FScreenshot%202025-01-09%20at%205.37.06%E2%80%AFPM.png?alt=media&amp;token=a669371a-31ab-4958-b0c2-bb2340d8be98" alt=""><figcaption></figcaption></figure>

### Troubleshooting Common Issues

| **Issue**                    | **Cause**                        | **Solution**                                                           |
| ---------------------------- | -------------------------------- | ---------------------------------------------------------------------- |
| **User not registered**      | Registration event not triggered | Verify the event integration and ensure the correct API call was made. |
| **User not in segment**      | Entry rules mismatch             | Check if the event properties align with the segment’s entry criteria. |
| **Activities not processed** | Event trigger issue              | Ensure the required event payload matches the expected schema.         |
| **Rewards not issued**       | Webhook failure                  | Verify webhook URLs and confirm the endpoint is properly configured.   |
| **Campaign flow incomplete** | Missing triggers                 | Check if all required activity triggers are firing for the user.       |

### Conclusion

User Logs provides a comprehensive way to validate and troubleshoot campaigns. By following this guide, you can:

* Verify user registration and segment/audience assignment.
* Track campaign workflows step by step.
* Identify and fix issues proactively.

With this process, you’re equipped to launch campaigns confidently and ensure they perform as expected.