メインコンテンツまでスキップ

Adjust FAQ（セルフチェック版）

最終更新 2026/10/07

1. Push API​

1.1 SDKの初期化順序（必読）​

警告

ThinkingData & Adjust SDKは、次の手順に厳密に従って初期化とインターフェースの呼び出しを行う必要があります

  • ThinkingDataクライアントSDKを初期化します
  • 自動統合または手動統合のインターフェースを呼び出して、distinct_idをサードパーティイベントに設定します（設定コードは公式ドキュメントを参照してください。本記事では説明を省略します）
  • Adjust SDKを初期化します

1.2 AEの設定 - データソースのターミナルアドレスが空の場合の対処​

  • AE管理画面の「プロジェクト管理」—「プロジェクト構成」—「データアクセスアドレス」に、8991ポートのサーバーアドレスを追加します。アドレスは貴社の運用担当者にご確認ください。その後、Adjustプラットフォームのターミナルアドレスが自動的に同期されます。

1.3 Adjustコールバックプランのステータス​

1.3.1 ステータス1：エラー​

1.3.2 「エラー」の原因​

  • Adjustコールバックプランの作成または更新後、2時間以内にデータのコールバックがない。
  • 72時間以内にデータの統合はあるものの変換失敗がある、または72時間を超えて新しいイベントのコールバックがない。

1.3.3 変換失敗の原因の分析​

  • データ変換に失敗した原因を確認するには、プランの右上にある「詳細」アイコンをクリックし、データ詳細で変換に失敗した原因を確認します

  • シナリオ：「データの変換が失敗しました。エラー詳細: ユーザーIDを関連付けることができません」

1.3.4 ステータス2：統合済​

  • プラットフォームの統合ステータスが「統合済」であれば、そのプラットフォームからデータを受信し、データが格納されていることを示します。この場合、統合ページまたは各プラットフォームの設定ページで「詳細データ」をクリックすると、受信した直近1000件のデータを確認できます：

1.3.5 ステータス3：アクセス待ち​

  • 設定完了後にAEへイベントがコールバックされない場合は、Adjustの管理画面でコールバックURLが正しく設定されているかを確認してください

1.4 te_ads_objectプロパティとは？他のフィールドを格納できますか？​

  • te_ads_objectオブジェクトは標準化されたオブジェクトフィールドです。サードパーティプラットフォームごとにフィールド名は異なるものの意味が同じフィールドを、このオブジェクトにまとめて格納し、後続の分析に利用できるようにします。
  • 可能です。「ユーザープロパティの格納設定」モジュールで設定できます。ソースプロパティ名には変換前のフィールドを、ターゲットプロパティ名には格納するフィールド名を指定します
    • 例：Adjustがコールバックしたローデータのフィールドidfaをte_ads_objectオブジェクトにマッピングします。

1.5 特殊イベント（露出、クリック、コストデータ）の格納ルール​

  • impression、click、Ad spendのコールバックデータはカスタムパラメータの送信に対応していないため、カスタムユーザーIDを含めることができません。このようなデータを統合するために、AEシステムはこれらのデータを自動的に1人の「仮想ユーザー」に紐付けます。ユーザーレベルのimpressionとclickのデータ量は非常に多いため、Adjust Report Service APIで上記イベントの集計データを取得することをお勧めします。

    データタイプ説明AEに格納後のイベント名イベントの仮想ユーザー
    impression露出adjust_impressionwithout_id
    clickクリックadjust_clickwithout_id
    ad_revenue収益adjust_ad_revenuewithout_id

1.6 Adjustコールバックプランはコスト/費用データのコールバックに対応していますか？​

  • 非対応：Adjustの制限により、現在コストデータのコールバックには対応していません。Adjust Report Service APIでコストデータを取得することをお勧めします

1.7 Adjustがコールバックしたinstallイベントと、AE SDKが収集したta_app_installイベントの数が一致しないのはなぜですか？​

  • データ量の差が小さい場合：

    • 通常は、インストールイベントの収集ルールが異なることが原因です。ta_app_installは、APPの新規インストールまたはアンインストール後の再インストールが行われるたびに1回トリガーされます。一方、Adjust SDKのinstallイベントには一定のウィンドウ期間があり、ウィンドウ期間内にアンインストール・再インストールしてもインストールイベントは再送信されません。Adjustのウィンドウ期間については、次のドキュメントを参照してください：Attribution windows | Adjust Help Center

  • データ量の差が大きい場合：

    • 比較するサンプリング期間が短すぎないか、比較するタイムゾーンが一致しているか。
    • AE SDKまたはAdjust SDKが統合されていないAppバージョンやチャネルパッケージがないか。
    • サードパーティのコールバックプランが「エラー」ステータスになっていないかを確認し、Adjustのエラーのトラブルシューティングのドキュメントに従って調査・対処してください

