AB Tasty icon

AB Tasty

Use the AB Tasty API

Overview

This node integrates with the AB Tasty platform's Public API to manage and update various aspects of AB Tasty experiments, campaigns, user access, and scripts. Specifically, the "Update AB Tasty Script" operation allows users to programmatically update the AB Tasty script associated with an account, which is useful for refreshing or modifying the tracking or personalization scripts deployed on websites.

Common scenarios where this node is beneficial include:

  • Automating the deployment or update of AB Tasty scripts after changes in experiments or configurations.
  • Managing AB Tasty tests, variations, and modifications programmatically.
  • Controlling user access and permissions within AB Tasty accounts.
  • Retrieving detailed information about tests, variations, and third-party tool integrations.

Practical example:

  • After creating or modifying an experiment in AB Tasty, you can use this node to trigger an update of the AB Tasty script to ensure the latest changes are reflected on your website without manual intervention.

Properties

Name Meaning
Account ID The numeric identifier of the AB Tasty account where the script or resource is managed.
Resource Selects the AB Tasty API resource to interact with: Data Explorer API, Public API, or Universal Data Connector API.
Operation The specific action to perform on the selected resource. For Public API, includes operations like updating the AB Tasty script, managing user access, listing tests, etc.
Test ID (Optional) Numeric ID of a test, required for operations related to tests or variations.
Variation ID (Optional) Numeric ID of a variation, required for operations involving variations or modifications.
Modification ID (Optional) Numeric ID of a modification, used when fetching or managing specific modifications.
Third Party Tool Link ID (Optional) Numeric ID for third party tool links related to tests.
User ID (Optional) Numeric ID of a user, required for user access management operations.
Partner Name (Optional) String name of a partner, used when uploading segments via Universal Data Connector API.
CSV File Path (Optional) File path to a CSV file, used when uploading segments.
Query Flagship (Optional) Boolean flag to add a special header indicating a Flagship source.
Visitor ID (Optional) String visitor identifier, used for listing visitor segments.
Query Parameters (Optional) Collection of query parameters to filter or paginate results for list operations.
Request Body (Optional) JSON object used as the request payload for POST, PATCH, or similar operations.

Note: For the "Update AB Tasty Script" operation specifically, the key property is Account ID, which identifies the account whose script will be updated.

Output

The node outputs an array of JSON objects representing the response from the AB Tasty API for each input item processed. The structure depends on the specific operation performed but generally includes:

  • For script update operations, a confirmation or status message indicating success or failure.
  • For data retrieval operations, detailed JSON data about tests, variations, users, or other resources.
  • For deletion or update operations, HTTP status codes or empty responses may be returned.

If the API returns binary data (not typical for these operations), it would be handled accordingly, but this node primarily deals with JSON responses.

Dependencies

  • Requires valid AB Tasty API credentials consisting of a client ID and client secret to obtain an OAuth2 access token.
  • The node makes HTTP requests to various AB Tasty API endpoints depending on the operation.
  • For segment uploads, the node reads CSV files from the local filesystem.
  • No additional external services beyond AB Tasty APIs are required.

Troubleshooting

  • Missing Credentials: If the client ID or client secret is not provided, the node throws an error "Missing Client ID or Client Secret." Ensure that valid credentials are configured.
  • Required Parameters Missing: Many operations require specific IDs (e.g., Account ID, Test ID). Omitting these will cause errors such as "Account ID is required" or "Test ID is required."
  • Failed Access Token Retrieval: If the OAuth token cannot be obtained, the node throws "Failed to retrieve access token." Verify credentials and network connectivity.
  • API Errors: Any API call failure will throw an error with the message "Error calling AB Tasty API" followed by details. Check the API endpoint, parameters, and permissions.
  • File Read Errors: For segment upload operations, if the CSV file path is incorrect or inaccessible, the node will fail reading the file.
  • Invalid JSON in Request Body: When providing a JSON request body, ensure it is well-formed to avoid parsing errors.

Links and References

Discussion