@aglyn/aglyn 1.0.0-beta.237 → 1.0.0-beta.239

package/src/lib/app-utils/docs-index.generated.js

@@ -233,7 +233,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'AI credits',
         heading: 'Credits given back',
         anchor: '#credits-given-back',
-        text: 'When a job fails because of something on our side, such as an AI provider error, a step that timed out, or a plan that still broke the building rules after being asked again, its credits are given back automatically:\n- all of them, if it built nothing;\n- the failed step\'s, if it had already built something, which you keep.\nThe job says This one\'s on us — you weren\'t charged. and how many credits came back. Up to three jobs a day are given back this way.\nCredits are not given back when you cancel a job yourself (you pay for what ran until then), or when the AI declines what the brief asked for. A picture that is declined or does not come out is never charged in the first place.'
+        text: 'When a job fails because of something on our side, such as an AI provider error, a step that timed out, or a plan that still broke the building rules after being asked again, its credits are given back automatically:\n- all of them, if it built nothing;\n- the failed step\'s, if it had already built something, which you keep.\nThe job says This one\'s on us — you weren\'t charged. and how many credits came back. Up to three jobs a day are given back this way.\nCredits are not given back when you cancel a job yourself (you pay for what ran until then, and credits held for steps that never ran are released; see Cancel a job), or when the AI declines what the brief asked for. A picture that is declined or does not come out is never charged in the first place.'
     },
     {
         path: '/ai/ai-credits',
@@ -275,7 +275,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'AI jobs and activity',
         heading: 'One job\'s page',
         anchor: '#one-jobs-page',
-        text: 'A job\'s page shows each step as it happens, with its own state (Done, Waiting, In progress, Paused, Not built or Couldn\'t be built) and the credits each step used. From there you can:\n- Confirm plan, when a plan is waiting for you;\n- Resume a job that paused for credits, or Get more AI credits;\n- Try again, or Try again what failed to build only the parts that failed;\n- open what it built: View your site, Edit your pages, or the draft itself.\nFor a new site this is the Building your site page; see Start a new site with AI.'
+        text: 'A job\'s page shows each step as it happens, with its own state (Done, Waiting, In progress, Paused, Not built or Couldn\'t be built) and the credits each step used. From there you can:\n- Confirm plan, when a plan is waiting for you;\n- Resume a job that paused for credits, or Get more AI credits;\n- Try again, or Try again what failed to build only the parts that failed;\n- Cancel a job that is still running (see Cancel a job);\n- open what it built: View your site, Edit your pages, or the draft itself.\nFor a new site this is the Building your site page; see Start a new site with AI.'
     },
     {
         path: '/ai/ai-jobs-and-activity',
@@ -289,7 +289,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'AI jobs and activity',
         heading: 'Cancel a job',
         anchor: '#cancel-a-job',
-        text: 'Cancel job in the window that started a job, or Cancel in the AI jobs list, stops it. What it built so far is kept as drafts. A canceled job is charged for what it spent until then.'
+        text: 'You can stop a job at any point before it finishes. Cancel is on:\n- the job\'s own page, such as Building your site;\n- each row of a site\'s AI jobs page, from the row\'s ⋮ menu (Cancel job);\n- each running job in the AI jobs list in Assist, which the AI chip in the top bar opens.\nEach asks first, in a Cancel this AI job? window. Choose Cancel job to stop, or Keep building to let it carry on. Cancel needs the Generate with AI permission on the site.\nWhat happens when you cancel:\n- Nothing more runs. If a step is in progress, it stops, or finishes if it is about to, and the job shows Stopping until it has. Nothing after it starts.\n- What it built stays, as drafts. Pages, layouts and forms it already made are kept as unpublished drafts for you to open, edit or delete. A canceled job never publishes anything, so your live site is unchanged.\n- You pay only for what ran. Credits held for the steps that did not run are released. The steps that finished stay charged, and the job says how much, for example This job used 42 credits before it stopped. A job you cancel is not counted as a failure, so it is not given back and you are not sent a "job stopped" notice.\n- It is recorded. Canceled an AI generation is added to the site\'s activity, with who canceled it.\nA canceled job shows Canceled in every list. A job that is already Done or Failed cannot be canceled; its Cancel is turned off and says why.\nCancel a new site {#cancel-a-new-site}\nIf you cancel a site you started with AI, the Building your site page says You canceled your site and offers:\n- Start again, which reopens the questions with your answers filled in, for a fresh job;\n- Use the starter site instead, which gives the site the starter home page. It is offered only while the job had not built anything yet.'
     },
     {
         path: '/ai/ai-jobs-and-activity',
@@ -1304,7 +1304,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Start a new site with AI',
         heading: 'If it does not work out',
         anchor: '#try-again',
-        text: 'If the site cannot be built, the page says Your site was not built and why.\n- Try again reopens the questions with your answers filled in, so you can adjust them and start a fresh job.\n- Use the starter site instead gives the site the starter home page. It is offered only while nothing has been built.\nWhen a job fails because of something on our side, the credits it used are given back: all of them if it built nothing, or the failed step\'s if it had already built some pages. The page says so. A job you cancel yourself is not given back. See Credits given back.'
+        text: 'If the site cannot be built, the page says Your site was not built and why.\n- Try again reopens the questions with your answers filled in, so you can adjust them and start a fresh job.\n- Use the starter site instead gives the site the starter home page. It is offered only while nothing has been built.\nWhen a job fails because of something on our side, the credits it used are given back: all of them if it built nothing, or the failed step\'s if it had already built some pages. The page says so. A job you cancel yourself is not given back. See Credits given back.\nYou can also stop the build yourself with Cancel on the Building your site page. The pages it already made stay as drafts, nothing is published, and the page offers Start again and Use the starter site instead. See Cancel a job.'
     },
     {
         path: '/ai/start-with-ai',
@@ -1367,7 +1367,7 @@ export const DOCS_SECTION_INDEX = [
         title: 'Stock photos in AI sites',
         heading: 'Where the photos come from',
         anchor: '#where-the-photos-come-from',
-        text: 'Photos come from Pixabay, a library of free photos. The job searches it with words from your page, such as dog grooming salon, and picks a photo that fits the space.\nWhen no photo matches, or stock photos are not available on the deployment your workspace runs on, the space gets one of the starter photos that come with every site.'
+        text: 'Photos come from Pixabay, a library of free photos. The job searches it with words from your page and your kind of business, such as ceramic serving bowl for a potter\'s work card or dog grooming salon for a groomer\'s hero, and picks a photo that fits the space.\nA picture of a thing only takes a photo that shows that thing in your line of work: a potter\'s bowl is never filled with a bowl of fruit or a bird at a feeder. When nothing shows the thing itself, the space gets a photo of your craft instead, such as handmade ceramics. One start never uses the same photo twice.\nWhen the search finds nothing at all, or stock photos are not available on the deployment your workspace runs on, the space gets one of the starter photos that come with every site.'
     },
     {
         path: '/ai/stock-photos',
@@ -4316,6 +4316,97 @@ export const DOCS_SECTION_INDEX = [
         anchor: '#related',
         text: '- Sales channels\n- Commerce overview\n- SEO — products emit structured data and join the sitemap automatically.'
     },
+    {
+        path: '/commerce-and-bookings/commerce/couriers',
+        title: 'Couriers for local delivery (DoorDash Drive)',
+        heading: '',
+        anchor: '',
+        text: 'Couriers for local delivery: DoorDash Drive\nWhen you offer local delivery, your own driver takes each order out. With couriers, you can send a DoorDash courier for any local delivery instead, booked from your own DoorDash Drive account:\n- Get a quote, then send. Aglyn asks DoorDash what the delivery costs and when it would arrive. Send the courier, and DoorDash sends a Dasher to your store now.\n- Follow it on the order. The courier\'s progress, live tracking link and arrival estimate show on the order, in the Pickup & delivery queue and on your buyer\'s order status page.\n- The same statuses as your own driver. When the courier picks the order up it is Out for delivery, and when they drop it off it is Delivered, with the same emails your buyer gets for your own driver. If DoorDash cancels the courier or brings the order back, the delivery is marked Delivery failed with DoorDash\'s reason, and you can send it out again.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/couriers',
+        title: 'Couriers for local delivery (DoorDash Drive)',
+        heading: 'Who pays for the courier',
+        anchor: '#who-pays',
+        text: 'DoorDash charges each courier to your own DoorDash Drive account, at DoorDash\'s price for that delivery. Aglyn doesn\'t charge, collect or mark up the courier\'s fee. Your buyers still pay the delivery fee of your delivery zone at checkout, as they do now.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/couriers',
+        title: 'Couriers for local delivery (DoorDash Drive)',
+        heading: 'Connect DoorDash Drive',
+        anchor: '#connect-doordash-drive',
+        text: '1. Sign up for a DoorDash developer account at developer.doordash.com, and create an access key. A test key reaches DoorDash\'s sandbox, where no Dasher is sent; a live key, available once DoorDash has approved your account for production, sends real couriers.\n2. In Aglyn, open your store\'s Settings and find the Couriers card.\n3. Enter your key\'s Developer ID, Key ID and Signing secret — your live key, your test key, or both — and choose Connect DoorDash. Aglyn checks each key with DoorDash before saving it, and keeps the signing secret encrypted.\n4. Under At the store, enter the phone number couriers call when the location your deliveries leave from has none, and a note every courier gets ("Ask at the counter for the order number").\nOrders paid in test mode use your test key, and other orders your live key, so a test order never sends a real courier.\nGet delivery updates as they happen {#webhook}\nThe Couriers card shows a webhook address and, once, a webhook token. In the DoorDash developer portal, add a webhook with that address, set its Authorization type to Basic, and paste the token. DoorDash then tells Aglyn each step of every delivery as it happens.\nWithout the webhook, Aglyn checks every open delivery with DoorDash every 15 minutes, and when you open the order. Lost the token? Choose New webhook token and paste the new one in DoorDash.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/couriers',
+        title: 'Couriers for local delivery (DoorDash Drive)',
+        heading: 'Send a courier',
+        anchor: '#send-a-courier',
+        text: '1. On the Orders page, in the Pickup & delivery card, choose Send a courier on a local delivery\'s row — or open the order and find its Courier section.\n2. Choose Get a DoorDash quote. Aglyn shows DoorDash\'s price and arrival estimate. The price is good for five minutes.\n3. Choose Send courier.\nA courier needs a full street address for the location your deliveries leave from (Products → Settings → Inventory locations) and the buyer\'s street address and phone number on the order. The order must be paid and not yet out for delivery or delivered.\nA delivery has one courier at a time: a second Send courier, or a retry after a lost connection, never books a second Dasher. If DoorDash doesn\'t answer, Aglyn checks with DoorDash within a few minutes and updates the order either way — don\'t book again.\nCancel a courier {#cancel}\nChoose Cancel courier on the order. The delivery stays in your own queue, where you can deliver it yourself or send another courier. DoorDash may still charge your account if the Dasher was already on the way; see DoorDash\'s cancellation terms.\nCanceling or fully refunding an order cancels its courier on Aglyn\'s next check, within 15 minutes.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/couriers',
+        title: 'Couriers for local delivery (DoorDash Drive)',
+        heading: 'What your buyer sees',
+        anchor: '#what-your-buyer-sees',
+        text: 'While a courier is on the way, your buyer\'s order status page shows DoorDash, where the courier is, the arrival estimate and a Track your courier link to DoorDash\'s live map. The Out for delivery and Delivered emails are the ones your own driver\'s steps send.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: '',
+        anchor: '',
+        text: 'Fulfillment networks: ShipBob, ShipMonk and Amazon Multi-Channel Fulfillment\nIf your stock sits in a ShipMonk warehouse, connect that account to your store and Aglyn hands each paid order to it. ShipMonk is available now. ShipBob and Amazon Multi-Channel Fulfillment (FBA inventory) work the same way and appear on the card as each is set up for aglyn.com; until then the card offers only the networks you can connect. Aglyn then:\n- Paid orders go to the network. The items it stocks are sent to it to pick, pack and ship. Items it does not stock stay with you, so one order can be split between the network and your own packing table.\n- Shipments come back to the order. Each parcel the network ships is recorded on the order with its carrier and tracking number, and your customer gets the same shipped email as for a parcel you ship yourself.\n- Stock counts follow the warehouse, if you choose: the network\'s count of each SKU becomes your store\'s count.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: 'Connect a network',
+        anchor: '#connect-a-network',
+        text: '1. Open your store\'s Settings and find the Fulfillment networks card.\n2. Next to ShipBob or Amazon Multi-Channel Fulfillment (when the card offers them), select Connect.\n3. Sign in to that account and allow Aglyn access. You come back to the store settings with the network connected.\nYou need to be an admin of the site to connect, change or disconnect a network. Aglyn never sees your ShipBob or Amazon password; it keeps only the access the network grants, encrypted.\nShipMonk: connect with your API key\nShipMonk connects with an API key from your own ShipMonk account instead of a sign-in:\n1. In ShipMonk, open Account Settings, then Integration API Keys. If you have no API store yet, ShipMonk sets one up for you when you ask under Stores.\n2. Create an API key for your API store, and note the store\'s id shown beside it.\n3. In your store\'s Settings, select Connect ShipMonk, paste the key, enter the store id and select Connect.\nAglyn checks the key with ShipMonk before keeping it, keeps it encrypted, and never shows it again. To use a new key, revoke the old one in ShipMonk: the card asks you to Connect again, and you paste the new one.\nAfter you connect, the card shows a webhook address and a signing secret, once. Give both to ShipMonk (its webhook settings under Integrations, or ShipMonk support) so it tells Aglyn the moment an order ships. Aglyn checks every webhook\'s signature and ignores any that does not match. Without webhooks, Aglyn still reads each order back from ShipMonk every 15 minutes. New webhook secret makes a new secret and ends the old one at once.\n- ShipBob creates a channel for Aglyn in your ShipBob account. Orders appear under it.\n- Amazon asks you to choose the marketplace whose FBA inventory ships your orders, if your seller account sells in more than o'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: 'Settings',
+        anchor: '#settings',
+        text: '| Setting | What it does |\n| Sending | Automatic sends every paid order with a shipping address. Manual sends an order only when you select Send to it on the order. |\n| Ship option (ShipBob) | The ShipBob ship option orders ask for, as named in your ShipBob account. Standard unless you change it. |\n| Shipping service (ShipMonk) | The shipping service orders ask for. It must match a shipping mapping in your ShipMonk account. Standard unless you change it. |\n| Shipping speed (Amazon) | Standard, Expedited or Priority. Amazon bills you for the speed you choose. |\n| Marketplace (Amazon) | The marketplace whose inventory ships. |\n| Keep stock counts in step | Sets your store\'s count of each SKU to what the network can ship. Off until you turn it on. |\nPause stops new orders going to the network. Orders it already has keep coming back as they ship. An order paid while a network is paused is not sent later; send it from the order if you want the network to ship it.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: 'How orders are sent',
+        anchor: '#how-orders-are-sent',
+        text: 'Orders are sent within about 15 minutes of being paid. When an order is sent, each item goes to the network whole if:\n- the item has a SKU that matches a product at the network,\n- the network can ship all of that item\'s units now, and\n- no one else is already shipping it, such as another network or a print-on-demand supplier.\nAnything else stays with you, and the order says why. The network ships what it took; you ship the rest, by buying a label or marking it shipped as usual. While a network holds items, buying a shipping label leaves them off, so a customer never gets the same item twice.\nNothing is sent for:\n- an order with no shipping address, such as an in-person sale or a digital order;\n- a test order, paid in test mode. A network connected to its sandbox takes only test orders;\n- an order whose address is missing a name, street, city, postal code or country (or, in the US and Canada, a state). The order says so; fix the address, then select Send to on the order.\nIf the network refuses an order, for example because it cannot ship to the address, the order shows the network\'s reason and nothing is retried. Select Send to on the order to try again once it is fixed.\nOn the order, the Fulfillment networks section shows where it stands with each network: waiting to be sent, with the network, partly or fully shipped, canceled, or not sent and why.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: 'Stock counts',
+        anchor: '#stock-counts',
+        text: 'With Keep stock counts in step on, Aglyn reads the network\'s count about once an hour and sets your store\'s count of each matching SKU to it. Each change appears in your products\' Stock movements as Count synced, counted by the network.\n- An order that is paid but not yet sent is taken off the count, so it is not sold twice.\n- A product that does not track stock is left alone.\n- A product that counts stock per location is left alone: one number would erase the counts you keep for each location.\n- Turn this on only for SKUs the network holds all of. If you also keep some of a SKU on your own shelf, the network\'s count replaces yours.\nThe card shows how many SKUs the network holds and how many of your counts the last sync changed. Sync now counts again straight away.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: 'Shipments and tracking',
+        anchor: '#shipments-and-tracking',
+        text: 'Each parcel the network ships becomes a shipment on the order, with its carrier and tracking number. When every item has shipped, the order is Fulfilled.\n- Amazon reports where each parcel is. Aglyn follows it until it is delivered or returned, for up to 30 days, and the order moves to Delivered when every parcel has arrived.\n- ShipBob tells Aglyn when a parcel is delivered or has a delivery problem, and the order shows it.\n- ShipMonk reports each package of an order, including the parts of an order it split, and where the order is. Aglyn follows it until it is delivered, for up to 30 days. If ShipMonk holds an order, for example on backorder or because it needs an address fixed, the order says so.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: 'Canceling and refunds',
+        anchor: '#canceling-and-refunds',
+        text: 'When you cancel an order, or refund it in full, Aglyn asks the network to cancel it. You can also select Cancel at a network on the order. Once the network has started packing, it may be too late: the order says so, and anything that ships still comes back to the order. ShipMonk\'s warehouse may confirm a cancellation later; the order says it was requested until it does.\nA partial refund does not cancel anything at the network. If it covered items the network still holds, the order tells you, so you can cancel them in the network\'s own account if they should not ship.'
+    },
+    {
+        path: '/commerce-and-bookings/commerce/fulfillment-networks',
+        title: 'Fulfillment networks (ShipBob, ShipMonk and Amazon MCF)',
+        heading: 'Activity',
+        anchor: '#activity',
+        text: 'Each connected network has an activity list on the card: orders sent, parcels shipped, cancellations, stock syncs and errors, newest first.\nIf a network stops accepting the connection, for example after you remove Aglyn\'s access there, the card asks you to Connect again. Orders paid in the meantime wait and are sent once you reconnect.\nDisconnect stops sending orders and removes the stored access. Orders the network already holds are left with it: check them in the network\'s own account, and ship anything it has not shipped another way.'
+    },
     {
         path: '/commerce-and-bookings/commerce/order-notifications',
         title: 'Order emails & status page',
@@ -4755,14 +4846,14 @@ export const DOCS_SECTION_INDEX = [
         title: 'Review platforms (Trustpilot and Yotpo)',
         heading: 'Trustpilot',
         anchor: '#trustpilot',
-        text: 'Invite customers to review your store on Trustpilot after their order ships or arrives, by copying one order email to your Trustpilot invitation address.\nGo to Commerce → Settings and find the Trustpilot card. Under How Trustpilot hears about orders, choose one way, and under When to invite, choose:\n- When the order ships, goes out for delivery or is picked up, or\n- When the order is delivered or picked up.\nTrustpilot\'s own delay setting still applies after that.\nBy your invitation address {#trustpilot-invitation-address}\nTrustpilot gives every business an Automatic Feedback Service address that ends in @invite.trustpilot.com. No key is needed:\n1. Copy that address from your Trustpilot Business account.\n2. On the Trustpilot card, choose Copy an order email to my Trustpilot invitation address and paste it in Trustpilot invitation address. Only an address on invite.trustpilot.com is accepted.\n3. Select Save in the card\'s header.\nThe customer\'s Order shipped, Order out for delivery, Order picked up or Order delivered email (whichever comes first at the moment you chose) is then blind-copied to Trustpilot, with the customer\'s name, email and order number in a part of the email only Trustpilot reads. The customer does not see the copy. If you turn that email off under Order notifications, no copy is sent.\nBy your Trustpilot API key {#trustpilot-api}\nRolling out The API option is not yet available on aglyn.com-hosted workspaces. Until it is, the card offers the invitation address only.\nIf your Trustpilot plan includes API access, you can send invitations through it instead:\n1. In Trustpilot Business, under Integrations → Developers → APIs, create or copy an API key and secret.\n2. On the Trustpilot card, choose Trustpilot API, with my API key, and paste the API key, API secret'
+        text: 'Invite customers to review your store on Trustpilot after their order ships or arrives, by copying one order email to your Trustpilot invitation address.\nGo to Commerce → Settings and find the Trustpilot card. Under How Trustpilot hears about orders, choose one way, and under When to invite, choose:\n- When the order ships, goes out for delivery or is picked up, or\n- When the order is delivered or picked up.\nTrustpilot\'s own delay setting still applies after that.\nBy your invitation address {#trustpilot-invitation-address}\nTrustpilot gives every business an Automatic Feedback Service address that ends in @invite.trustpilot.com. No key is needed:\n1. Copy that address from your Trustpilot Business account.\n2. On the Trustpilot card, choose Copy an order email to my Trustpilot invitation address and paste it in Trustpilot invitation address. Only an address on invite.trustpilot.com is accepted.\n3. Select Save in the card\'s header.\nThe customer\'s Order shipped, Order out for delivery, Order picked up or Order delivered email (whichever comes first at the moment you chose) is then blind-copied to Trustpilot, with the customer\'s name, email and order number in a part of the email only Trustpilot reads. The customer does not see the copy. If you turn that email off under Order notifications, no copy is sent.\nBy your Trustpilot API key {#trustpilot-api}\nIf your Trustpilot plan includes API access, you can send invitations through it instead:\n1. In Trustpilot Business, under Integrations → Developers → APIs, create or copy an API key and secret.\n2. On the Trustpilot card, choose Trustpilot API, with my API key, and paste the API key, API secret and your Business unit ID. Add your Business user ID, a Language such as en-US, and an Invitation template ID if you use them.\n3. Select '
     },
     {
         path: '/commerce-and-bookings/commerce/review-platforms',
         title: 'Review platforms (Trustpilot and Yotpo)',
         heading: 'Yotpo Reviews',
         anchor: '#yotpo-reviews',
-        text: 'Send each shipped order to your Yotpo Reviews account, so Yotpo asks the customer for a review.\nRolling out Yotpo Reviews is not yet available on aglyn.com-hosted workspaces. Until it is, no Yotpo Reviews card appears.\n1. In your Yotpo Reviews settings, copy the app key and secret key. These are not the keys of Yotpo Loyalty & Referrals, which connects under Rewards.\n2. On the Yotpo Reviews card under Commerce → Settings, paste both, turn on Send shipped orders to Yotpo for review requests, and select Save.\nWhen an order first ships or is picked up, Aglyn sends it to Yotpo with its items, marked fulfilled, and Yotpo sends the customer its review request after the delay set in your Yotpo account.'
+        text: 'Send each shipped order to your Yotpo Reviews account, so Yotpo asks the customer for a review.\n1. In your Yotpo Reviews settings, copy the app key and secret key. These are not the keys of Yotpo Loyalty & Referrals, which connects under Rewards.\n2. On the Yotpo Reviews card under Commerce → Settings, paste both, turn on Send shipped orders to Yotpo for review requests, and select Save.\nWhen an order first ships or is picked up, Aglyn sends it to Yotpo with its items, marked fulfilled, and Yotpo sends the customer its review request after the delay set in your Yotpo account.'
     },
     {
         path: '/commerce-and-bookings/commerce/review-platforms',
@@ -9802,7 +9893,35 @@ export const DOCS_SECTION_INDEX = [
         title: 'Ad tracking',
         heading: 'Related',
         anchor: '#related',
-        text: '- Cookie consent — the advertising question and the consent modes\n- Google Analytics events — the same moments, in your GA4 property'
+        text: '- Server-side ad conversions — send purchases and leads from the server too\n- Cookie consent — the advertising question and the consent modes\n- Google Analytics events — the same moments, in your GA4 property'
+    },
+    {
+        path: '/marketing-and-automation/analytics/connect-conversions-api',
+        title: 'Server-side ad conversions',
+        heading: '',
+        anchor: '',
+        text: 'Server-side ad conversions\nSend purchases and leads to Meta, TikTok and Pinterest from the server as well as from the browser tag, so a conversion is still counted when an ad blocker or a closed tab stops the tag. Everything uses your own accounts: the access tokens are yours, and what is sent goes to your ad accounts, not to Aglyn\'s.'
+    },
+    {
+        path: '/marketing-and-automation/analytics/connect-conversions-api',
+        title: 'Server-side ad conversions',
+        heading: 'Connect an account',
+        anchor: '#conversions-api',
+        text: 'Site → Setup → Ad conversions. Each vendor has its own card there. Connect it with an access token from your own account.\nMeta Conversions API {#meta-conversions-api}\nSend purchases and leads to your Meta pixel from the server, for visitors who allowed advertising, so ad blockers and closed tabs do not lose them.\n- Access token: Events Manager → your pixel → Settings → Conversions API → Generate access token.\n- Also needed: the Meta pixel ID on the Tracking tab.\nTikTok Events API {#tiktok-events-api}\nSend purchases and leads to your TikTok pixel from the server, for visitors who allowed advertising, so ad blockers and closed tabs do not lose them.\n- Access token: Ads Manager → Assets → Events → your pixel → Settings → Events API → Generate access token.\n- Also needed: the TikTok pixel ID on the Tracking tab.\nPinterest Conversions API {#pinterest-conversions-api}\nSend purchases and leads to your Pinterest ad account from the server, for visitors who allowed advertising, so ad blockers and closed tabs do not lose them.\n- Access token: Pinterest Ads → Conversions → Conversions API → Generate new token.\n- Also needed: your ad account ID.\nHow it works {#how-it-works}\nThe token is stored encrypted and is never shown again; to change it, use Replace token.\nOnce connected, your site sends from the server:\n- Purchases — every paid online order whose shopper allowed advertising when they started checkout. Orders taken at the register are not sent, and a subscription\'s first payment is reported by the browser tag only; renewals are not reported at all.\n- Leads — every form submitted by a visitor who allowed advertising.\nEach server event carries the same event ID as the browser tag\'s event for the same purchase or lead, so Meta, TikTok and Pinterest keep one and count it once. An '
+    },
+    {
+        path: '/marketing-and-automation/analytics/connect-conversions-api',
+        title: 'Server-side ad conversions',
+        heading: 'Test events',
+        anchor: '#test-events',
+        text: '- Meta and TikTok: paste the test event code from the vendor\'s test events tool into the card. Send test event sends one test Purchase with it, and orders paid in Stripe\'s test mode are sent with it too. Real orders never carry it. Without a code, nothing from a test-mode order is sent.\n- Pinterest: test events and test-mode orders are sent with Pinterest\'s test flag, which Pinterest checks and does not record as a conversion.\nA test-mode order is never sent as a real conversion.'
+    },
+    {
+        path: '/marketing-and-automation/analytics/connect-conversions-api',
+        title: 'Server-side ad conversions',
+        heading: 'Related',
+        anchor: '#related',
+        text: '- Ad tracking — the browser tags these events are paired with\n- Cookie consent — the advertising question both depend on'
     },
     {
         path: '/marketing-and-automation/analytics/cookie-consent',