-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
2cfee15
commit 91b2ddd
Showing
3 changed files
with
64 additions
and
76 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,16 @@ | ||
--- | ||
title: "パートナー広告費用 Push API" | ||
description: "パートナー広告費用APIを使用して、キャンペーンに関連する広告費用情報をAdjustに送信します。" | ||
category-title: "パートナー広告費用API" | ||
slug: "en/api/ad-spend-api" | ||
title: パートナー広告費用 Push API | ||
description: パートナー広告費用APIを使用して、キャンペーンに関連する広告費用情報をAdjustに送信します。 | ||
category-title: パートナー広告費用API | ||
slug: ja/api/ad-spend-api | ||
sidebar-position: 2 | ||
--- | ||
|
||
パートナー広告費用APIを使用して、キャンペーンに関連する広告費用情報をAdjustに送信します。Adjustは、エンゲージメントの発生から **最大7日間** の間、広告費用データを受信します。 | ||
|
||
コストIDを設定する \{\#cost\-id\} | ||
----------------------------- | ||
## コストIDを設定する \{\#cost\-id\} | ||
|
||
**コストID** | ||
**コストID** | ||
|
||
: **12〜256字** の長さの一意のコストエンゲージメント識別子の値。 | ||
|
||
|
@@ -20,24 +20,23 @@ sidebar-position: 2 | |
|
||
既存の`click_id`または`impression_id`を使用できます。クリックIDやインプレッションIDを作成しない場合は、2つ以上のプレースホルダーを組み合わせてIDを作成することができます。たとえば、インプレッション単価 \(CPI\) の場合、ユーザーのIDFA(広告ID)とアプリIDを組み合わせることが可能です。 | ||
|
||
### Adjustを使用してCPMを計測する \{\#measure\-cpm\-with\-adjust\} | ||
### Adjustを使用してCPMを計測する {#measure-cpm-with-adjust} | ||
|
||
CPM(1000回表示あたりの広告費用)データをAdjustに送信するには、パートナー広告費用APIコールで送信する`cost_id`と同じ値を持つ`cost_id`をインプレッションURLに追加してください。CPMを計測する際は、インプレッション **ごと** にCPMを送信する必要があります。 | ||
|
||
広告費用データを送信する \{\#send\-ad\-spend\-data\} | ||
---------------------------------------------- | ||
## 広告費用データを送信する \{\#send\-ad\-spend\-data\} | ||
|
||
<codeblock title="エンドポイント" highlight="/cost"> | ||
<CodeBlock title="エンドポイント" highlight="/cost"> | ||
|
||
```http | ||
POST https://app.adjust.com/cost | ||
``` | ||
|
||
</CodeBlock> | ||
</CodeBlock> | ||
|
||
Adjustに広告費用情報を送信するには、`/cost`エンドポイントにPOSTリクエストを送信します。 | ||
|
||
### パラメーター \{\#parameters\} | ||
### パラメーター {#parameters} | ||
|
||
各リクエストごとに以下のパラメーターを送信する必要があります。全てのパラメーターは、小文字の **クエリパラメーター** である必要があります。 | ||
|
||
|
@@ -47,7 +46,7 @@ Adjustに広告費用情報を送信するには、`/cost`エンドポイント | |
|
||
`cost_currency` (`String`) | ||
|
||
: 広告費用情報の通貨コード。[ISO 4217](https://www.iban.com/currency-codes)の通貨コードでフォーマットされなければなりません。Adjustがサポートしている[全ての通貨のリスト](https://help.adjust.com/en/article/supported-currencies)をご覧ください。 | ||
: 広告費用情報の通貨コード。[ISO 4217](https://www.iban.com/currency-codes)の通貨コードでフォーマットされなければなりません。Adjustがサポートしている[全ての通貨のリスト](https://help.adjust.com/ja/article/supported-currencies)をご覧ください。 | ||
|
||
`cost_amount` \( `Float`\):コスト値。この値は、小数点以下5桁までです。 | ||
|
||
|
@@ -59,23 +58,22 @@ Adjustに広告費用情報を送信するには、`/cost`エンドポイント | |
|
||
: ログの記録やデバッグに使用するラベル。この値は最大128文字で設定可能です。 | ||
|
||
### 例 \{\#example\} | ||
### 例 {#example} | ||
|
||
<codeblock title="cURL" highlight="cost_type, cost_currency, cost_amount, cost_id, tag"> | ||
<CodeBlock title="cURL" highlight="cost_type, cost_currency, cost_amount, cost_id, tag"> | ||
|
||
```console | ||
$ curl -X POST https://app.adjust.com/cost \ | ||
-d "cost_type=cpi&cost_currency=usd&cost_amount=2&cost_id=abc123_company_name_test_1&tag=company_name_test" | ||
``` | ||
|
||
</CodeBlock> | ||
</CodeBlock> | ||
|
||
レスポンス \{\#responses\} | ||
------------------------ | ||
## レスポンス \{\#responses\} | ||
|
||
`200 Success` | ||
|
||
: 広告費用情報がAdjustに送信されました。 | ||
: 広告費用情報がAdjustに送信されました。 | ||
|
||
`400 Bad request` | ||
|
||
|
@@ -89,10 +87,8 @@ $ curl -X POST https://app.adjust.com/cost \ | |
|
||
: 指定された認証情報には、送信された情報を投稿する権限がありません。問題を解決するには、[[email protected]](mailto:[email protected])にお問い合わせください。 | ||
|
||
連携をテストする \{\#test\-your\-integration\} | ||
------------------------------------------- | ||
## 連携をテストする \{\#test\-your\-integration\} | ||
|
||
必要なパラメーターを送信するようサーバーを設定したら、[[email protected]](mailto:[email protected])までご連絡ください。Adjustでは、お客様に一連のテストを提供しています。連携を有効化する前に、異なるコストタイプに乖離が生じていないか、他に問題がないかどうかを確認できます。Adjustはまた、API連携が期待通りに機能していることを確認するため、Adjust APIのテストも実施しています。 | ||
|
||
テストが完了すると、Adjustは連携された[広告費用パートナーのリスト](https://help.adjust.com/en/article/ad-spend-api-integrations#supported-partners)にお客様を追加します。 | ||
|
||
テストが完了すると、Adjustは連携された[広告費用パートナーのリスト](https://help.adjust.com/ja/article/ad-spend-api-integrations#supported-partners)にお客様を追加します。 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,53 +1,52 @@ | ||
--- | ||
title: "파트너 광고 비용 푸시 API" | ||
description: "파트너 광고 비용 API를 사용하면 캠페인과 관련된 광고 비용 정보를 Adjust에 전송할 수 있습니다." | ||
category-title: "파트너 광고 비용 API" | ||
slug: "en/api/ad-spend-api" | ||
title: 파트너 광고 비용 푸시 API | ||
description: 파트너 광고 비용 API를 사용하면 캠페인과 관련된 광고 비용 정보를 Adjust에 전송할 수 있습니다. | ||
category-title: 파트너 광고 비용 API | ||
slug: ko/api/ad-spend-api | ||
sidebar-position: 2 | ||
--- | ||
파트너 광고 비용 API를 사용하면 캠페인과 관련된 광고 비용 정보를 Adjust에 전송할 수 있습니다. Adjust는 인게이지먼트 발생 이후 **최대 7일** 까지의 인게이지먼트 데이터를 허용합니다. | ||
|
||
비용 ID 설정 \{\#cost\-id\} | ||
--------------------------- | ||
파트너 광고 비용 API를 사용하면 캠페인과 관련된 광고 비용 정보를 Adjust에 전송할 수 있습니다. Adjust는 인게이지먼트 발생 이후 **최대 7일** 까지의 인게이지먼트 데이터를 허용합니다. | ||
|
||
**비용 ID** | ||
## 비용 ID 설정 \{\#cost\-id\} | ||
|
||
**비용 ID** | ||
|
||
: **12~256자 길이** 의 고유한 광고 비용 인게이지먼트 식별자. | ||
|
||
파트너 광고 비용 API를 호출할 때마다 캠페인과 관련된 고유한 **비용 ID** 를 포함해야 합니다. Adjust는 비용 ID를 사용하여 클릭 또는 노출과 함께 전송된 광고 비용 데이터를 매칭합니다. | ||
|
||
비용 ID는 반드시 고유해야 합니다. Universally Unique Identifier \(UUID\) 사용하거나 ID 앞에 회사명을 붙여 사용하는 것을 권장드립니다. 예: `network_name_848dsf4939fgwjn028erg4` | ||
비용 ID는 반드시 고유해야 합니다. Universally Unique Identifier \(UUID\) 사용하거나 ID 앞에 회사명을 붙여 사용하는 것을 권장드립니다. 예: `network_name_848dsf4939fgwjn028erg4` | ||
|
||
기존의 `click_id` 또는 `impression_id`도 사용이 가능합니다. 고유의 클릭 또는 노출 ID를 생성하지 않은 경우, 2개 이상의 플레이스홀더를 조합하여 ID를 만들 수 있습니다. 예를 들어 CPI의 경우, 사용자의 IDFA\(광고주용 ID\)와 앱 ID를 조합할 수 있습니다. | ||
기존의 `click_id` 또는 `impression_id`도 사용이 가능합니다. 고유의 클릭 또는 노출 ID를 생성하지 않은 경우, 2개 이상의 플레이스홀더를 조합하여 ID를 만들 수 있습니다. 예를 들어 CPI의 경우, 사용자의 IDFA\(광고주용 ID\)와 앱 ID를 조합할 수 있습니다. | ||
|
||
### Adjust를 통한 CPM 측정 \{\#measure\-cpm\-with\-adjust\} | ||
### Adjust를 통한 CPM 측정 {#measure-cpm-with-adjust} | ||
|
||
CPM \(1000회당 비용\) 데이터를 Adjust로 전송하려면 노출 URL에 파트너 광고 API 콜에서 전송하는 `cost_id` 와 동일한 값으로 `cost_id` 를 추가하시기 바랍니다. CPM을 측정할 때는 **각** 노출과 함께 CPM을 전송해야 합니다\(MUST\). | ||
|
||
광고 비용 데이터 전송 \{\#send\-ad\-spend\-data\} | ||
---------------------------------------------- | ||
## 광고 비용 데이터 전송 \{\#send\-ad\-spend\-data\} | ||
|
||
<codeblock title="엔드포인트" highlight="/cost"> | ||
<CodeBlock title="엔드포인트" highlight="/cost"> | ||
|
||
```http | ||
POST https://app.adjust.com/cost | ||
``` | ||
|
||
</CodeBlock> | ||
</CodeBlock> | ||
|
||
Adjust에 광고 비용 정보를 보내려면 `/cost` 엔드포인트에 POST 요청을 전송합니다. | ||
|
||
### 파라미터 \{\#parameters\} | ||
### 파라미터 {#parameters} | ||
|
||
각 요청과 함께 반드시 다음의 파라미터를 전송해야 합니다. 모든 파라미터는 반드시 소문자 **쿼리 파라미터** 여야 합니다. | ||
|
||
`cost_type` \(`String`\) | ||
|
||
: 요금제 모델. 예: `cpc`, `cpi`, `cpe`. | ||
: 요금제 모델. 예: `cpc`, `cpi`, `cpe`. | ||
|
||
`cost_currency` \(`String`\) | ||
|
||
: 광고 비용의 통화 코드. [ISO 4217](https://www.iban.com/currency-codes) 통화 코드 형식이어야 합니다. [지원되는 통화 목록](https://help.adjust.com/en/article/supported-currencies)을 참조하시기 바랍니다. | ||
: 광고 비용의 통화 코드. [ISO 4217](https://www.iban.com/currency-codes) 통화 코드 형식이어야 합니다. [지원되는 통화 목록](https://help.adjust.com/ko/article/supported-currencies)을 참조하시기 바랍니다. | ||
|
||
`cost_amount` \(`Float`\) | ||
: 비용 값. 최대 소수점 5자리. | ||
|
@@ -58,29 +57,28 @@ Adjust에 광고 비용 정보를 보내려면 `/cost` 엔드포인트에 POST | |
|
||
`tag` \(`String`\) | ||
|
||
: 로그와 디버그에 사용한 레이블. 이 값은 최대 128자여야 합니다. | ||
: 로그와 디버그에 사용한 레이블. 이 값은 최대 128자여야 합니다. | ||
|
||
### 예 \{\#example\} | ||
### 예 {#example} | ||
|
||
<codeblock title="cURL" highlight="cost_type, cost_currency, cost_amount, cost_id, tag"> | ||
<CodeBlock title="cURL" highlight="cost_type, cost_currency, cost_amount, cost_id, tag"> | ||
|
||
```console | ||
$ curl -X POST https://app.adjust.com/cost \ | ||
-d "cost_type=cpi&cost_currency=usd&cost_amount=2&cost_id=abc123_company_name_test_1&tag=company_name_test" | ||
``` | ||
|
||
</CodeBlock> | ||
</CodeBlock> | ||
|
||
응답 \{\#responses\} | ||
--------------------- | ||
## 응답 \{\#responses\} | ||
|
||
`200 Success` | ||
|
||
: 광고 비용 정보가 Adjust에 전송되었습니다. | ||
: 광고 비용 정보가 Adjust에 전송되었습니다. | ||
|
||
`400 Bad request` | ||
|
||
: 요청의 형식이 적절하지 않습니다. [모든 필수 파라미터](#parameters)가 포함되었는지 확인하시기 바랍니다. | ||
: 요청의 형식이 적절하지 않습니다. [모든 필수 파라미터](#parameters)가 포함되었는지 확인하시기 바랍니다. | ||
|
||
`401 Unauthorized` | ||
|
||
|
@@ -90,10 +88,8 @@ $ curl -X POST https://app.adjust.com/cost \ | |
|
||
: 입력하신 인증 정보는 전송한 정보를 게시할 수 있는 권한이 없습니다. 문제 해결을 위해 [[email protected]](mailto:[email protected])으로 연락주시기 바랍니다. | ||
|
||
연동 테스트 \{\#test\-your\-integration\} | ||
----------------------------------------- | ||
## 연동 테스트 \{\#test\-your\-integration\} | ||
|
||
필수 파라미터를 보낼 수 있도록 서버 구성이 완료되면 [[email protected]](mailto:[email protected])으로 연락하시기 바랍니다. Adjust는 여러 차례의 테스트를 제공하여, 연동을 라이브로 설정하기에 앞서 여러 광고 비용 유형 간의 데이터 불일치를 확인하고 문제를 해결할 수 있습니다. Adjust는 또한 Adjust API 테스트를 통해 API 연동이 올바르게 작동하는지 확인합니다. | ||
|
||
테스트가 완료되면 Adjust의 연동 광고 비용 파트너 목록에 파트너로 추가됩니다. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,16 +1,16 @@ | ||
--- | ||
title: "合作伙伴广告支出推送 API" | ||
description: "使用合作伙伴广告支出 API,向 Adjust 发送与推广活动相关的广告支出信息。" | ||
category-title: "合作伙伴广告支出 API" | ||
slug: "en/api/ad-spend-api" | ||
title: 合作伙伴广告支出推送 API | ||
description: 使用合作伙伴广告支出 API,向 Adjust 发送与推广活动相关的广告支出信息。 | ||
category-title: 合作伙伴广告支出 API | ||
slug: zh/api/ad-spend-api | ||
sidebar-position: 2 | ||
--- | ||
|
||
使用合作伙伴广告支出 API,向 Adjust 发送与推广活动相关的广告支出信息。Adjust 可接受交互发生后 **最多 7 天** 的广告支出数据。 | ||
|
||
设置成本 ID\{\#cost\-id\} | ||
------------------------- | ||
## 设置成本 ID\{\#cost\-id\} | ||
|
||
**成本 ID** | ||
**成本 ID** | ||
|
||
: 唯一广告支出交互标识符,长度在 **12 \- 256 个字符之间** 。 | ||
|
||
|
@@ -20,24 +20,23 @@ sidebar-position: 2 | |
|
||
您可以使用已有的 `click_id` 或 `impression_id`。如果您不生成自己的点击或展示 ID,则可以将两个或多个占位符组合在一起构建 ID。例如,对于单次展示成本 \(CPI\),您可以将用户 IDFA \(广告主 ID\) 和应用 ID 组合在一起。 | ||
|
||
### 使用 Adjust 监测 CPM\{\#measure\-cpm\-with\-adjust\} | ||
### 使用 Adjust 监测 CPM{#measure-cpm-with-adjust} | ||
|
||
要向 Adjust 发送 CPM \(每千次展示成本\) 数据,请向您的展示 URL 添加 `cost_id` 参数,其值需要与合作伙伴广告支出 API 调用中发送的 `cost_id` 相同。在监测 CPM 时,您必须随 **每次** 展示发送 CPM。 | ||
|
||
发送广告支出数据\{\#send\-ad\-spend\-data\} | ||
----------------------------------------- | ||
## 发送广告支出数据\{\#send\-ad\-spend\-data\} | ||
|
||
<codeblock title="终端" highlight="/cost"> | ||
<CodeBlock title="终端" highlight="/cost"> | ||
|
||
```http | ||
POST https://app.adjust.com/cost | ||
``` | ||
|
||
</CodeBlock> | ||
</CodeBlock> | ||
|
||
向 `/cost` 终端发送 POST 请求,以向 Adjust 发送广告支出信息。 | ||
|
||
### 参数\{\#parameters\} | ||
### 参数{#parameters} | ||
|
||
您必须在每个请求中发送以下参数。所有 **查询参数** 都必须为小写。 | ||
|
||
|
@@ -47,7 +46,7 @@ POST https://app.adjust.com/cost | |
|
||
`cost_currency` \(`String`\) | ||
|
||
: 广告支出信息的货币代码。必须采用 [ISO 4217](https://www.iban.com/currency-codes) 货币代码格式。请参阅我们[支持币种的完整清单](https://help.adjust.com/en/article/supported-currencies)。 | ||
: 广告支出信息的货币代码。必须采用 [ISO 4217](https://www.iban.com/currency-codes) 货币代码格式。请参阅我们[支持币种的完整清单](https://help.adjust.com/zh/article/supported-currencies)。 | ||
|
||
`cost_amount` \(`Float`\) | ||
: 成本值。此值最多可以保留到小数点后五位。 | ||
|
@@ -60,19 +59,18 @@ POST https://app.adjust.com/cost | |
|
||
: 用于日志记录和调试的标签。该值最大长度不得超过 128 个字符。 | ||
|
||
### 示例 \{\#example\} | ||
### 示例 {#example} | ||
|
||
<codeblock title="cURL" highlight="cost_type, cost_currency, cost_amount, cost_id, tag"> | ||
<CodeBlock title="cURL" highlight="cost_type, cost_currency, cost_amount, cost_id, tag"> | ||
|
||
```console | ||
$ curl -X POST https://app.adjust.com/cost \ | ||
-d "cost_type=cpi&cost_currency=usd&cost_amount=2&cost_id=abc123_company_name_test_1&tag=company_name_test" | ||
``` | ||
|
||
</CodeBlock> | ||
</CodeBlock> | ||
|
||
响应\{\#responses\} | ||
-------------------- | ||
## 响应\{\#responses\} | ||
|
||
`200 Success` | ||
|
||
|
@@ -90,10 +88,8 @@ $ curl -X POST https://app.adjust.com/cost \ | |
|
||
: 您提供的凭证权限不足,无法发布您发送的信息。请发送邮件至 [[email protected]](mailto:[email protected]),进行故障排查。 | ||
|
||
测试集成\{\#test\-your\-integration\} | ||
-------------------------------------- | ||
## 测试集成\{\#test\-your\-integration\} | ||
|
||
完成服务器配置,可发送所需的参数后,请联系 [[email protected]](mailto:[email protected]),Adjust 会为您提供一系列测试。您可以检查不同广告支出类型中的差异,在集成上线之前发现并解决任何问题。我们还会针对 Adjust API 进行测试,确保 API 集成顺利进行并能正常运作。 | ||
|
||
测试完成后,Adjust 会将您添加至[集成广告支出合作伙伴列表](https://help.adjust.com/en/article/ad-spend-api-integrations#supported-partners)。 | ||
|
||
测试完成后,Adjust 会将您添加至[集成广告支出合作伙伴列表](https://help.adjust.com/zh/article/ad-spend-api-integrations#supported-partners)。 |