Analytics stats for scheduled promoted tweet

[joe-vidmob]

The analytics endpoints allow you to request stats for PROMOTED_TWEET entities, but is it possible to request stats for a scheduled promoted tweet? Do you use the PROMOTED_TWEET entity but with a scheduled_promoted_tweet id?

[juanshishido]

Thanks for the question, @joe-vidmob!

When Scheduled Tweets go live—this is based on the scheduled_at time—the following happens:

• An actual Tweet is created, with its own Tweet ID
• The Tweet ID (tweet_id) is added to the response for the following entities:
  • scheduled_tweets
  • scheduled_promoted_tweets
• A new promoted_tweets entity is created

Once this happens, the actual Tweet is promoted (during the campaign flight dates). This means that metrics (promoted or otherwise) for any scheduled-related entity do not exist. To get promoted metrics, you’ll use entity=PROMOTED_TWEET with the ID for the promoted_tweets entity that is created.

You can map it in the following way.

1. Get the line item ID and the Tweet ID from the scheduled_promoted_tweets entity
2. Make a request to the GET accounts/:account_id/promoted_tweets endpoint and specify the line item ID from #1 in the line_item_ids parameter
3. Using the response from #2, use the Tweet ID to find the specific promoted_tweets entity that corresponds to the scheduled_promoted_tweets entity from #1

I hope this helps!

[joe-vidmob]

Thank you! That makes sense.