日本語

ブラックリストトラッカーAPI

AdjustのブラックリストトラッカーAPIエンドポイントは、ダイナミック、あるいはモジュールパートナーのために作成されたトラッカーURLの中で、不正あるいは期限切れのトラッカーURLからのトラフィックを阻止するために使用されます。ブラックリストに登録されたトラッカーURLは、管理画面に BLACKLISTED​ と表示されます。

注意:
SANパートナー(API連携パートナー)のトラッカーURLをブラックリストに登録することはできません。エンドポイントを使用してSANパートナーのトラッカーURLをブラックリストに登録すると、positive resultが返され、管理画面に BLACKLISTED と表示されます。しかし、トラッカーURLはブラックリストに登録されず、アトリビューションが計測されます。SANパートナーのトラッカーURLのトラフィックを阻止するには、Adjust管理画面のパートナー設定画面からSANパートナーを削除してください。

ご利用の条件

  • Business Pro以上の料金プラン

ブラックリストについて

トラッカーをブラックリストに登録すると、Adjustは以下をブロックします。

  • エンゲージメント

    • クリック数
    • インプレッション
  • 以下を含む、パートナーとネットワークへのコールバック:

    • モジュールコールバック
    • ダイナミックコールバック

ブラックリストに登録されたトラッカーは、そのトラッカーに紐付けられた既存のアトリビューションに影響します。つまり、ユーザーのアプリ内セッションおよびイベントは、他のアクティブなトラッカーにリアトリビューションされるまで、引き続きブラックリストに登録されたトラッカーURLに関連付けられることになります。

注意:
また、トラッカーがブラックリストに登録される前に記録されたクリックやインプレッションは、引き続きアトリビューション期間内のコンバージョンの対象となります。

例えば、アトリビューション期間が7日間で、2日目にトラッカーがブラックリストに登録された場合、1日目に記録されたクリックに対して、週の後半にインストールをアトリビュートすることも可能です。

ブラックリスト登録の解除

また、AdjustのブラックリストトラッカーAPIを使用して、トラッカーのブラックリスト登録を解除することもできます。トラッカーのブラックリスト登録が解除されると、Adjustはそのトラッカーからのエンゲージメントの計測およびコールバックの送信を再開し、Adjustキャンペーンウィザードでのトラッカー設定の編集が可能になります。

注意:
トラッカーのブラックリスト登録の解除は即有効になりますが、アトリビューションデータに遡って適用されることはありません。登録解除後に実行されたトラッカーのエンゲージメントのみが、アトリビューションファネルの範囲内と見なされます。

ブラックリストに登録されたトラッカーを見る

Adjust管理画面でブラックリストに登録されたトラッカーを確認するには、次の手順に従ってください。

  1. 該当アプリの下部に表示されている(▲)ボタンを選択します。
  2. トラッカーURL(Tracker URL)​ を選択します。
  3. ブラックリストに登録されたトラッカーの横にある 設定(Settings)​ (歯車アイコン)を選択します。

トラッカーは ブラックリスト登録済み(BLACKLISTED)​ と表示されます。

ブラックリストに登録されたトラッカーの EDIT(編集)​ を選択した場合、唯一のオプションは、トラッカーを非表示することです。トラッカーを非表示にすると、有効なトラッカーリストには表示されなくなります。ブラックリストに登録されたトラッカーは、いつでも表示または非表示にできます。トラッカーを非表示にする方法については、トラッカーのメンテナンスをご覧ください。

ブラックリストトラッカー

エンゲージメントの計測、アトリビューション、トラッカーおよび関連するサブトラッカーへのコールバックをブロックするには、以下のブラックリストトラッカーAPIのエンドポイントを使用します。

エンドポイント:

https://api.adjust.com/dashboard/api/trackers/{tracker}/blacklist

要件

パラメーター定義
{tracker}
必須
アルファベットと数字で構成されたAdjustトラッカートークン

サンプルリクエストの例(curlを使用)

curl -H "Authorization: Token token={api_token}" -X POST "https://api.adjust.com/dashboard/api/trackers/abc123/blacklist"

レスポンスの一例

{
  "label": "Twitter installs",
   "token": "abc123",
   "name": "Twitter installs",
   "url": "https://app.adjust.com/abc123",
 "path": "",
   "has_subtrackers": true,
   "archived": false,
   "visible": true,
   "attribution_partner": false,
   "creative_token": null,
   "adgroup_token": null,
   "campaign_token": null,
   "network_token": "abc123",
   "click_url": "https://app.adjust.com/abc123",
 "impression_url": "https://view.adjust.com/impression/abc123",
 "allow_partner_linking": true,
   "settings": {
       "partner_id": null,
       "partner_display_name": null,
       "tracking_parameters": null,
       "cost_data_parameters": null,
       "cost_data": false,
       "partner_cost_data_parameters": null,
       "campaign_structure": null,
       "additional_parameters": null,
       "attribution_settings": null,
       "blacklisted": true
  },
   "urls": {
       "descendants": "/api/trackers/abc123/descendants.json",
   "ancestors": "/api/trackers/abc123/ancestors.json",
   "update": "/api/trackers/abc123.json",
   "show": "/api/trackers/abc123.json",
   "archive": "/api/trackers/abc123/archive.json",
   "unarchive": "/api/trackers/abc123/unarchive.json"
 }
}

ブラックリスト解除トラッカー

エンゲージメントの計測、アトリビューション、およびトラッカーと関連するサブトラッカーへのコールバックを更新するには、ブラックリストに登録されたトラッカーを解除するエンドポイントを使用します。

エンドポイント:

https://api.adjust.com/dashboard/api/trackers/{tracker}/unblacklist

要件

パラメーター定義
{tracker} 
必須
アルファベットと数字で構成されたAdjustトラッカートークン(少なくとも 6文字の長さ)

サンプルリクエスト(curlを使用)

curl -H "Authorization: Token token={api_token}" -X POST "https://api.adjust.com/dashboard/api/trackers/abc123/unblacklist"

レスポンスの例​ 

{
  "label": "Twitter installs",
  "token": "abc123",
  "name": "Twitter installs",
  "url": "https://app.adjust.com/abc123",
 "path": "",
  "has_subtrackers": true,
  "archived": false,
  "visible": true,
  "attribution_partner": false,
  "creative_token": null,
  "adgroup_token": null,
  "campaign_token": null,
  "network_token": "abc123",
  "click_url": "https://app.adjust.com/abc123",
 "impression_url": "https://view.adjust.com/impression/abc123","allow_partner_linking": true,
  "settings": {
    "partner_id": null,
    "partner_display_name": null,
    "tracking_parameters": null,
    "cost_data_parameters": null,
    "cost_data": false,
    "partner_cost_data_parameters": null,
    "campaign_structure": null,
    "additional_parameters": null,
    "attribution_settings": null,
    "blacklisted": false
  },
  "urls": {
    "descendants": "/api/trackers/abc123/descendants.json",
   "ancestors": "/api/trackers/abc123/ancestors.json",
   "update": "/api/trackers/abc123.json",
   "show": "/api/trackers/abc123.json",
   "archive": "/api/trackers/abc123/archive.json",
   "unarchive": "/api/trackers/abc123/unarchive.json"}
}