rt-personalization

RT 2.0 Personalization - Service and Entity Creation

Creates complete RT personalization: service configuration + Personalization entity with payload deployed to Console.

Prerequisites

• RT configuration complete (rt-config skill or rt-setup-personalization orchestrator)
• RT status: "ok"
• Key events created
• RT attributes configured
• Parent segment folder exists
• TD_API_KEY environment variable set

Two-Step Creation Process

Step 1: Create Personalization Service (YAML workflow)

• Defines sections, criteria, attributes
• Pushed via tdx ps push
• Creates service configuration

Step 2: Create Personalization Entity (API workflow)

• Creates actual Personalization in Console
• Defines entry criteria (key event)
• Defines payload (response attributes)
• Visible in TD Console UI

Both steps required for complete personalization setup.

Migration from Previous Version

If you previously created a personalization service (before this update):

The old skill only created the service configuration (Step 1). The entity (Step 2) was missing, making personalization invisible in Console.

Check if Entity Exists

# Detect region
REGION=$(tdx config get endpoint 2>/dev/null | grep -o '[a-z][a-z][0-9][0-9]' | head -1)
REGION="${REGION:-us01}"

# List existing personalizations
RESPONSE=$(curl -s -w "\n%{http_code}" \
  "https://api-cdp.treasuredata.com/entities/parent_segments/<ps_id>/realtime_personalizations" \
  -H "Authorization: TD1 ${TD_API_KEY}")

HTTP_CODE=$(echo "$RESPONSE" | tail -n1)
BODY=$(echo "$RESPONSE" | sed '$d')

if [ "$HTTP_CODE" = "200" ]; then
  echo "$BODY" | jq '.data[] | {id, name}'
else
  echo "❌ Failed to list personalizations (HTTP $HTTP_CODE)"
  echo "$BODY" | jq '.errors[]? | .detail' 2>/dev/null || echo "$BODY"
fi

If Entity is Missing

Option 1: Run Step 2 Only (Recommended)

• Skip Step 1 (service already exists)
• Follow Step 2 (sections 2a-2e) to create entity

Option 2: Recreate Everything

1. Delete old service: tdx ps pz delete <ps_id> <service_name>
2. Run complete skill (Step 1 + Step 2)