Get/accounts/account_id/promoted_tweetsについて

[wenping.wang]

https://dev.twitter.com/ads/reference/get/accounts/account_id/promoted_tweetsのpromoted tweetのレスポンスには、全ての広告(promoted tweet)のデータを含みますか？例えば、広告のステータスや目的によって含まれないデータはありますか？

背景としましては、
account_id/promoted_tweets APIで取得したデータの中に
scoped_timeline APIで(scoped_toをnoneに指定)取得した一部のtweet_idがありませんでした。

[nissy_tw]

@wenping.wang さん、お問い合わせありがとうございます。

ご認識の通り、
https://dev.twitter.com/ads/reference/get/accounts/account_id/promoted_tweets
こちらのPromoted tweetレスポンスには全Promoted tweet（広告配信設定されているもののみ※ただし、削除されたツイートは要追加パラメータ）が含まれます。

一方で
https://dev.twitter.com/ads/reference/get/accounts/account_id/scoped_timeline
こちらはPromoted tweetのみに限らず全Tweetの取得が可能です。

[wenping.wang]

私の説明不足でちょっと食い違いがあるようですね。

・やりたいこと
promoted tweetとリンクされているキャンペーン数を知りたい。

・やったこと
Step1. scoped_timeline APIで(scoped_toをnoneに指定)全てのpromoted-only tweetを取得。
Step2. account_id/promoted_tweets APIで tweet_idとpromoted_tweet_idのマッピング表を取得。
Step3. Step1で取得した tweet_id の対応している promoted_tweet_id を探す。
Step4. /promoted_tweets/:promoted_tweet_id APIで promoted_tweet_id を指定し、promoted_tweet_id情報を取得する。

・問題点
Step３において、Step１で取得した 幾つかの広告ツイート（プロモーション中）の
tweet_id が Step2のマッピング表になかったことに気づきました。

問題となる可能性を教えていただけませんか？
それらの広告ツイートが属しているキャンペーンのステータスや目的などによって含まれないデータ
はありますか？

[wenping.wang]

広告配信設定されているのみ

あと、 広告配信設定されているツイート ＝ キャンペーン中のツイート
と認識して良いんですか？

[nissy_tw]

@wenping.wang さん、お問い合わせありがとうございます。

・問題点

Step３において、Step１で取得した 幾つかの広告ツイート（プロモーション中）の

tweet_id が Step2のマッピング表になかったことに気づきました。

こちらはStep１で取得したTweetにプロモーション中ではない（キャンペーン紐付けされていない）広告用ツイートが含まれているためだと思われます。

あと、 広告配信設定されているツイート ＝ キャンペーン中のツイート

と認識して良いんですか？

はい。ご認識の通りです。

[wenping.wang]

回答いただきましてありがとうございます。

質問２については、承知しました。

質問１ですが、認識のずれがまだあるようですね。

こちらはStep１で取得したTweetにプロモーション中ではない（キャンペーン紐付けされていない）広告用ツイートが含まれているためだと思われます。

Step１で取得したプロモーション中の広告ツイートがマッピング表の中に見つからなかったため、
質問させていただきました。

プロモーション中の広告ツイートだと判断した理由は、ads.twitter.comでそういうふうに表示されていたためです。

もう一度確認していただけませんか？

[nissy_tw]

@wenping.wang さん、お問い合わせありがとうございます。
スクリーンショットでいただいたツイート例については下書きステータスのキャンペーンに紐付いているため、まだプロモーション中ではない広告用ツイートに分類されます。

[wenping.wang]

How to get the list of 「まだプロモーション中ではない広告用ツイート」？

Thanks in advance.

[wenping.wang]

まとめますと、

scoped_timeline APIで(scoped_toをnoneに指定することで)全ての広告ツイート（広告配信設定されたものとそうでないもの）を取得できます。

account_id/promoted_tweets APIでは、プロモーション中の広告用ツイートしか取れないんです。

では、プロモーション中でない広告用ツイートの promoted_tweet_id はどのAPIを使えば取得できますか？

[nissy_tw]

@wenping.wang さん、お問い合わせありがとうございます。

プロモーション中でない広告用ツイートの promoted_tweet_id はどのAPIを使えば取得できますか？

tweet_idはscoped_timeline APIで取得可能ですが、こちらはまだ存在していないため、取得できません。

[wenping.wang]

そのプロモーション中でない広告用ツイートが紐付いているキャンペーン情報はどうのAPIを使って取得できますか？

Thanks in advance

[nissy_tw]

@wenping.wang さん

プロモーション中でない広告用ツイートが紐付いているキャンペーン情報はどうのAPIを使って取得できますか？

プロモーション中でない広告用ツイートにはまだキャンペーン情報がございません。ただし、Draft campaignを取得できるAPIであれば先日リリースいたしましたのでこちらを参考にしてください。