> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-animation/guides-animation.md).

# Engage and Animation Guides

## Animation & engagement : step by step

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-location-crosshairs" style="color:$primary;">:location-crosshairs:</i></h4></td><td><h3>Geolocated notifications</h3></td><td><p>Show a contextual message near a location when a customer is nearby for reminders, on-site information, or store/venue alerts.</p><p><br></p></td><td><a href="/files/EmqbDCcJJtGAjsGz9iBG">/files/EmqbDCcJJtGAjsGz9iBG</a></td><td><a href="/pages/uf6YrsT1flt6Zp32jhz7">/pages/uf6YrsT1flt6Zp32jhz7</a></td></tr><tr><td><h4><i class="fa-arrows-from-line" style="color:$primary;">:arrows-from-line:</i></h4></td><td><h3>Privilege &#x26; animation</h3></td><td>Manage how customer benefits, rewards, and pass privileges are activated and surfaced in Apple Wallet and Google Wallet.</td><td><a href="/files/Pu3wyos0qU4LEyWTHqW8">/files/Pu3wyos0qU4LEyWTHqW8</a></td><td><a href="/pages/o3rtIjC8qzwTa0iXxgmB">/pages/o3rtIjC8qzwTa0iXxgmB</a></td></tr><tr><td><h4><i class="fa-exclamation" style="color:$primary;">:exclamation:</i></h4></td><td><h3>Push notifications</h3></td><td>Compare Apple Wallet and Google Wallet push notifications: triggers, limits, and common use cases with The Wallet Crew.</td><td><a href="/files/LXuVJ7V90sFczzyhawfX">/files/LXuVJ7V90sFczzyhawfX</a></td><td><a href="/pages/9WXsRf2uAS4iw3Fiv7el">/pages/9WXsRf2uAS4iw3Fiv7el</a></td></tr></tbody></table>

**Privileges and activations let you turn a static pass into a living engagement tool.** A privilege is a benefit attached to an individual pass — a discount, a free item, an unlockable reward, a stamp counter — that can be added, updated, or removed at any time without reissuing the pass. Four behavior types cover virtually every loyalty or campaign scenario: OneTime (redeem once), Unlimited (always available while valid), MultiUse (a limited number of uses), and Unlockable (revealed once a condition or progress threshold is met). Each pass can carry up to five privileges at once, with priority rules resolving any conflicts automatically.

**Privileges can come from anywhere in your stack.** They're generated internally by activations, pushed externally through marketing connectors like Salesforce Marketing Cloud or Bloomreach, or created and updated directly via the API. Every privilege carries its own appearance (image, colors), content (title, description), call-to-action links, and a movement-based value history — making it easy to track balances, progress, or redemption codes over time. From event tickets with unlockable afterparty access, to loyalty cards with tiered discounts, gift cards with redeemable balances, and membership passes with monthly quotas, privileges adapt to any real-world use case while keeping the core pass untouched.

**Push notifications complete the engagement loop**, with native, real-time delivery on both Apple Wallet and Google Wallet. Apple notifications are tied to pass updates and appear directly on the lock screen with full message content; Google Wallet offers more flexible, on-demand messaging — including clickable links and rich "Value-Added" content blocks — within a 3-per-day limit. Notifications can be triggered by geolocation, scheduled dates, or events from connected systems (CRM, POS, ticketing), giving brands a single, unified way to keep customers informed and engaged directly from their wallet.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thewalletcrew.io/guides-animation/guides-animation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.