Environments
Create environments, copy each one's Token, replace a Token or Secret, choose the primary, and promote what one environment publishes to another.
Autopilot > Environments lists the environments of your Product, each with its own Token and Secret. Environments share content and keep user, company and event data apart.
Before you start
- Every change here is admin only. Members see the list and can copy a Token.
- Every Product starts with Production, which is primary, and Development. Neither can be renamed, and no environment you add can take either name.
Setting it up
Create. Choose New environment and give it a name of up to 60 characters. The next screen shows the Token and the Secret together. Copy the Secret now. It is stored in a form nobody can read back, so it is never shown again.
Copy the Token. The arcy.js Token column has a copy control on every row. The Token is what you paste into your snippet, and it is public: it appears in your page source.
Replace a credential. From the row menu, Replace token and Replace secret are separate actions. Each takes effect the moment you confirm.
- A replaced Token stops every page still running the old one from starting ARCY until you update the snippet.
- A replaced Secret stops identity verification from your server until you deploy the new one. Pages are unaffected. The new Secret is shown once.
Set the primary. Set as primary appears on every row that is not primary yet. The primary is where data lands when ARCY cannot tell which environment a request belongs to, and its traffic is the only traffic checked against your verified Origins. The previous primary keeps its Token and its data.
Promote. Promote to... publishes every flow and the Persona that this environment publishes into an environment you pick. Choose the target, read the preview, then confirm.
Element screenshots. A switch per environment. On, picking an element for a flow step stores a small cropped screenshot of it. Off, steps show text and an icon instead, and flows build and run the same.
What it changes
- Renaming changes only the label. The Token is untouched and every install keeps working.
- The primary environment cannot be deleted from here. Deleting the Product deletes it.
- Promote moves only what is published. The target keeps its Token, Secret, Origins and settings. Anything the target publishes that the source does not is withdrawn, not deleted. A row marked Newer content means the source serves an older copy than the draft, and the target receives the draft. Promotion is refused when the source publishes nothing.
- Each promoted object is published on its own. If one fails, the row says why and the rest go through. Running it again finishes the job.
- Last seen on a row is the last time a session arrived with that Token. No data received means none has yet.
Deleting an environment cannot be undone. Its Token stops working and every session, event, user and company recorded in it is deleted with it.
When it goes wrong
You lost a Secret. It cannot be recovered. Use Replace secret, copy the new one, and deploy it.
A row says No data received although the snippet is live. The page is running another environment's Token. Compare the Token in your page source with the row, then verify the install on Installation.