KadamInstall

Overview

This node interacts with the Kadam API to retrieve targeting-related data, specifically for the "Get Countries" operation under the "Targeting" resource. It fetches a list of countries available for ad targeting within the Kadam advertising platform.

Typical use cases include:

• Fetching country options to configure geo-targeted advertising campaigns.
• Dynamically populating dropdowns or lists in workflows that require country selection.
• Integrating country targeting data into broader campaign management or reporting automations.

For example, a user might use this node to get all countries supported by Kadam and then filter or map these countries to set up targeted ad campaigns based on geographic location.

Properties

Output

The node outputs JSON data representing the list of countries retrieved from the Kadam API. Each item in the output array corresponds to a country object with fields such as:

• id: The unique identifier of the country.
• title: The name/title of the country.
• Other optional fields depending on the Output Fields property, e.g., type, parent.

The output structure is an array of objects, each representing a country with the requested fields.

No binary data output is produced by this operation.

Example output snippet (simplified):

[
  {
    "id": 1,
    "title": "United States",
    "type": "country",
    "parent": null
  },
  {
    "id": 2,
    "title": "Canada",
    "type": "country",
    "parent": null
  }
]

Dependencies

• Requires an API key credential for authenticating with the Kadam API.
• The node uses the Kadam API endpoint: https://api.kadam.net/ads.targeting.countries.get.
• Proper configuration of the API token and application ID is necessary in the node credentials.
• Network connectivity to the Kadam API service is required.

Troubleshooting

• Temporary Failures / Rate Limits: If the API returns errors due to rate limiting or transient network issues, enabling the "Retry on Failure" option can help by automatically retrying the request up to 3 times.
• Invalid Credentials: Errors related to authentication usually indicate invalid or expired API tokens. Verify and update the API key credential.
• Empty or Unexpected Response: If no countries are returned or the response format changes, check the Kadam API status or updates to their API schema.
• API Errors: The node surfaces API error messages when requests fail. Review the error description provided in the output for guidance.
• Field Filtering: If specifying Output Fields, ensure field names are valid; otherwise, the API may ignore them or return incomplete data.

Links and References

• Kadam API Documentation (general reference, actual URL may vary)
• Kadam official website for more information about the advertising platform.

Note: Internal credential type names and specific implementation details have been generalized to comply with guidelines.