Ingesting assets from Twitter
On this page
Assets are ingested into Amplience User Generated Content (UGC) from Twitter using feeds that are created to use one or more hashtags. A processing job runs once per hour and this ingests all the assets, up to a limit that you specify, that use one of the specified hashtags. These assets then go into moderation, where you can choose to accept or reject each one.
Once you choose to accept an asset from Twitter in the moderation section of the Social app, you must get permission from the user that tweeted it in order to use it. The Social app will generate a tweet, ready for you to send from an account you set up, that is sent in reply to the user's tweet. They can grant permission to use the asset by responding to your tweet using the hashtag you specify, for example "#agree". The asset will then be available for enrichment and adding to a stream.
Configuring Twitter for UGC
In order to send and process the tweets to request permission to use Twitter assets, you must first set up a Twitter account in the Social app. Go to the Feeds section and click the configuration icon as highlighted in the image below. In the Whitelists section add the twitter account from which you wish to send tweets requesting usage permission and the hashtag that you want to use for approval.
The Social app will prepare the permissions tweet for you, but you will need to be logged in to your chosen account in order to send it. UGC uses the whitelist to process only the responses to your specified Twitter account.
Creating a feed
A feed is a search set up to ingest images into Amplience through specifying one or more hashtags from Twitter. To create a feed, click the "Feeds" icon on the left hand side of the Social app window and click the "Add new feed" button on the top left of the window.
In order to create a feed, you need to specify at least one hashtag. In the example below, we're requesting assets from tweets containing the hashtag "anyafinnholidayspecial". You can enter multiple hashtags by clicking the "+" icon and entering a new hashtag.
The Feed Title will change by default to the first hashtag you have entered although you can update this name to anything you wish.
A Start Date must be specified but an end date is not necessary. Click on the field in order to open the drop down calendar. If an end date has been set, this is the time at which the feed will stop ingesting.
Running the UGC ingestion Processing Job
Once a feed has been created, assets with the specified hashtags will need to be ingested into the Amplience account. This is achieved through running the processing job set up on your account.
By default the processing job will be set to run every 1 hour. It is also possible to run the job immediately so that you can see the images that are being brought through into the Amplience platform.
In your Ondemand account, go to 'Assets', 'Tools' and then to 'Processing Jobs'. This will open the Processing Jobs page. In your account, you will see that there is a Processing Job named 'UGC'. This is the job which is used to ingest assets into your account. The 'Last Run Date' displays the date at which the last ingestion occurred
You can run the processing job immediately by clicking on the cog next to UGC and clicking on 'Run Now'. A spinning progress icon will show while the job is running and will change to a green tick when it's complete and the "Last Run Date" will be updated.
If you don't have permission to run this processing job, contact your Customer Success Manager.
When you open the Social app, the dashboard will show any new assets that are available for moderation.
If you click in the Feeds section, you can see that the anyafinnholidayspecial feed has recently been run and a single asset was ingested.
Moderating assets ingested from Twitter
Click on Moderation and the newly ingested asset will be shown. The asset is shown, together with the contents of the tweet, including the "#anyafinnholidayspecial" hashtag. You can now choose whether to accept or reject this image.
If you accept the image, an embedded twitter window appears with a tweet already filled in to request permission to use the asset. You should ensure that your browser is logged in to the Twitter account you specified in the configuration section. You can edit the Tweet if you choose, but you should ensure that the hashtag and a link to your terms and conditions are included.
The user receives your response and can choose to reply if they want to allow you to use the image.
If they reply including the hashtag "agree", then the asset will be available for enrichment and adding to streams.