お世話になっております。Ads API Version 8について質問です。
Removed
- url_clicks: This field is always returned as null
とありますが、代替となる指標の取得方法を探しています。
ちなみに https://developer.twitter.com/en/docs/twitter-ads-api/analytics/overview/metrics-derived
にて、{Link Clicks} = promoted_tweet_search_url_clicks + promoted_tweet_timeline_url_clicks + promoted_tweet_profile_url_clicks
という計算で取得できるという記載があるのですが、promoted_tweet_search_url_clicks,promoted_tweet_timeline_url_clicks,promoted_tweet_profile_url_clicks のいずれも取得する方法がわかりません。※ https://developer.twitter.com/en/docs/twitter-ads-api/analytics/overview/metrics-and-segmentation に記載がないため
こちらの計算に関する記載は正しいものでしょうか?
また、正しくないのであれば url_clicksに相当する指標について、v8以降どのように取得すれば良いでしょうか?
ご教授頂けますと助かります。宜しくお願いいたします。
2 Likes
ktym
#2
申し訳ありません、同じ課題のため便乗させていただきます。
私もちょうどversion8の変更内容を見ていてurl_clicksが無くなる旨を拝見し
社内で利用している指標のため代わりとなる項目があるのか確認したかったところです。
もし代わりになる項目が無いという場合、無くなる理由も教えていただけますでしょうか。
こちらを見たのですが old beta product が何を指しているのかわからなく
社内で利用中の指標のため取得できなくなることを説明するための材料がほしかったです。
また"url_clicks" は管理画面上の「リンクのクリック数」に該当すると思うのですが、画面では表示されるがAPIでは取得できなくなるという状態になるのでしょうか。

