🔥月額$200でTenjinにフルアクセス - 全機能、アドオンなし、いつでもキャンセル可能。 価格と機能を見る

サインアップ
カテゴリーを見る

サイトID最適化 (SIO) API

5 min read

SIO APIを使用すると、特定のサイトIDにインストールが紐付けられるのをブロックできるようになりました。サイトID は、アプリ、チャネル、またはキャンペーンのレベルでブロックできます。

サイトIDがブロックされた場合、Tenjinはデータベースに広告エンゲージメント(クリック数とインプレッション数)を記録しませんが、エンドユーザーには引き続き広告が表示されます。

注意点:

  • Tenjinは現時点では広告ネットワークに対して拒否コールバックを送信していません。
  • Tenjinは、ブロックされた広告エンゲージメント(クリック数とインプレッション数)についてはレポートしません。
  • この機能は、社内で不正分析を実施している組織、またはキャンペーンの最適化を目指している組織向けに設計されています。
  • Tenjinはガイダンスを提供できますが、サイトIDをアトリビューション表示から除外するかどうかの決定は、完全にあなたの裁量に委ねられています。
  • 不正行為の疑いがある事案に対処する際には、パートナー企業の担当者にも連絡を取ることをお勧めします。

APIにアクセスするには、 

  • TenjinダッシュボードからAPIアクセストークン(WT Bearer Token)を取得する必要があります。まだ作成していない場合は、新規に作成してください。RMAおよびCMA APIエンドポイントにアクセスするには、APIアクセストークンも必要です。この機能にアクセスできない場合は、support@tenjin.comまでメールでお問い合わせください。
  • サイトIDを以下ツールより取得します:
    • DataVault
    • S2Sコールバック
    • Dashboard group by -> Site ID
  • オプションとして、これらのレベルのいずれか、または複数の組み合わせでサイトIDをブロックするために、campaignId、appId、またはadNetworkShortIdが必要になる場合があります。これらのIDは以下から取得できます。
    • DataVault
    • S2Sコールバック
    • campaignIdとappIdは、Tenjin管理画面からアクセスできます。
    • SAN以外の広告ネットワークのショートIDは、トラッキングリンク内のネットワーク名を確認することで特定できます。URLのその部分がショートIDを表しています。
      • 例: ironSourceの場合、ショートIDはsupersonicで、トラッキングリンクに以下のように表示されます。

        https://track.tenjin.io/v0/supersonic/bFpF2uljcAyfPCzwUJ0tuZ?…

    • adNetworkShortId に関するサポートがまだ必要な場合は、support@tenjin.com までお問い合わせください。
  • ご質問がある場合は、support@tenjin.comまでお問い合わせください。

APIの使用方法 #

リクエストパラメータ #

全リクエストで必須:

  • Host: connect.tenjin.com
  • Method: POST
  • Content-Type: application/json
  • Authorization: Tenjin管理画面で生成されたJWT Bearer Token

フィルタリストの取得 #

JavaScript
curl -X POST \
  -d '{}' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-jwt-token-from-tenjin-dash" \
https://connect.tenjin.com/management.v1.SiteIDFilter/Get

結果

JavaScript
{
  "version": 0
}





リストは空で、初期化されていません。





サイトIDのブロック #





JavaScript
curl -X POST \
  -d '{"rules":[{"siteId":"globally blocked Site ID"}]}' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-jwt-token-from-tenjin-dash" \
https://connect.tenjin.com/management.v1.SiteIDFilter/Block





キールールは、以下の条件を満たすオブジェクトの配列でなければなりません。





    

  • siteId, 必須
    • 




  • adNetworkShortId, オプション
    • 




  • appId, オプション, uuid
    • 




  • campaignId, オプション, uuid
    • 






キークリアはオプション機能で、trueに設定すると、以前のルールをすべてクリアし、新しいルールを一度にブロックします。





結果





JavaScript
{
  "version": 1
}





フィルタルールの変更によりバージョンがインクリメントされました。もう一度Getを呼び出してみましょう。





結果





JavaScript
{
  "version": 1,
  "rules": [
    {
      "siteId": "globally blocked Site ID",
      "createTime": "2026-01-28T09:53:07.740904Z"
    }
  ]
}





別のサイトIDをブロックする(ただし、対象は単一のアプリのみ):





JavaScript
curl -X POST \
  -d '{"rules":[{"siteId":"Site ID blocked for app", "appId":"your-tenjin-app-id"}]}' 
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-jwt-token-from-tenjin-dash" \
https://connect.tenjin.com/management.v1.SiteIDFilter/Block





結果





JavaScript
{
  "version": 2
}





もう一度Getをコールします：





結果





JavaScript
{
  "version": 2,
  "rules": [
    {
      "siteId": "globally blocked Site ID",
      "createTime": "2026-01-28T09:53:07.740904Z"
    },
    {
      "appId": "your-tenjin-app-id",
      "siteId": "Site ID blocked for app",
      "createTime": "2026-01-28T09:53:07.740904Z"
    }
  ]
}





サイトIDの復元 #





フィルタリストからサイトIDを再度削除できます。





JavaScript
curl -X POST \
  -d '{"siteIds":["Site ID blocked for app"]}' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-jwt-token-from-tenjin-dash" \
https://connect.tenjin.com/management.v1.SiteIDFilter/Reinstate





JavaScript
{
  "version": 3
}





もう一度Getをコールします：





結果





JavaScript
{
  "version": 3,
  "rules": [
    {
      "siteId": "globally blocked siteid",
      "createTime": "2026-01-28T09:53:07.740904Z"
    }
  ]
}





サイトIDを全てクリア #





すべてのフィルタルールを削除するには：





JavaScript
curl -X POST \
  -d '{}' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-jwt-token-from-tenjin-dash" \
https://connect.tenjin.com/management.v1.SiteIDFilter/Clear





もう一度Getをコールします：





結果





JavaScript
{
  "version": 4
}










	

	
あなたの気持ちは？