POST /api/v2/server-side-api/integration/profile/set/integration-identifiers/

设置集成标识符

Copy as Markdown

向用户画像添加集成标识符。

Header parameters

adapty-customer-user-idstring

您系统中客户的唯一 ID。adapty-customer-user-id 或 adapty-profile-id 二选一必填。

adapty-profile-idstring · uuid

您系统中用户画像的唯一 ID。如果您正在处理匿名用户画像，这是最佳选择。adapty-customer-user-id 或 adapty-profile-id 二选一必填。

Request body

至少必须提供一个集成标识符

adjust_device_idstring

用户在 Adjust 集成中的网络用户 ID

airbridge_device_idstring

用户设备在 Airbridge 集成中的 ID

amplitude_device_idstring

用户设备在 Amplitude 集成中的 ID

amplitude_user_idstring

用户在 Amplitude 集成中的 ID

appmetrica_device_idstring

用户设备在 AppMetrica 集成中的 ID

appmetrica_profile_idstring

用户在 AppMetrica 集成中的 ID

appsflyer_idstring

用户在 AppsFlyer 集成中的网络用户 ID

branch_idstring

用户应用在 Branch 集成中的 Branch Key

facebook_anonymous_idstring

用户在 Facebook Ads 集成中的 ID

firebase_app_instance_idstring

用户在 Firebase 集成中的 ID

mixpanel_user_idstring

用户在 Mixpanel 集成中的 ID

one_signal_player_idstring

用户在 OneSignal 集成中的 ID（旧版标识符）

one_signal_subscription_idstring

用户在 OneSignal 集成中的 ID（推荐标识符）

posthog_distinct_user_idstring

用户在 PostHog 集成中的 ID

pushwoosh_hwidstring

用户设备在 Pushwoosh 集成中的 ID

tenjin_analytics_installation_idstring

用户设备在 Tenjin 集成中的 ID

Responses

集成标识符设置成功。响应体为空。

请求错误

Schema

errorsarray of objectrequired

sourcestring

错误来源

errorsarray of string

错误消息数组

error_codestringrequired

简短错误名称

status_codeintegerrequired

HTTP 状态码

Example

{
  "errors": [
    "At least one integration identifier must be provided."
  ],
  "error_code": "validation_error",
  "status_code": 400
}

未授权

Schema

errorsarray of objectrequired

sourcestring

错误来源

errorsarray of string

错误消息数组

error_codestringrequired

简短错误名称

status_codeintegerrequired

HTTP 状态码

Example

{
  "errors": [
    "Invalid API key"
  ],
  "error_code": "unauthorized",
  "status_code": 401
}

用户画像未找到

Schema

errorsarray of objectrequired

sourcestring

错误来源

errorsarray of string

错误消息数组

error_codestringrequired

简短错误名称

status_codeintegerrequired

HTTP 状态码

Example

{
  "errors": [
    "Profile not found"
  ],
  "error_code": "profile_not_found",
  "status_code": 404
}

服务器内部错误

Schema

errorsarray of objectrequired

sourcestring

错误来源

errorsarray of string

错误消息数组

error_codestringrequired

简短错误名称

status_codeintegerrequired

HTTP 状态码

Try it

Authorization

Header parameters

adapty-customer-user-id

adapty-profile-id

Body

curl --request POST \
  --url 'https://api.adapty.io/api/v2/server-side-api/integration/profile/set/integration-identifiers/' \
  --header 'Authorization: Api-Key YOUR_SECRET_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "pushwoosh_hwid": "example_pushwoosh_hwid",
    "mixpanel_user_id": "example_mixpanel_user_id",
    "facebook_anonymous_id": "example_facebook_anonymous_id",
    "firebase_app_instance_id": "example_firebase_app_instance_id",
    "amplitude_user_id": "example_amplitude_user_id",
    "amplitude_device_id": "example_amplitude_device_id",
    "appmetrica_device_id": "example_appmetrica_device_id",
    "appmetrica_profile_id": "example_appmetrica_profile_id",
    "one_signal_subscription_id": "example_one_signal_subscription_id",
    "one_signal_player_id": "example_one_signal_player_id",
    "branch_id": "example_branch_id",
    "appsflyer_id": "example_appsflyer_id",
    "adjust_device_id": "example_adjust_device_id",
    "airbridge_device_id": "example_airbridge_device_id",
    "tenjin_analytics_installation_id": "example_tenjin_analytics_installation_id",
    "posthog_distinct_user_id": "example_posthog_distinct_user_id"
  }'

const response = await fetch('https://api.adapty.io/api/v2/server-side-api/integration/profile/set/integration-identifiers/', {
  method: 'POST',
  headers: {
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "pushwoosh_hwid": "example_pushwoosh_hwid",
    "mixpanel_user_id": "example_mixpanel_user_id",
    "facebook_anonymous_id": "example_facebook_anonymous_id",
    "firebase_app_instance_id": "example_firebase_app_instance_id",
    "amplitude_user_id": "example_amplitude_user_id",
    "amplitude_device_id": "example_amplitude_device_id",
    "appmetrica_device_id": "example_appmetrica_device_id",
    "appmetrica_profile_id": "example_appmetrica_profile_id",
    "one_signal_subscription_id": "example_one_signal_subscription_id",
    "one_signal_player_id": "example_one_signal_player_id",
    "branch_id": "example_branch_id",
    "appsflyer_id": "example_appsflyer_id",
    "adjust_device_id": "example_adjust_device_id",
    "airbridge_device_id": "example_airbridge_device_id",
    "tenjin_analytics_installation_id": "example_tenjin_analytics_installation_id",
    "posthog_distinct_user_id": "example_posthog_distinct_user_id"
  }),
});
const data = await response.json();

import requests

response = requests.post('https://api.adapty.io/api/v2/server-side-api/integration/profile/set/integration-identifiers/', headers={
    'Authorization': 'Api-Key YOUR_SECRET_API_KEY',
    'Content-Type': 'application/json',
}, json={
      "pushwoosh_hwid": "example_pushwoosh_hwid",
      "mixpanel_user_id": "example_mixpanel_user_id",
      "facebook_anonymous_id": "example_facebook_anonymous_id",
      "firebase_app_instance_id": "example_firebase_app_instance_id",
      "amplitude_user_id": "example_amplitude_user_id",
      "amplitude_device_id": "example_amplitude_device_id",
      "appmetrica_device_id": "example_appmetrica_device_id",
      "appmetrica_profile_id": "example_appmetrica_profile_id",
      "one_signal_subscription_id": "example_one_signal_subscription_id",
      "one_signal_player_id": "example_one_signal_player_id",
      "branch_id": "example_branch_id",
      "appsflyer_id": "example_appsflyer_id",
      "adjust_device_id": "example_adjust_device_id",
      "airbridge_device_id": "example_airbridge_device_id",
      "tenjin_analytics_installation_id": "example_tenjin_analytics_installation_id",
      "posthog_distinct_user_id": "example_posthog_distinct_user_id"
    })
data = response.json()