ご確認よろしくお願いいたします。
1 Like
ほぼ同様の質問をされている方がいらっしゃいました。
B.C
#4
@smdhogehoge さん, @ktym さん、
お世話になっております。
お問い合わせいただき、ありがとうございます。
本件についてですが、
url_clicksはバックエンドで使わなくなったパラメーターなんで、ずっと”Null”で返されているはずですので、つまり無意味のパラメータかと思っております。APIのレスポンスをちゃんと整理するため、今回の新しいV8で削除するようにしました。
ちょっと確認したいのですが、御社側は実際にこのパラメーターで数字とかNull以外の値が返されていたんでしょうか?
もし可能でしたら、コールとレスポンスも頂ければ幸いです。開発側と調査します。
よろしくお願いいたします。
ktym
#6
ご連絡ありがとうございます。
twurl -H "https://ads-api.twitter.com" "/7/stats/accounts/18ce54oans8?entity=PROMOTED_TWEET&start_time=2020-10-06&end_time=2020-10-08&granularity=DAY&placement=PUBLISHER_NETWORK&metric_groups=ENGAGEMENT&entity_ids=4ldyvt" | jq
{
"data_type": "stats",
"time_series_length": 2,
"data": [
{
"id": "4ldyvt",
"id_data": [
{
"segment": null,
"metrics": {
"impressions": [
6349,
12360
],
"tweets_send": null,
"qualified_impressions": null,
"follows": null,
"app_clicks": [
297,
753
],
"retweets": null,
"unfollows": null,
"likes": null,
"engagements": [
297,
755
],
"clicks": [
297,
755
],
"card_engagements": null,
"poll_card_vote": null,
"replies": null,
"url_clicks": [
297,
753
],
"carousel_swipes": null
}
}
]
}
],
"request": {
"params": {
"start_time": "2020-10-05T15:00:00Z",
"segmentation_type": null,
"entity_ids": [
"4ldyvt"
],
"end_time": "2020-10-07T15:00:00Z",
"country": null,
"placement": "PUBLISHER_NETWORK",
"granularity": "DAY",
"entity": "PROMOTED_TWEET",
"platform": null,
"metric_groups": [
"ENGAGEMENT"
]
}
}
}
管理画面上のLink clicks(リンクのクリック数) = url_clicks だと思うのですが
管理画面に存在する項目がAPIから取れなくなってしまう状態になると思ったため代わりになる項目を教えていただきたく問い合わせさせていただきました。
1 Like
ktym
#7
palacement=PULISHER_NETWORKだけかと思ったのですが、ALL_ON_TWITTERでもurl_clicksがある様です。
twurl -H "https://ads-api.twitter.com" "/7/stats/accounts/18ce559i5tw?entity=PROMOTED_TWEET&start_time=2020-10-06&end_time=2020-10-08&granularity=DAY&placement=ALL_ON_TWITTER&metric_groups=ENGAGEMENT&entity_ids=4x0e5n" | jq
{
"data_type": "stats",
"time_series_length": 2,
"data": [
{
"id": "4x0e5n",
"id_data": [
{
"segment": null,
"metrics": {
"impressions": [
2989,
569
],
"tweets_send": null,
"qualified_impressions": null,
"follows": [
5,
0
],
"app_clicks": null,
"retweets": [
1,
0
],
"unfollows": null,
"likes": [
8,
2
],
"engagements": [
63,
11
],
"clicks": [
57,
11
],
"card_engagements": null,
"poll_card_vote": null,
"replies": null,
"url_clicks": [
21,
3
],
"carousel_swipes": null
}
}
]
}
],
"request": {
"params": {
"start_time": "2020-10-05T15:00:00Z",
"segmentation_type": null,
"entity_ids": [
"4x0e5n"
],
"end_time": "2020-10-07T15:00:00Z",
"country": null,
"placement": "ALL_ON_TWITTER",
"granularity": "DAY",
"entity": "PROMOTED_TWEET",
"platform": null,
"metric_groups": [
"ENGAGEMENT"
]
}
}
}
1 Like
@B.C 様
ご連絡ありがとうございます。
こちらでも @ktym 様と同様、 url_clicks の値が入っている状況です。
twurl -H "https://ads-api.twitter.com" "/7/stats/accounts/18ce552q82d?entity=PROMOTED_TWEET&start_time=2020-10-01&end_time=2020-10-07&granularity=TOTAL&placement=ALL_ON_TWITTER&metric_groups=ENGAGEMENT&entity_ids=4w1pt2" | jq
{
"data_type": "stats",
"time_series_length": 1,
"data": [
{
"id": "4w1pt2",
"id_data": [
{
"segment": null,
"metrics": {
"impressions": [
23349
],
"tweets_send": null,
"qualified_impressions": null,
"follows": null,
"app_clicks": null,
"retweets": [
1
],
"unfollows": null,
"likes": null,
"engagements": [
207
],
"clicks": [
206
],
"card_engagements": null,
"poll_card_vote": null,
"replies": null,
"url_clicks": [
42
],
"carousel_swipes": null
}
}
]
}
],
"request": {
"params": {
"start_time": "2020-09-30T15:00:00Z",
"segmentation_type": null,
"entity_ids": [
"4w1pt2"
],
"end_time": "2020-10-06T15:00:00Z",
"country": null,
"placement": "ALL_ON_TWITTER",
"granularity": "TOTAL",
"entity": "PROMOTED_TWEET",
"platform": null,
"metric_groups": [
"ENGAGEMENT"
]
}
}
}
上記、ご確認くださいませ。
また @ktym 様と同じく、管理画面上の Link clicks(リンクのクリック数) に当たる指標も合わせてご教授頂けますと助かります。
B.C
#9
@smdhogehoge 様, @ktym 様
コールとレスポンスをご提示いただき、ありがとうございます。
確かにおかしいですので、こちらで調査させていただきます。
代用の指標についても確認しますので、少々お待ちいただければ幸いでございます。
2 Likes
ktym
#10
お世話になっております。
こちらの状況ですが何か進捗ありましたでしょうか。
本件があるためversion7を使い続けていますが
version7のEOLがMarch 2, 2021ということがあるため、そろそろ対応方針を決めたいと考えています。
@ktym 様
横から失礼します。
ミスだったらしく、version8に url_clicks が復活したようです。
B.C
#13
@ktym様
こちらからの返信できておらず、失礼いたしました。
@smdhogehoge様がご返信した通り、10月中に修正しました。
今後ともよろしくお願いいたします。
ktym
#14
ご連絡ありがとうございます。
こちら承知しました。