adjust-icon

キャンペーン API

キャンペーンAPIを使用して、リンク、サブリンクおよびパートナー情報の取得や、リンクの新規作成や、既存のリンクを新しいパートナー情報に更新することができます。

認証

キャンペーンAPIは認証にベアラートークンを使用します。キャンペーンAPIにリクエストを行う全てのリクエストには、Adjust APIトークンをAuthorizationヘッダーに含める必要があります。

自社でシングルサインオン(SSO)を有効にしている場合は、 Adjustの担当者またはsupport@adjust.comにお問い合わせください。APIトークンの取得方法についてサポートいたします。

SSO以外のアカウントの場合、APIガイドはユーザーの プロフィール に表示されます。トークンを確認するには、以下の手順に従ってください。

  1. アカウント(ユーザー)アイコンを選択します。
  2. アカウント設定(Account Settings) を選択します。
  3. マイプロフィール(My Profile) を選択します。
  4. APIトークンユーザー情報(User details) に表示されます。コピーボタンを選択して、トークンをクリップボードにコピーします。

Adjust APIトークンをリセットする

Adjust APIトークンはいつでもリセットできます。トークンをリセットすると、古いトークンは無効になります。Adjust APIトークンをリセットした場合、使用中の古いトークンを新しいトークンに置き換える必要があります。無効になったトークンを使用したリクエストは、Adjustによって拒否されます。

Adjust APIトークンをリセットする方法:

  1. アカウント(ユーザー)アイコンを選択します。
  2. アカウント設定(Account Settings) を選択します。
  3. マイプロフィール(My Profile) を選択します。
  4. APIトークンユーザー情報(User details) に表示されます。
  5. APIトークンをリセットする(Reset API token) を選択します。
  6. 表示されたモーダルにアカウントのパスワードを入力し、 リセット を選択してAPIトークンをリセットします。画面の右上に確認メッセージが表示されます。
  7. APIトークン の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。

パートナーを取得する

エンドポイント
GET https://api.adjust.com/public/v1/partners

このエンドポイントを使用して、パートナーの一覧と関連データを取得します。データはパートナーオブジェクトの配列で返されます。

パラメーター

次のパラメーターを クエリパラメーター としてパスすることができます。

afterString

リクエストを開始するカーソルの位置

beforeString

リクエストを終了するカーソルの位置

limitInteger

レスポンスに含む結果の最大数。この値は正の整数であることが必須です。デフォルトは50です。

ページネーション

このエンドポイントからの結果は、カーソルを使用してページ分割されています。各ページには、 previousnextページの位置が返されます。特定のページを返すために、これらをコールに含めることができます。

各結果のページには、カーソルの位置を含むpagingオブジェクトが含まれています。これらのカーソルを使って、プログラムでページ間を移動することができます。例えば、最初のページには次のようなpagingオブジェクトが含まれます。

ページネーションの例
"paging": {
"page_size": "50",
"collection_size": "49",
"total": "199",
"cursors": {
"after": "g2wAAAACYhW1_gxkAANuaWxq",
"before": null
},
"next": "https://api.adjust.com/public/v1/apps/yxs12pfewq/trackers?after=g2wAAAACYhW1_gxkAANuaWxq&limit=50",
"previous": null
}

2ページ目に移動するには、after値をafterパラメーター内の次のリクエストに追加します。例:

cURL
$ curl "https://api.adjust.com/public/v1/apps/yxs12pfewq/trackers?after=g2wAAAACYhW1_gxkAANuaWxq"

レスポンスの形式

{
"data": {
"api_version": "string",
"request_id": "string",
"timestamp": "datetime",
"paging": {
"page_size": "string",
"collection_size": "string",
"total": "string",
"next": "string",
"previous": "string",
"cursors": {
"after": "string",
"before": "string"
}
},
"items": [
{
"id": 100,
"display_name": "string",
"supports_cost_data": true
}
]
}
}

