トラブルシューティング

コンバージョンAPIのトラブルシューティングとサポート

APIを呼び出した後に表示されるエラーコードに関する質問がある場合は、以下のセクションを参照してください。その他の質問については、Twitter担当者までお問い合わせいただければ、できるだけ迅速に解決します。

エラーの処理と説明

リクエストに含まれるすべてのコンバージョンでエラーがなかった場合のみ、単一リクエストは成功となります。いずれかのコンバージョンにエラーがあった場合、該当するすべてのエラーのリストがエンドポイントから出力されます。

Twitter広告APIのエラーコードの概要

以下は広告APIのエラーコードを網羅したリストです。

https://developer.twitter.com/en/docs/twitter-ads-api/response-codes

コンバージョンAPIの応答が成功した場合には、HTTPコードが200番台となり、リクエストしたオブジェクトがJSONベースのペイロードに含まれます。

500番台のHTTPコードが発生した場合は、リクエストやアカウントの設定ではなく、サーバーの問題が原因です。他のユーザーでも同様の問題が発生している場合は、Twitter APIのステータスページか開発者コミュニティフォーラムを確認してください。

400番台のHTTPコードでよくあるものとしては以下が挙げられます。

400 Bad Request（リクエストが標準に準拠していない）
401 Unauthorized（認証の問題）
403 Forbidden（開発者アカウントに関連するAPIアクセスの問題）
404 Not Found（エンドポイントに対してURLかパラメータが間違っている可能性がある）

コンバージョンAPIのエラーコード

400 Bad Requestのシナリオ

理由	タイプ	エラーメッセージ
識別子欠落エラー（メールアドレスまたはTwitterクリックIDが現在ハッシュ化されている（twclid））	400 Bad Request	At least one user identifier must be provided（少なくとも1つのユーザー識別子を指定する必要があります）
無効なハッシュ化されたメールアドレス	400 Bad Request	Hashed_email is not a valid SHA-256 hash（Hashed_emailは有効なSHA-256ハッシュではありません）
event_idのタイプが単一イベントタグ（SET）ではない	400 Bad Request	Event_id (<event_id>) is not a single event tag (SET)（Event_id（<event_id>）が単一イベントタグ（SET）ではありません）
リクエストされたコンバージョンイベントが上限を超えている（現在はリクエスト1つにつき500イベントまで）	400 Bad Request	Conversion count limit is 500（コンバージョンカウントの制限は500です）
イベントIDの欠落	400 Bad Request	Event ID was not found（イベントIDが見つかりませんでした）

JSONエラーコードの例

リクエスト:

POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time":"2022-06-16T01:14:00.603Z", "event_id":"o6dkt", "identifiers": [{"twclid":"23opevjt88psuo13lu8d020qkn"}]}]}' --header 'Content-Type: application/json'

エラーメッセージ:

{"errors":[{"code":"INVALID_PARAMETER","message":"event_id (o6dkt) is not a single event tag (SET)","parameter":"event_id"}],"request":{"params":{"account_id":"18ce552mlaq"}}}

リクエスト:

twurl_ads -X POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time":"2022-06-16T01:14:00.603Z", "event_id":"o6dl3", "identifiers": [{"twclid": ""}]}]}' --header 'Content-Type: application/json'

エラーメッセージ:

{"errors":[{"code":"INVALID_PARAMETER","message":"At least one user identifier must be provided","parameter":""}],"request":{"params":{"account_id":"18ce552mlaq"}}}

リクエスト:

twurl_ads -X POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time":"2022-06-16T01:14:00.603Z", "event_id":"o6dl3", "identifiers": [{"hashed_email": "abc"}]}]}' --header 'Content-Type: application/json'

エラーメッセージ:

{"errors":[{"code":"INVALID_PARAMETER","message":"hashed_email (abc) is not a valid SHA-256 hash","parameter":"hashed_email"}],"request":{"params":{"account_id":"18ce552mlaq"}}}

リクエスト:

twurl_ads -X POST '/11/measurement/conversions/o6dkt' --data '{"conversions":[{"conversion_time":"2022-06-16T01:14:00.603", "event_id":"o6dl3", "identifiers": [{"twclid":"23opevjt88psuo13lu8d020qkn"}]}]}' --header 'Content-Type: application/json'

エラーメッセージ:

{"errors":[{"code":"INVALID_PARAMETER","message":"Expected Time in yyyy-MM-ddTHH:mm:ss.SSSZ, got "2022-06-16T01:14:00.603" for conversion_time","parameter":"conversion_time"}],"request":{"params":{"account_id":"18ce552mlaq"}}}

401 Unauthorized

理由: 認証情報が不足しているか間違っている

解決策: 次の3つの認証方法のいずれかを使用し、セットアップドキュメントの認証手順に従います。

広告APIアプリケーションを所有していないユーザーのユーザー名のユーザーアクセストークンは、3レッグOAuthフローを使用して生成する必要があります。3レッグOAuthでは、次のいずれかの方法でアクセストークンを生成できます。

コンバージョンAPIで使用するすべてのユーザートークンはアクセスレベル*がAD_MANAGERかACCOUNT_ADMINのユーザーに使用する必要があります。アクセスレベルはauthenticated_user_accessエンドポイントから確認できます。

403 Access Forbidden

理由	タイプ	エラーメッセージ
使用している開発者アカウントに広告APIアクセスがありません。こちらからアクセスを申請してください。	403 Unauthorized Client	The client application with id <> making this request does not have access to Twitter Ads API.Ensure your application has advertiser-api access.Use 'twurl accounts' and 'twurl set default <username> <key>' to change the application you're using.（このリクエストを実行する、ID <>のクライアントアプリケーションにTwitter広告APIへのアクセス権がありません。アプリケーションが広告APIにアクセスできることを確認してください。「twurl accounts」と「twurl set default <username> <key>」を使用して、お使いのアプリケーションを変更してください）

404 Not Found

理由	タイプ	エラーメッセージ
エンドポイントに対してリクエストURLかパラメータが間違っている	404 Route Not Found	The requested resource could not be found（リクエストされたリソースが見つかりませんでした）
pixel_id/ユニバーサルウェブサイトタグを所有するアカウントへのアクセス権がない	404 Not Found	User <user_id> does not have access to account <account_id>.Type 'sn <user_id>’ to get the handle of the user.Use 'twurl accounts' and 'twurl set default ' to change the user you're using.（ユーザー<user_id>にアカウント<account_id>へのアクセス権がありません。「sn <user_id>」と入力してユーザーのユーザー名を取得してください。「twurl accounts」と「twurl set default <username>」を使用して、お使いのユーザーを変更してください。）
ピクセルID（UWT ID）に関連付けられている指定アカウントにイベントIDが属していない	404 Not Found	event_id <event_id> does not belong to provided account（event_id <event_id>が指定されたアカウントに属していません）

JSONエラーコードの例

リクエスト:

twurl_ads -X POST '/11/measurement/conversions/o8z6j' --data '{"conversions":[{"conversion_time":"2022-06-16T01:14:00.603Z", "event_id":"abc", "identifiers": [{"twclid":"23opevjt88psuo13lu8d020qkn"}]}]}' --header 'Content-Type: application/json'

エラーメッセージ:

{"errors":[{"code":"NOT_FOUND","message":"event_id (abc) does not belong to provided account","parameter":"event_id"},{"code":"INVALID_PARAMETER","message":"event_id (abc) is not a single event tag (SET)","parameter":"event_id"}],"request":{"params":{"account_id":"18ce55gze09"}}}