diff --git a/src/content/docs/ja/api/ad-spend-api.mdx b/src/content/docs/ja/api/ad-spend-api.mdx index 83aa1d5fa..d799989c1 100644 --- a/src/content/docs/ja/api/ad-spend-api.mdx +++ b/src/content/docs/ja/api/ad-spend-api.mdx @@ -8,7 +8,7 @@ sidebar-position: 2 パートナー広告費用APIを使用して、キャンペーンに関連する広告費用情報をAdjustに送信します。Adjustは、エンゲージメントの発生から **最大7日間** の間、広告費用データを受信します。 -## コストIDを設定する {#cost-id} +## コストIDを設定する \{\#cost\-id\} **コストID** @@ -24,7 +24,7 @@ sidebar-position: 2 CPM（1000回表示あたりの広告費用）データをAdjustに送信するには、パートナー広告費用APIコールで送信する`cost_id`と同じ値を持つ`cost_id`をインプレッションURLに追加してください。CPMを計測する際は、インプレッション **ごと** にCPMを送信する必要があります。 -## 広告費用データを送信する {#send-ad-spend-data} +## 広告費用データを送信する \{\#send\-ad\-spend\-data\} @@ -34,7 +34,7 @@ POST https://app.adjust.com/cost -Adjustに広告費用情報を送信するには、 `/cost`エンドポイントにPOSTリクエストを送信します。 +Adjustに広告費用情報を送信するには、`/cost`エンドポイントにPOSTリクエストを送信します。 ### パラメーター {#parameters} @@ -48,6 +48,8 @@ Adjustに広告費用情報を送信するには、 `/cost`エンドポイント : 広告費用情報の通貨コード。[ISO 4217](https://www.iban.com/currency-codes)の通貨コードでフォーマットされなければなりません。Adjustがサポートしている[全ての通貨のリスト](https://help.adjust.com/ja/article/supported-currencies)をご覧ください。 +`cost_amount` \( `Float`\)：コスト値。この値は、小数点以下5桁までです。 + `cost_id` （`String`） : 一意のコストID。詳細については、[上記のコストIDのセクション](#cost-id)を参照してください。 @@ -67,7 +69,7 @@ $ curl -X POST https://app.adjust.com/cost \ -## レスポンス {#responses} +## レスポンス \{\#responses\} `200 Success` @@ -85,7 +87,7 @@ $ curl -X POST https://app.adjust.com/cost \ : 指定された認証情報には、送信された情報を投稿する権限がありません。問題を解決するには、[wizards@adjust.com](mailto:wizards@adjust.com)にお問い合わせください。 -## 連携をテストする {#test-your-integration} +## 連携をテストする \{\#test\-your\-integration\} 必要なパラメーターを送信するようサーバーを設定したら、[wizards@adjust.com](mailto:wizards@adjust.com)までご連絡ください。Adjustでは、お客様に一連のテストを提供しています。連携を有効化する前に、異なるコストタイプに乖離が生じていないか、他に問題がないかどうかを確認できます。Adjustはまた、API連携が期待通りに機能していることを確認するため、Adjust APIのテストも実施しています。 diff --git a/src/content/docs/ko/api/ad-spend-api.mdx b/src/content/docs/ko/api/ad-spend-api.mdx index 16f9eb06a..741f3e559 100644 --- a/src/content/docs/ko/api/ad-spend-api.mdx +++ b/src/content/docs/ko/api/ad-spend-api.mdx @@ -8,7 +8,7 @@ sidebar-position: 2 파트너 광고 비용 API를 사용하면 캠페인과 관련된 광고 비용 정보를 Adjust에 전송할 수 있습니다. Adjust는 인게이지먼트 발생 이후 **최대 7일** 까지의 인게이지먼트 데이터를 허용합니다. -## 비용 ID 설정 {#cost-id} +## 비용 ID 설정 \{\#cost\-id\} **비용 ID** @@ -24,7 +24,7 @@ sidebar-position: 2 CPM \(1000회당 비용\) 데이터를 Adjust로 전송하려면 노출 URL에 파트너 광고 API 콜에서 전송하는 `cost_id` 와 동일한 값으로 `cost_id` 를 추가하시기 바랍니다. CPM을 측정할 때는 **각** 노출과 함께 CPM을 전송해야 합니다\(MUST\). -## 광고 비용 데이터 전송 {#send-ad-spend-data} +## 광고 비용 데이터 전송 \{\#send\-ad\-spend\-data\} @@ -34,7 +34,7 @@ POST https://app.adjust.com/cost -POST 요청을 `/cost` 엔드포인트로 전송하여 Adjust에 광고 비용 정보를 전송합니다. +Adjust에 광고 비용 정보를 보내려면 `/cost` 엔드포인트에 POST 요청을 전송합니다. ### 파라미터 {#parameters} @@ -48,6 +48,9 @@ POST 요청을 `/cost` 엔드포인트로 전송하여 Adjust에 광고 비용 : 광고 비용의 통화 코드. [ISO 4217](https://www.iban.com/currency-codes) 통화 코드 형식이어야 합니다. [지원되는 통화 목록](https://help.adjust.com/ko/article/supported-currencies)을 참조하시기 바랍니다. +`cost_amount` \(`Float`\) +: 비용 값. 최대 소수점 5자리. + `cost_id` \(`String`\) : 고유한 비용 ID. 자세한 정보는 [위의 비용 ID 섹션](#cost-id)을 참조하시기 바랍니다. @@ -56,7 +59,7 @@ POST 요청을 `/cost` 엔드포인트로 전송하여 Adjust에 광고 비용 : 로그와 디버그에 사용한 레이블. 이 값은 최대 128자여야 합니다. -### 예: {#example} +### 예 {#example} @@ -67,15 +70,15 @@ $ curl -X POST https://app.adjust.com/cost \ -## 응답 {#responses} +## 응답 \{\#responses\} `200 Success` -: 광고 비용 정보가 Adjust에 제출되었습니다. +: 광고 비용 정보가 Adjust에 전송되었습니다. `400 Bad request` -: 요청 형식이 올바르지 않습니다. [모든 필수 파라미터](#parameters) 를 포함하시기 바랍니다. +: 요청의 형식이 적절하지 않습니다. [모든 필수 파라미터](#parameters)가 포함되었는지 확인하시기 바랍니다. `401 Unauthorized` @@ -85,8 +88,8 @@ $ curl -X POST https://app.adjust.com/cost \ : 입력하신 인증 정보는 전송한 정보를 게시할 수 있는 권한이 없습니다. 문제 해결을 위해 [Wizards@adjust.com](mailto:wizards@adjust.com)으로 연락주시기 바랍니다. -## 연동 테스트 {#test-your-integration} +## 연동 테스트 \{\#test\-your\-integration\} -필수 파라미터를 보낼 수 있도록 서버 구성이 완료되면 [wizards@adjust.com](mailto:wizards@adjust.com)으로 연락하시기 바랍니다. Adjust는 여러 차례의 테스트를 제공합니다. 이를 통해 연동이 라이브되기 전에 각각의 광고 비용 유형 내 불일치를 확인하고, 문제를 해결할 수 있습니다. Adjust는 또한 Adjust API 테스트를 통해 API 연동이 올바르게 작동하는지 확인합니다. +필수 파라미터를 보낼 수 있도록 서버 구성이 완료되면 [wizards@adjust.com](mailto:wizards@adjust.com)으로 연락하시기 바랍니다. Adjust는 여러 차례의 테스트를 제공하여, 연동을 라이브로 설정하기에 앞서 여러 광고 비용 유형 간의 데이터 불일치를 확인하고 문제를 해결할 수 있습니다. Adjust는 또한 Adjust API 테스트를 통해 API 연동이 올바르게 작동하는지 확인합니다. -테스트가 완료되면 Adjust는 [연동된 광고 비용 파트너 목록에](https://help.adjust.com/ko/article/ad-spend-api-integrations#supported-partners) 사용자를 추가합니다. +테스트가 완료되면 Adjust의 연동 광고 비용 파트너 목록에 파트너로 추가됩니다. diff --git a/src/content/docs/zh/api/ad-spend-api.mdx b/src/content/docs/zh/api/ad-spend-api.mdx index a09139b6e..25fdaf06d 100644 --- a/src/content/docs/zh/api/ad-spend-api.mdx +++ b/src/content/docs/zh/api/ad-spend-api.mdx @@ -8,7 +8,7 @@ sidebar-position: 2 使用合作伙伴广告支出 API，向 Adjust 发送与推广活动相关的广告支出信息。Adjust 可接受交互发生后 **最多 7 天** 的广告支出数据。 -## 设置成本 ID{#cost-id} +## 设置成本 ID\{\#cost\-id\} **成本 ID** @@ -24,7 +24,7 @@ sidebar-position: 2 要向 Adjust 发送 CPM \(每千次展示成本\) 数据，请向您的展示 URL 添加 `cost_id` 参数，其值需要与合作伙伴广告支出 API 调用中发送的 `cost_id` 相同。在监测 CPM 时，您必须随 **每次** 展示发送 CPM。 -## 发送广告支出数据{#send-ad-spend-data} +## 发送广告支出数据\{\#send\-ad\-spend\-data\} @@ -48,6 +48,9 @@ POST https://app.adjust.com/cost : 广告支出信息的货币代码。必须采用 [ISO 4217](https://www.iban.com/currency-codes) 货币代码格式。请参阅我们[支持币种的完整清单](https://help.adjust.com/zh/article/supported-currencies)。 +`cost_amount` \(`Float`\) +: 成本值。此值最多可以保留到小数点后五位。 + `cost_id` \(`String`\) : 您的唯一成本 ID。请参阅[上文的成本 ID 部分](#cost-id)，了解更多信息。 @@ -67,7 +70,7 @@ $ curl -X POST https://app.adjust.com/cost \ -## 响应{#responses} +## 响应\{\#responses\} `200 Success` @@ -85,7 +88,7 @@ $ curl -X POST https://app.adjust.com/cost \ : 您提供的凭证权限不足，无法发布您发送的信息。请发送邮件至 [wizards@adjust.com](mailto:wizards@adjust.com)，进行故障排查。 -## 测试集成{#test-your-integration} +## 测试集成\{\#test\-your\-integration\} 完成服务器配置，可发送所需的参数后，请联系 [wizards@adjust.com](mailto:wizards@adjust.com)，Adjust 会为您提供一系列测试。您可以检查不同广告支出类型中的差异，在集成上线之前发现并解决任何问题。我们还会针对 Adjust API 进行测试，确保 API 集成顺利进行并能正常运作。