cURL
$ curl \
--header 'Authorization: Token token={API_TOKEN}' \
-L -X GET 'https://api.adjust.com/public/v1/partners?limit=1'
成功レスポンス
{
"data": {
"api_version": "1",
"request_id": "FcK55-tdJUDOWQIAABsB",
"timestamp": "2019-09-09T09:07:06Z",
"paging": {
"page_size": "1",
"collection_size": "1",
"total": "199",
"next": "https://api.adjust.com/public/v1/partners?after=g2wAAAACYhW1_gxkAANuaWxq&limit=1",
"previous": null,
"cursors": {
"after": "g2wAAAACYhW1_gxkAANuaWxq",
"before": null
}
},
"items": [
{
"id": 174,
"display_name": "Adcolony",
"supports_cost_data": true
}
]
}
}

このエンドポイントを使用して、アプリに関連するネットワークレベルのリンクを取得します。

全てのリンクは、以下の形式でアイテムとして返されます。

成功レスポンス
{
"name": "String",
"token": "String",
"label": "String",
"level": 1,
"archived": false,
"has_subtrackers": false,
"partner_id": 3,
"cost_data_enabled": false,
"url": "String",
"click_url": "String",
"impression_url": "String"
}

このエンドポイントを使用して、指定したアプリのサブリンクを取得します。

{
"name": "String",
"token": "String",
"label": "String",
"level": 2,
"archived": false,
"has_subtrackers": false,
"partner_id": null,
"cost_data_enabled": false,
"url": "String",
"click_url": "String",
"impression_url": "String"
}
エンドポイント
POST https://api.adjust.com/public/v1/apps/{app_token}/trackers

このエンドポイントを使用して、アプリに新規リンクまたはサブリンクを作成します。

リクエストの パス に、以下のパラメーターを含める必要があります。

app_tokenString

アプリを識別する英数字のトークン。12文字で設定してください。

リクエストの データ に以下のパラメーターをパスする必要があります。

nameString

新しいリンクの名前。

リクエストの データ に、以下のトークンをパスことができます。

parent_tokenString

サブリンクがネストされている 親リンク のリンクトークン。サブリンクを作成する場合にのみ必要です。

{
"name": "String",
"token": "String",
"label": "String",
"level": 1,
"archived": false,
"has_subtrackers": false,
"partner_id": 3,
"cost_data_enabled": false,
"url": "String",
"click_url": "String",
"impression_url": "String"
}

以下のlevel値が利用可能です:

  • 1: ネットワークレベル
  • 2: キャンペーンレベル
  • 3: アドグループレベル
  • 4: クリエイティブレベル

以下の例は、 リンクサブリンク の作成方法を示します。

cURL
$ curl --location --request POST 'https://api.adjust.com/public/v1/apps/gwzpeepw8uf8/trackers' \
--header 'Authorization: Token token={API_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{"name": "Adroll"}'
成功レスポンス
{
"data": {
"api_version": "1",
"request_id": "FcK55-tdJUDOWQIAABsB",
"timestamp": "2019-09-09T09:07:06Z",
"items": [
{
"name": "Adroll",
"token": "abc123",
"label": "Adroll",
"level": 1,
"archived": false,
"has_subtrackers": false,
"partner_id": 3,
"cost_data_enabled": false,
"url": "https://app.adjust.com/abc123",
"click_url": "https://app.adjust.com/abc123?campaign={campaign_name}&idfa={idfa}&deeplink=http%3A%2F%2Fa.b%2Fc%3Fd%3D1%26e%3D%%MACROS%%",
"impression_url": "https://s2s.adjust.com/impression/abc123?campaign={campaign_name}&idfa={idfa}&s2s=1"
}
]
}
}
cURL
$ curl --location --request POST 'https://api.adjust.com/public/v1/apps/gwzpeepw8uf8/trackers' \
--header 'Authorization: Token token={API_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{"parent_token": "abc123", "name": "SpringCampaign"}'
成功レスポンス
{
"data": {
"api_version": "1",
"request_id": "FcK55-tdJUDOWQIAABsB",
"timestamp": "2019-09-09T09:07:06Z",
"items": [
{
"name": "Adroll::SpringCampaign",
"token": "xyz456",
"label": "SpringCampaign",
"level": 2,
"archived": false,
"has_subtrackers": false,
"partner_id": 3,
"cost_data_enabled": false,
"url": "https://app.adjust.com/xyz456",
"click_url": "https://app.adjust.com/xyz456?campaign={campaign_name}&idfa={idfa}&deeplink=http%3A%2F%2Fa.b%2Fc%3Fd%3D1%26e%3D%%MACROS%%",
"impression_url": "https://s2s.adjust.com/impression/xyz456?campaign={campaign_name}&idfa={idfa}&s2s=1"
}
]
}
}
エンドポイント
PATCH https://api.adjust.com/public/v1/apps/{app_token}/trackers/{link_token}

