チャネル設定

一部のアドネットワークパートナーと連携するには、追加設定が必要です。アプリの作成または更新時にchannel_setupパラメーターを使用して、パートナー固有の値を設定できます。

チャネル設定の仕組み

/app エンドポイントを使用してアプリを作成または更新すると、APIはテンプレートアプリからパートナー設定をコピーします。ただし、特定のパートナと連携する場合、アプリIDやAPIキーなど、アプリごとに異なる固有の値が必要になります。

ワークフロー

POST /appエンドポイントを使用してアプリを作成します。
パートナー固有のIDを入手したら、channel_setupパラメーターを使用して再度リクエストを送信します。
APIは以前のリクエストの値をマージしないため、各リクエストに すべて のチャネル設定値を含めてください。

サポート対象のパートナー

以下のパートナーにはチャネル設定が必要です。

パートナー	必要なパラメータ	説明
`applovin`	`sdk_keys`	アプリのAppLovin SDKキーの配列。
`chartboost`	`app_id`、 `token`	ChartboostのアプリIDとアプリのシグネチャー。
`facebook`	`app_id`	FacebookのアプリID。オプションで`adimpression_forwarding`を含めると、広告インプレッションを転送できるようになります。
`gameanalytics`	`key`	GameAnalyticsの一意のゲームキー
`google`	`link_id`	Google 広告のリンクID
`inmobi`	`property_id`、 `advertiser_id`	InMobiのプロパティIDと広告主ID。
`ironsource`	`advertiser_id`、 `password`	ironSourceの広告主IDとパスワード。
`mintegral`	`enabled`	Mintegralとの連携を有効にするには、`true`に設定。
`snapchat`	`snap_app_id`	SnapchatのアプリID。
`tapjoy`	`app_id`	TapjoyのアプリID。
`tiktok`	`app_id`、 `enabled`	TikTokのアプリIDおよび連携の有効化。
`unityads`	`game_id`	Unity AdsのゲームID。
`vungle`	`app_id`	VungleのアプリID。

パラメーター

すべてのパラメーターは、channel_setupオブジェクト内でキーと値のペアとして渡されます。

AppLovin

パラメーター	データタイプ	必須	説明
`sdk_keys`	`Array[String]`	はい	アプリ用のAppLovin SDKキーのリスト。

Chartboost

パラメーター	データタイプ	必須	説明
`app_id`	`String`	はい	ChartboostアプリのID。
`token`	`String`	はい	Chartboostアプリのシグネチャー。

Facebook

パラメーター	データタイプ	必須	説明
`app_id`	`String`	はい	FacebookのアプリID。
`adimpression_forwarding`	`Boolean`	いいえ	広告インプレッション転送を有効化。デフォルトは`false`です。

GameAnalytics

パラメーター	データタイプ	必須	説明
`key`	`String`	はい	GameAnalyticsの一意のゲームキー

Google

パラメーター	データタイプ	必須	説明
`link_id`	`String`	はい	Google 広告のリンクID

InMobi

パラメーター	データタイプ	必須	説明
`property_id`	`String`	はい	InMobiのプロパティID（GMP ID）。
`advertiser_id`	`String`	はい	InMobiの広告主ID。

ironSource

パラメーター	データタイプ	必須	説明
`advertiser_id`	`String`	はい	ironSourceの広告主ID。
`password`	`String`	はい	ironSourceのパスワード。

Mintegral

パラメーター	データタイプ	必須	説明
`enabled`	`Boolean`	はい	Mintegralとの連携を有効にするには、`true`に設定。

Snapchat

パラメーター	データタイプ	必須	説明
`snap_app_id`	`String`	はい	SnapchatのアプリID。

Tapjoy

パラメーター	データタイプ	必須	説明
`app_id`	`String`	はい	TapjoyのアプリID。

TikTok

パラメーター	データタイプ	必須	説明
`app_id`	`String`	はい	TikTokのアプリID。
`enabled`	`Boolean`	いいえ	連携が有効かどうか。デフォルトは`true`です。

Unity Ads

パラメーター	データタイプ	必須	説明
`game_id`	`String`	はい	Unity AdsのゲームID。

Vungle

パラメーター	データタイプ	必須	説明
`app_id`	`String`	はい	VungleのアプリID。

例

完全なチャネル設定の例

この例では、リクエストに複数のパートナーのチャネル設定が含まれています。

curl --location 'https://automate.adjust.com/app-automation/app' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "My App",
    "bundle_id": "com.example.myapp",
    "store_id": "com.example.myapp",
    "platform": "android",
    "channel_setup": {
        "applovin": {
            "sdk_keys": ["sdk_key_1", "sdk_key_2"]
        },
        "chartboost": {
            "app_id": "chartboost_app_id",
            "token": "app_signature"
        },
        "facebook": {
            "app_id": "123456789",
            "adimpression_forwarding": true
        },
        "gameanalytics": {
            "key": "unique_game_key"
        },
        "google": {
            "link_id": "adwords_link_id"
        },
        "inmobi": {
            "property_id": "inmobi_property_id",
            "advertiser_id": "advertiser_id"
        },
        "ironsource": {
            "advertiser_id": "6734",
            "password": "abc123"
        },
        "mintegral": {
            "enabled": true
        },
        "snapchat": {
            "snap_app_id": "snapchat_app_id"
        },
        "tapjoy": {
            "app_id": "tapjoy_app_id"
        },
        "tiktok": {
            "app_id": "5464534",
            "enabled": true
        },
        "unityads": {
            "game_id": "unity_game_id"
        },
        "vungle": {
            "app_id": "vungle_app_id"
        }
    }
}'

単一パートナーの設定

1つのパートナーのみを設定します。

curl --location 'https://automate.adjust.com/app-automation/app' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "My App",
    "bundle_id": "com.example.myapp",
    "store_id": "com.example.myapp",
    "platform": "android",
    "channel_setup": {
        "facebook": {
            "app_id": "987654321"
        }
    }
}'

既存アプリのチャネル設定を更新

force_updateを使用して新しいリクエストを送信し、既存のアプリにチャネル設定を追加します。

curl --location 'https://automate.adjust.com/app-automation/app' \
--header 'Authorization: Bearer {your-adjust-api-token}' \
--header 'Content-Type: application/json' \
--data '{
    "name": "My App",
    "bundle_id": "com.example.myapp",
    "store_id": "com.example.myapp",
    "platform": "android",
    "force_update": true,
    "channel_setup": {
        "google": {
            "link_id": "new_google_link_id"
        },
        "facebook": {
            "app_id": "updated_facebook_id"
        }
    }
}'

チャネル設定を表示する

アプリの現在のチャネル設定を確認するには、GET /app/{app_token}エンドポイントを使用します。レスポンスには、設定された値を含むchannel_setupオブジェクトが含まれます。

{
   "name": "My App",
   "store_id": "com.example.myapp",
   "platform": "android",
   "adjust_app_token": "abc123xyz",
   "channel_setup": {
      "facebook": { "app_id": "123456789" },
      "google": { "link_id": "adwords_link_id" },
      "snapchat": { "snap_app_id": "snapchat_app_id" }
   }
}