ブラックリストトラッカーAPI
AdjustのブラックリストトラッカーAPIは、不正あるいは期限切れのトラッカーからトラフィックを守るために利用できます。

ビジネスプロ以上のパッケージをご契約のお客様は、すべてのAdjust APIを使用できます。

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

トラッカーがブラックリストに登録されていると、Adjustはそのトラッカーに対してエンゲージメント(クリックやインプレッション)をアトリビュートしません。トラッカーがブラックリスト化されると、そのトラッカーに紐付けられた既存のアトリビューションに影響します。つまり、ユーザーのアプリ内セッションおよびイベントは、他の有効なトラッカーにリアトリビューションされるまで、引き続きブラックリストに登録されたトラッカーURLに関連付けられることになります。また、トラッカーがブラックリストに登録される前に記録されたクリックやインプレッションは、引き続きアトリビューション期間内のコンバージョンの対象となりますので、ご注意ください。

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

キャンペーンウィザードでブラックリストに登録されたトラッカー横にある設定(歯車)アイコンを選択すると、トラッカーがBLACKLISTEDと表示されます。ブラックリストに登録されたトラッカーのEDIT(編集)を選択した場合に利用可能なオプションは、トラッカーのアーカイブのみです。トラッカーをアーカイブすると、アクティブトラッカーのリストに表示されなくなります。ブラックリストに登録されたトラッカーは、いつでもアーカイブまたはアーカイブの解除をすることができます。

また、AdjustのブラックリストトラッカーAPIを使用して、トラッカーのブラックリストの登録を解除することもできます。トラッカーのブラックリスト登録が解除されると、Adjustはそのトラッカーからのエンゲージメントの計測を再開し、Adjustキャンペーンウィザードでのトラッカー設定の編集が可能になります。トラッカーのブラックリスト登録解除は即時有効になりますが、アトリビューションデータに遡って適用されることはありません。ブラックリスト登録解除後に実行されたトラッカーのエンゲージメントのみが、アトリビューションファネルの範囲内と見なされます。

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

エンドポイント
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"}
}

このトピックについて