このエンドポイントを使用して、アプリの既存のリンクまたはサブリンクを更新します。リンクに新規パートナーを追加したり、コストデータを有効にするかどうかを管理することができます。

リクエストの パス に、以下のパラメーターをパスする必要があります。

app_tokenString

アプリを識別する英数字のトークン。12文字で設定してください。

tracker_tokenString

更新したいリンクのトークン。

リクエストの データ に、以下のパラメーターをパスすることができます

partner_idInteger

リンクに付与したいパートナーのID。パートナーとパートナーIDの一覧を取得するには、上記のパートナーを取得するを参照してください。

cost_data_enabledBoolean

リンクに対し、広告費用データを有効化するかどうか。

レスポンスパラメーター

{
"name": "String",
"token": "String",
"label": "String",
"level": 1,
"archived": false,
"has_subtrackers": false,
"partner_id": 3,
"cost_data_enabled": false,
"url": "String",
"click_url": "String",
"impression_url": "String"
}

以下のlevel値が利用可能です:

  • 1: ネットワークレベル
  • 2: キャンペーンレベル
  • 3: アドグループレベル
  • 4: クリエイティブレベル
cURL
$ curl \
--header 'Authorization: Token token={API_TOKEN}' \
--header 'Content-Type: application/json' \
--location --request PATCH 'https://api.adjust.com/public/v1/apps/gwzpeepw8uf8/trackers/klm789' \
--data-raw '{"partner_id": 174, "cost_data_enabled": false}'
成功レスポンス
{
"data": {
"api_version": "1",
"request_id": "FcK55-tdJUDOWQIAABsB",
"timestamp": "2019-09-09T09:07:06Z",
"items": [
{
"name": "Adcolony",
"token": "klm789",
"label": "Adcolony",
"level": 1,
"archived": false,
"has_subtrackers": false,
"partner_id": 174,
"cost_data_enabled": true,
"url": "https://app.adjust.com/klm789",
"impression_url": "https://s2s.adjust.com/impression/klm789?s2s=1&idfa=[IDFA]&gps_adid=[GOOGLE_AD_ID]&ip_address= [IP_ADDRESS]&adcolony_click_id=[CLICK_ID]&android_id_upper_sha1=[SHA1_ANDROID_ID]&cost_id=[CLICK_ID]&cost_type=[BID_TYPE]&cost_amount=[BID]&cost_currency=USD",
"click_url": "https://s2s.app.adjust.com/klm789?s2s=1&idfa=[IDFA]&gps_adid=[GOOGLE_AD_ID]&ip_address=[IP_ADDRESS]&adcolony_click_id=[CLICK_ID]&android_id_upper_sha1=[SHA1_ANDROID_ID]&cost_id=[CLICK_ID]&cost_type=[BID_TYPE]&cost_amount=[BID]&cost_currency=USD"
}
]
}
}