1.8 イベントはすべて変換に成功しているのに、データが見つからないのはなぜですか？​

  • プロジェクトで強検証モード（プロジェクトデータ処理ルール）が有効になっているかを確認してください。有効になっている場合は、いったんこのモードを無効にし、データが一定量コールバックされてから再度有効にすることをお勧めします。
    • 強検証モードかどうかの確認方法：右上の設定ボタンをクリックし、「プロジェクト管理」をクリックして、「レポーティングデータ処理ルール」を確認します。

1.9 アトリビューションチャネルmedia_sourceがunattributedやrestrictedと表示される問題​

2. Report Service API​

2.1 データの取得の成功・失敗を確認するには？​

  • 設定が完了したら、プランの右上にある「一回取得」をクリックします。取得結果は内部メッセージで通知されます。
  • 取得成功の例
  • 取得失敗の例

2.2 Report Service APIのデータとAdjust管理画面のデータを照合すると一致しないのはなぜですか？​

  • ディメンションの違いやパラメータの設定によってデータに差異が生じていないかを確認します

    • Adjustのダッシュボードのデータとタイムゾーンが一致しているか
    • アトリビューション設定がすべてデフォルトになっているか

  • チャネルタイプのフィルターを取得データと一致させます（現在、Report Service APIでデフォルトで取得するデータタイプはnetworkです）

  • Adjust APIのデータには遅延や更新による変動があるため、数日前のデータが正確かどうかを確認してください。一部の日付のデータのみが不正確な場合は、再取得を試してください

2.3 Report Service APIは当日のデータの取得に対応していますか？取得頻度はどのように設定すればよいですか？​

  • 当日のデータの取得に対応しています

  • Adjustには動的な補正メカニズムがあり、過去のデータをいつ受信しても当日のデータ値が動的に補正されるため、データが安定するまでの決まった期間はありません。補正後のデータを確実に取得できるよう、取得する時間範囲を適宜広げます。

    • データのリアルタイム性の要件が高い場合：毎時、直近3-7日のデータを取得するよう設定することをお勧めします
    • データのリアルタイム性の要件がない場合：毎日12時に直近3-7日のデータを取得するよう設定することをお勧めします

  • 取得の時間ディメンションの切り替え方法は下図を参照してください

2.4 同じプランで複数のApp IDを設定するには？​

  • 下図のように、複数のApp IDを半角カンマ,で区切るだけです

2.5 同じ時間範囲のデータを繰り返し取得すると、データが重複しますか？​

  • 同じ時間範囲のデータを複数回取得しても、データが重複することはありません。同じ時間範囲のデータは、新しいデータで全体が上書きされます

2.6 取得するイベント名を変更するには？​

  • event_nameに対応する値を変更するだけです

2.7 Report Service APIでデフォルトで取得するattribution_typesとは​

  • デフォルトはallで、すべてのアトリビューションタイプを取得します。

2.8 よくある取得エラーと対処方法​

  • Create event and props failed!
    • このエラーは通常、初めてデータを取得するとき、またはプランに取得フィールドを追加したときに発生します。サーバーの過負荷によって新しいフィールドの作成に失敗し、エラーが発生する可能性があります。10分ほど待ってから、再度データの取得をお試しください。問題が解決しない場合は、連絡用グループ内のThinkingAIのカスタマーサクセスマネージャー（CSM）またはThinkingAIの技術担当者にお知らせください。
  • The job conflicts with the scheduled
    • このエラーは、同じ取得プランで前回の取得タスクの実行が終わらないうちに、新しい取得タスクが実行されたことが原因です。通常は無視するか、10分ほど待ってから再取得してください
  • Get thirdparty data failed! The possible error is: {"error_code":"request_error","error_desc":"User doesn't have enough permissions loc=roas","source":"API","show_error":true}
    • metricsのrevenue関連はすべて非対応のため、削除する必要があります。これはアカウントの権限に関係しています。その他のディメンションはテストが必要です

