Follow-along tutorial
Written tutorial
Integration - an API connection to an ad platform, tool, or software that allows Kitchn.io to read data, make changes or create new objects. In the Integrations section, you can select which ad platforms, tools, or software can be integrated into the automations. We allow you to connect to nine ad platforms and seven software tools. Only the user who created an integration can disconnect it! For the Automation that we are about to set up in this tutorial, you would need to create a Facebook Integration.
To create an integration:
- Go to the Integration section.
- Click on the integration you want to create.
- On the top right corner, click on Connect button.
- Log into your account and follow the instructions.
Automation - a sequence of nodes designed to achieve a specific goal, f.e. importing data into a spreadsheet, increasing the campaign budget, or sending a Slack notification about a disapproved ad.
You can create automations from scratch or import them from our recipe library. With Kitchn Academy Express, you will learn how to import and modify automations. If you want to learn how to build custom automations from scratch, follow The Classic Kitchn Academy.
To import an automation:
- Click on “New Automation”
- Click on the library. Here you will find all automation recipes.
Recipe - a standard template of ready-to-use automation. You can copy-paste a JSON template of any recipe and customize it by inserting your variables, such as Facebook Account Id, days to schedule automation, or spreadsheet id.
- Click on Disapproved ads: Slack Notifier.
- Go to the JSON recipe section. Copy the automation JSON.
- Go back to Kitchnware. Click import automation. Paste the JSON, name your automation and click on “Create.” Congratulations! You've just created your first automation.
Now let's take a look at the automations and learn how you can customize and run them.
Node - the smallest unit of the Kitchn.io, designed to do a specific function, f.e. filter data, fetch insights, or append spreadsheet. Currently, there are almost 200 nodes that will help you build automations without a single line of code!
To add a node to the automation, right-click on the canvas and choose the node from a node menu. Alternatively, click on the “plus” sign in the top right corner. To delete a node, left-click on it and click the trash icon. In our example, we don't need to add any additional nodes to start the automation unless we want to modify the workflow.
Now, let's set up our disapproved ads automation for your ad account. First, take a look at the Select Facebook Ad account node. In this node, specify the ad account from which you would like to pull data.
Each node has input and output sockets that transfer data - they are purple. You can either manually add data to the input fields or connect data from the output of a node to the input field of the other node.
Some nodes have required sockets to be filled to trigger the node successfully. For example, the socket input is needed if you see a yellow warning sign.
To establish a connection of data (purple) sockets:
- Click on the output socket of a node
- Drag a purple line to the input socket of another node
- When both sockets turn purple, you have successfully established the connection!
We will need to repeat the process for a “Select Slack Conversation” node. Select the right Slack channel and connect the sockets to the “Slack Notifier” node.
A schema defines what data type is available for the sockets. You can only connect sockets that have the same schema.
We have conversation_id connected to conversation_ids, which means we transfer data from the selector node to the Slack Notifier. You can see that the conversations_id filed in Slack Notifier is filled!
Green fields are called triggers. They determine the function of the node. In our example, the automation will start with a Fetch Facebook Insights node and end with an Append Google sheets node. Connecting trigger sockets establish the sequence in which nodes will be running. The output sockets will be filled when you trigger the node. Only the “selector” nodes don't have triggers and populate the output sockets when you choose the desired objects.
To establish a connection of trigger (green) sockets:
- Click on the output socket of a node
- Drag a green line to the input socket of another node
- When you see a green line, you have successfully established the connection!
Now that we have specified the data we want for our reporting and figured out the correct node sequence let's move to the spreadsheet. You can create a new spreadsheet for this automation. Then, go to the Select Google Spreadsheet Id node. In the spreadsheet, choose the sheet that you've created. Next, in the tab, choose the tab where you want the raw data to be stored. Now are are ready to run your first automation!
This is a simple automation that goes through all of the ads in the selected ad account every hour, and in case there is a disapproved ad, it will send a notification to the Slack channel of your choice. To run this automation, we just need to select two things: Facebook Account and a Slack Channel. That’s it!
To run an automation
- In the top right corner, click the Run Automation button OR
- In the automation view, on the left side, enable the automation
You can also trigger nodes one by one or run just a part of automation:
To run a partial workflow:
- Click on the node
- Click on the input trigger
- In the top right corner, click Run from here OR
- Enable Breakpoint on Socket field - the automation will stop at this trigger
To run an individual node:
- Click on the node
- Click on the input trigger
- In the top right corner, click trigger
Monitoring automation activity
In the Automation Activity section, you can monitor nodes being triggered. When you click on one of the activities, you will see the details, f.e. which step of processing is happening now. If you click on the name of the activity, you will be shown a canvas with this particular node.
To stop automation:
- Click Abort Automation in the top right corner of the automation activity field
- In the automation view, on the left side, disable the automation
Scheduling automations
Finally, let's schedule the automation to run every hour.
One of the most critical processes within Kitchnware is scheduling and delaying automations, which means you can schedule automation to run on a specific day, at a particular time, or just run it every 1,3,8 hour. It always happens inside of automations.
To delay automation:
- Add Delay node
- In the duration field, enter the delay duration in seconds
- Connect the output trigger of the last node in the automation to
start
- Connect
delayed
to the input trigger of the first node in the automation
To schedule automation:
- Add Delay To node
- Choose weekdays when you want your automation to start in the
weekdays
field - Choose the time when you want your automation to start in the
time
field (time of your browser) - Connect
start
tostart
- Connect
delayed
to the input trigger of the first node
If you want to set up the same automation for another account, you can easily do it by exporting automation.
Exporting:
- Inside the Builder view of your automation, click on the three dots in the top right corner.
- Click “Export Automation”