Adjustのアンインストールイベントの変換失敗​

  • 原因: アンインストールイベントではカスタムパラメータを送信できません
  • 解決: アトリビューションデータが必要な場合は、インストールイベントやその他のアプリ内イベントにコールバックアドレスを設定できます

Adjustのリクエストでstart_dateエラーが発生する​

  • 原因: start_date: should not be in the future
  • 解決: 定期取得の取得時刻をサーバー時刻より前にする必要があります

Adjustの広告階層のデータが一致しない​

  • 原因: 一部のデータがUnattributedに分類されているか、campaign_nameフィールドに振り分けられています
  • 解決: データの分布を確認し、アトリビューションのロジックを確認します

AdjustのアトリビューションデータとAEの管理画面のデータが一致しない​

  • 原因: コールバックデータはorganicだが、AD管理画面ではGGになっている
  • 解決: Adjustに問い合わせて、データソースを確認する必要があります

AdjustのFBチャネルのデータが一致しない​

AdjustのSKAN関連の設定​

  • イベントタイプごとにcallback urlを入力すると、以降は対応するイベントのみがAEにコールバックされます
  • essentialとadvancedはコールバックアドレスに連結するプレースホルダーで、コールバックアドレスに設定する必要があります
  • コールバックアドレスにプレースホルダーcreated_at_milli={sk_ts}を追加します

Adjustのコールバックでユーザープロパティが欠落する​

問題： Adjustのコールバックイベントでユーザープロパティのコールバックを設定しているのに、AEプラットフォームのユーザープロパティに対応するフィールドがない。

原因の分析：

  • AdjustのコールバックURL内のプレースホルダーの設定が不完全
  • 一部のプロパティは、Adjust SDK側での送信が必要
  • カスタムマクロがAdjustの管理画面で設定されていない

解決策：

  1. AdjustのコールバックURLに必要なプレースホルダーがすべて含まれているかを確認します
  2. Adjustの管理画面で必要なカスタムマクロを設定します
  3. コールバックデータのユーザープロパティフィールドに値があるかを検証します

コールバックがwithoutIDになる問題​

問題： Adjustのコールバックデータがすべて"withoutID"ステータスと表示される。

原因の分析： Adjustがコールバックしたインストールイベントが、AEプラットフォーム上の既存ユーザー（#distinct_idまたは#device_id）と一致しないため、"withoutID"とマークされます。

解決策：

  • クライアントSDKが送信する#device_idと、Adjustがコールバックする{adid}が一致していることを確認します
  • SDKの初期化がAdjust SDKより前に完了しているかを確認します
  • AdjustのコールバックURLにデバイス識別パラメータが含まれているかを検証します

Adjustのデータ変換後にwithout IDと表示される​

  • 原因: Unity SDKのバージョンの問題です。Adjust 5.0以上に対応するには、3.4.0に更新する必要があります

設定の補足​

チャネルをフィルタリングするには​

チャネルのフィルタリング：

"extra_params": {"allPurpose": "{\\"partner_name__in\\":\\"xxx\\"}"}

フィルターを使用するには​

フィルターを使用する場合、keyにはフィルタリング対象のフィールドをそのまま使用します：

"extra_params": {"attribution_source": "xxx"}

広告収入プラットフォームを指定するには​

広告収入プラットフォームの指定：

"extra_params": {"ad_revenue_sources": "applovin_max_sdk"}

エラーの補足​

start_dateのエラー​

  • エラーメッセージ：{"error_code":"request_error","error_desc":"KPI Service: start_date: should not be in the future (400)"}
  • 解決策：定期取得の取得時刻をサーバー時刻より前にする必要があります。

取得エラー​

  • エラーメッセージ：
Get thirdparty data failed! The possible error is: {"error_code":"request_error","error_desc":"Invalid app tokens. No apps matching the given app filters combination loc=app_tokens"
  • 解決策：app_tokenが無効です。app_tokenとAPI tokenの所属関係を確認してください。
    curlでの検証：リクエストパラメータからapp_token__inを削除し、dimensionsにapp_tokenを追加して、返されたデータにどのapp_tokenが含まれているかを確認します 
     //リクエストパラメータにadjust_account_idを追加すると、個人アカウントに属するアプリのデータを返せます。設定例
      "extra_params": { "adjust_account_id": 12345 }
このページは役に立ちましたか？
このページの内容