From 721dbd9d0444f03268c431797b7bce624aabee33 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:32 +0000 Subject: [PATCH 01/39] File src/content/docs/en/sdk/android/v4/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/android/v4/features/ad-revenue.mdx | 295 ++++++++---------- 1 file changed, 123 insertions(+), 172 deletions(-) diff --git a/src/content/docs/ko/sdk/android/v4/features/ad-revenue.mdx b/src/content/docs/ko/sdk/android/v4/features/ad-revenue.mdx index ecdfd1c72..d2ff41ab4 100644 --- a/src/content/docs/ko/sdk/android/v4/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/android/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 광고 매출 정보 전송 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 전송합니다. -slug: ko/sdk/android/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/android/features/ad-revenue +title: "광고 매출 정보 전송" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 전송합니다." +slug: "en/sdk/android/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/ko/sdk/android/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - +AdjustAdRevenue 객체 인스턴스화 +------------------------ -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} - - + ```java public AdjustAdRevenue(final String source) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ------------------------------------------- | ----------------- | +| 파라미터 | 소스 | +|---------------------------------------------|-------------------| | `AdjustConfig.AD_REVENUE_APPLOVIN_MAX` | AppLovin MAX | | `AdjustConfig.AD_REVENUE_MOPUB` | MoPub | | `AdjustConfig.AD_REVENUE_ADMOB` | Admob | @@ -45,99 +45,89 @@ Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdReve | `AdjustConfig.AD_REVENUE_ADMOST` | Admost | | `AdjustConfig.AD_REVENUE_UNITY` | Unity | | `AdjustConfig.AD_REVENUE_HELIUM_CHARTBOOST` | Helium Chartboost | -| `AdjustConfig.AD_REVENUE_ADX` | Ad\(X\) | +| `AdjustConfig.AD_REVENUE_ADX` | Ad\(X\) | | `AdjustConfig.AD_REVENUE_SOURCE_TOPON` | TopOn | | `AdjustConfig.AD_REVENUE_SOURCE_TRADPLUS` | TradPlus | -| `AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER` | 일반적인 소스 | +| `AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER` | 일반적인 소스 | - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```java public static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```java public void setRevenue(final Double revenue, final String currency) ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`Double`\): 매출 금액 -- `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`Double`\): 매출 금액 +* `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -145,8 +135,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -154,8 +143,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -163,29 +151,28 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```java public void setAdImpressionsCount(final Integer adImpressionsCount) ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`Integer`\): 광고 노출 횟수 +* `adImpressionsCount` \(`Integer`\): 광고 노출 횟수 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -193,8 +180,7 @@ adjustAdRevenue.setAdImpressionsCount(10) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -202,8 +188,7 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -211,25 +196,23 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```java public void setAdRevenueNetwork(final String adRevenueNetwork) ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`String`\): 네트워크 이름 +* `adRevenueNetwork` \(`String`\): 네트워크 이름 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -237,8 +220,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -246,8 +228,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -255,25 +236,23 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```java public void setAdRevenueUnit(final String adRevenueUnit) ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`String`\): 광고 유닛 +* `adRevenueUnit` \(`String`\): 광고 단위 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -281,8 +260,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -290,8 +268,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -299,25 +276,23 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```java public void setAdRevenuePlacement(final String adRevenuePlacement) ``` - + 광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenuePlacement` \(`String`\): 광고 게재 위치 +* `adRevenuePlacement` \(`String`\): 광고 게재 위치 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -325,8 +300,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -334,8 +308,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -343,51 +316,44 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```java public void addCallbackParameter(final String key, final String value) ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 설정할 수 있습니다. 이벤트에 대한 파라미터 설정이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자의 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `String` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -395,8 +361,7 @@ adjustAdRevenue.addCallbackParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -404,8 +369,7 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -413,33 +377,25 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```java public void addPartnerParameter(String key, String value) ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. + - +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `String` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -447,8 +403,7 @@ adjustAdRevenue.addPartnerParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -456,8 +411,7 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -465,24 +419,23 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) @@ -496,8 +449,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -511,8 +463,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -526,5 +477,5 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + + From 48c8ab9a2d0515f2af15ad67695888c393439fa9 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:34 +0000 Subject: [PATCH 02/39] File src/content/docs/en/sdk/android/v4/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/android/v4/features/ad-revenue.mdx | 295 ++++++++---------- 1 file changed, 123 insertions(+), 172 deletions(-) diff --git a/src/content/docs/zh/sdk/android/v4/features/ad-revenue.mdx b/src/content/docs/zh/sdk/android/v4/features/ad-revenue.mdx index fde81fb27..16f1897a1 100644 --- a/src/content/docs/zh/sdk/android/v4/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/android/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 发送广告收入信息 -description: 使用 Adjust SDK 发送受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/android/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/android/features/ad-revenue +title: "发送广告收入信息" +description: "使用 Adjust SDK 发送受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/android/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} - - + ```java public AdjustAdRevenue(final String source) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ------------------------------------------- | ----------------- | +| 参数 | 来源 | +|---------------------------------------------|-------------------| | `AdjustConfig.AD_REVENUE_APPLOVIN_MAX` | AppLovin MAX | | `AdjustConfig.AD_REVENUE_MOPUB` | mopub | | `AdjustConfig.AD_REVENUE_ADMOB` | AdMob | @@ -45,99 +45,89 @@ public AdjustAdRevenue(final String source) | `AdjustConfig.AD_REVENUE_ADMOST` | Admost | | `AdjustConfig.AD_REVENUE_UNITY` | Unity | | `AdjustConfig.AD_REVENUE_HELIUM_CHARTBOOST` | Helium Chartboost | -| `AdjustConfig.AD_REVENUE_ADX` | Ad\(X\) | +| `AdjustConfig.AD_REVENUE_ADX` | Ad\(X\) | | `AdjustConfig.AD_REVENUE_SOURCE_TOPON` | TopOn | | `AdjustConfig.AD_REVENUE_SOURCE_TRADPLUS` | TradPlus | -| `AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER` | 通用来源 | +| `AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER` | 通用来源 | - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```java public static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```java public void setRevenue(final Double revenue, final String currency) ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`Double`\)：收入额 -- `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`Double`\)：收入额 +* `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -145,8 +135,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -154,8 +143,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -163,29 +151,28 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```java public void setAdImpressionsCount(final Integer adImpressionsCount) ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`Integer`\)：广告展示数量。 +* `adImpressionsCount` \(`Integer`\)：广告展示数量。 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -193,8 +180,7 @@ adjustAdRevenue.setAdImpressionsCount(10) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -202,8 +188,7 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -211,25 +196,23 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```java public void setAdRevenueNetwork(final String adRevenueNetwork) ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \(`String`\)：渠道名称 +* `adRevenueNetwork` \(`String`\)：渠道名称 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -237,8 +220,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -246,8 +228,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -255,25 +236,23 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```java public void setAdRevenueUnit(final String adRevenueUnit) ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \(`String`\)：广告单位 +* `adRevenueUnit` \(`String`\)：广告单位 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -281,8 +260,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -290,8 +268,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -299,25 +276,23 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```java public void setAdRevenuePlacement(final String adRevenuePlacement) ``` - + 要发送广告收入位置，请调用 `setAdRevenuePlacement` 方法，并传送下列参数： -- `adRevenuePlacement` \(`String`\)：广告位 +* `adRevenuePlacement` \(`String`\)：广告位 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -325,8 +300,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -334,8 +308,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -343,51 +316,44 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```java public void addCallbackParameter(final String key, final String value) ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `String` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -395,8 +361,7 @@ adjustAdRevenue.addCallbackParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -404,8 +369,7 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -413,33 +377,25 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```java public void addPartnerParameter(String key, String value) ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 + - +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `String` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -447,8 +403,7 @@ adjustAdRevenue.addPartnerParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -456,8 +411,7 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -465,24 +419,23 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) @@ -496,8 +449,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -511,8 +463,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -526,5 +477,5 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + + From 6a1e37884339b99b1f0b361cf1ddfb9d9bf3a4e6 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:37 +0000 Subject: [PATCH 03/39] File src/content/docs/en/sdk/android/v4/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/android/v4/features/ad-revenue.mdx | 297 ++++++++---------- 1 file changed, 124 insertions(+), 173 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v4/features/ad-revenue.mdx b/src/content/docs/ja/sdk/android/v4/features/ad-revenue.mdx index 70ec420ca..f03781412 100644 --- a/src/content/docs/ja/sdk/android/v4/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/android/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 広告収益情報を送信する -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を送信します。 -slug: ja/sdk/android/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/android/features/ad-revenue +title: "広告収益情報を送信する" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を送信します。" +slug: "en/sdk/android/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/android/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```java public AdjustAdRevenue(final String source) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ------------------------------------------- | ----------------- | +| パラメーター | ソース | +|---------------------------------------------|-------------------| | `AdjustConfig.AD_REVENUE_APPLOVIN_MAX` | AppLovin MAX | | `AdjustConfig.AD_REVENUE_MOPUB` | MoPub | | `AdjustConfig.AD_REVENUE_ADMOB` | AdMob | @@ -45,99 +45,89 @@ Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブ | `AdjustConfig.AD_REVENUE_ADMOST` | Admost | | `AdjustConfig.AD_REVENUE_UNITY` | Unity | | `AdjustConfig.AD_REVENUE_HELIUM_CHARTBOOST` | Helium Chartboost | -| `AdjustConfig.AD_REVENUE_ADX` | Ad\(X\) | +| `AdjustConfig.AD_REVENUE_ADX` | Ad\(X\) | | `AdjustConfig.AD_REVENUE_SOURCE_TOPON` | TopOn | | `AdjustConfig.AD_REVENUE_SOURCE_TRADPLUS` | TradPlus | -| `AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER` | 汎用ソース | +| `AdjustConfig.AD_REVENUE_SOURCE_PUBLISHER` | 汎用ソース | - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```java public static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```java public void setRevenue(final Double revenue, final String currency) ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `Double`）：収益額 -- `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `Double`）：収益額 +* `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -145,8 +135,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -154,8 +143,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -163,29 +151,28 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```java public void setAdImpressionsCount(final Integer adImpressionsCount) ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`Integer`）：広告インプレッションの数。 +* `adImpressionsCount` （`Integer`）：広告インプレッションの数。 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -193,8 +180,7 @@ adjustAdRevenue.setAdImpressionsCount(10) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -202,8 +188,7 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -211,25 +196,23 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```java public void setAdRevenueNetwork(final String adRevenueNetwork) ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （`String`）：ネットワーク名 +* `adRevenueNetwork` （`String`）：ネットワーク名 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -237,8 +220,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -246,8 +228,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -255,25 +236,23 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```java public void setAdRevenueUnit(final String adRevenueUnit) ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （`String`）：広告ユニット +* `adRevenueUnit` （`String`）：広告ユニット - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -281,8 +260,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -290,8 +268,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -299,25 +276,23 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```java public void setAdRevenuePlacement(final String adRevenuePlacement) ``` - + 広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： -- `adRevenuePlacement` （`String`）：広告配置 +* `adRevenuePlacement` （`String`）：広告配置 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -325,8 +300,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -334,8 +308,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -343,51 +316,44 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```java public void addCallbackParameter(final String key, final String value) ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`String` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -395,8 +361,7 @@ adjustAdRevenue.addCallbackParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -404,8 +369,7 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -413,33 +377,25 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```java public void addPartnerParameter(String key, String value) ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 + - +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`String` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("source") @@ -447,8 +403,7 @@ adjustAdRevenue.addPartnerParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -456,8 +411,7 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue("source"); @@ -465,24 +419,23 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) @@ -496,8 +449,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -511,8 +463,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + ```js let adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -526,5 +477,5 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + + From aa9cb43d56d6b1ff4adfa80fea221914ed5e3fc0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:40 +0000 Subject: [PATCH 04/39] File src/content/docs/en/sdk/android/v5/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/android/v5/features/ad-revenue.mdx | 265 ++++++++---------- 1 file changed, 113 insertions(+), 152 deletions(-) diff --git a/src/content/docs/ko/sdk/android/v5/features/ad-revenue.mdx b/src/content/docs/ko/sdk/android/v5/features/ad-revenue.mdx index 5fda3135f..566d3095f 100644 --- a/src/content/docs/ko/sdk/android/v5/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/android/v5/features/ad-revenue.mdx @@ -1,127 +1,119 @@ --- -title: 광고 매출 정보 전송 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 전송합니다. -slug: ko/sdk/android/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/android/v4/features/ad-revenue +title: "광고 매출 정보 전송" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 전송합니다." +slug: "en/sdk/android/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/android/v4/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} - - + ```java public AdjustAdRevenue(final String source) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 인수 \(Arguments\) | 광고 매출 소스 | -| ------------------------- | ----------------- | +| 인수 \(Arguments\) | 광고 매출 소스 | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | Admob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 일반적인 소스 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 일반적인 소스 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | | `"mopub"` | MoPub | - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```java public static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```java public void setRevenue(final Double revenue, final String currency) ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`Double`\): 매출 금액 -- `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`Double`\): 매출 금액 +* `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -129,8 +121,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -138,29 +129,28 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```java public void setAdImpressionsCount(final Integer adImpressionsCount) ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`Integer`\): 광고 노출 횟수 +* `adImpressionsCount` \(`Integer`\): 광고 노출 횟수 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -168,8 +158,7 @@ adjustAdRevenue.setAdImpressionsCount(10) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -177,25 +166,23 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```java public void setAdRevenueNetwork(final String adRevenueNetwork) ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`String`\): 네트워크 이름 +* `adRevenueNetwork` \(`String`\): 네트워크 이름 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -203,8 +190,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -212,25 +198,23 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```java public void setAdRevenueUnit(final String adRevenueUnit) ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`String`\): 광고 유닛 +* `adRevenueUnit` \(`String`\): 광고 단위 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -238,8 +222,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -247,25 +230,23 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```java public void setAdRevenuePlacement(final String adRevenuePlacement) ``` - + 광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenuePlacement` \(`String`\): 광고 게재 위치 +* `adRevenuePlacement` \(`String`\): 광고 게재 위치 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -273,8 +254,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -282,51 +262,44 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```java public void addCallbackParameter(final String key, final String value) ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 설정할 수 있습니다. 이벤트에 대한 파라미터 설정이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자의 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `String` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -334,8 +307,7 @@ adjustAdRevenue.addCallbackParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -343,33 +315,25 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```java public void addPartnerParameter(String key, String value) ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. + - +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `String` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -377,8 +341,7 @@ adjustAdRevenue.addPartnerParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -386,24 +349,23 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) @@ -417,8 +379,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -432,5 +393,5 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + + From 51411f6ad18557b944e473b3b51e6ef9847b9dc6 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:42 +0000 Subject: [PATCH 05/39] File src/content/docs/en/sdk/android/v5/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/android/v5/features/ad-revenue.mdx | 265 ++++++++---------- 1 file changed, 113 insertions(+), 152 deletions(-) diff --git a/src/content/docs/zh/sdk/android/v5/features/ad-revenue.mdx b/src/content/docs/zh/sdk/android/v5/features/ad-revenue.mdx index 0d232fd77..d64b783f8 100644 --- a/src/content/docs/zh/sdk/android/v5/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/android/v5/features/ad-revenue.mdx @@ -1,127 +1,119 @@ --- -title: 发送广告收入信息 -description: 使用 Adjust SDK 发送受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/android/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/android/v4/features/ad-revenue +title: "发送广告收入信息" +description: "使用 Adjust SDK 发送受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/android/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} - - + ```java public AdjustAdRevenue(final String source) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 广告收入来源 | -| ------------------------- | ----------------- | +| 参数 | 广告收入来源 | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | IronSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 通用来源 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 通用来源 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | | `"mopub"` | mopub | - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```java public static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```java public void setRevenue(final Double revenue, final String currency) ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`Double`\)：收入额 -- `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`Double`\)：收入额 +* `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -129,8 +121,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -138,29 +129,28 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```java public void setAdImpressionsCount(final Integer adImpressionsCount) ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`Integer`\)：广告展示数量。 +* `adImpressionsCount` \(`Integer`\)：广告展示数量。 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -168,8 +158,7 @@ adjustAdRevenue.setAdImpressionsCount(10) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -177,25 +166,23 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```java public void setAdRevenueNetwork(final String adRevenueNetwork) ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \(`String`\)：渠道名称 +* `adRevenueNetwork` \(`String`\)：渠道名称 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -203,8 +190,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -212,25 +198,23 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```java public void setAdRevenueUnit(final String adRevenueUnit) ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \(`String`\)：广告单位 +* `adRevenueUnit` \(`String`\)：广告单位 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -238,8 +222,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -247,25 +230,23 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```java public void setAdRevenuePlacement(final String adRevenuePlacement) ``` - + 要发送广告收入位置，请调用 `setAdRevenuePlacement` 方法，并传送下列参数： -- `adRevenuePlacement` \(`String`\)：广告位 +* `adRevenuePlacement` \(`String`\)：广告位 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -273,8 +254,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -282,51 +262,44 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```java public void addCallbackParameter(final String key, final String value) ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `String` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -334,8 +307,7 @@ adjustAdRevenue.addCallbackParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -343,33 +315,25 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```java public void addPartnerParameter(String key, String value) ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 + - +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `String` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -377,8 +341,7 @@ adjustAdRevenue.addPartnerParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -386,24 +349,23 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) @@ -417,8 +379,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -432,5 +393,5 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + + From ea7c7b8720f3fb0a428af9817c0f09afeb20581c Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:44 +0000 Subject: [PATCH 06/39] File src/content/docs/en/sdk/android/v5/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/android/v5/features/ad-revenue.mdx | 267 ++++++++---------- 1 file changed, 114 insertions(+), 153 deletions(-) diff --git a/src/content/docs/ja/sdk/android/v5/features/ad-revenue.mdx b/src/content/docs/ja/sdk/android/v5/features/ad-revenue.mdx index d5cb0e687..7dcac4614 100644 --- a/src/content/docs/ja/sdk/android/v5/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/android/v5/features/ad-revenue.mdx @@ -1,127 +1,119 @@ --- -title: 広告収益情報を送信する -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を送信します。 -slug: ja/sdk/android/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/android/v4/features/ad-revenue +title: "広告収益情報を送信する" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を送信します。" +slug: "en/sdk/android/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/android/v4/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```java public AdjustAdRevenue(final String source) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| 引数 | 広告収益ソース | -| ------------------------- | ----------------- | +| 引数 | 広告収益ソース | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 汎用ソース | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 汎用ソース | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | | `"mopub"` | MoPub | - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```java public static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```java public void setRevenue(final Double revenue, final String currency) ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `Double`）：収益額 -- `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `Double`）：収益額 +* `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -129,8 +121,7 @@ adjustAdRevenue.setRevenue(1.00, "EUR") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -138,29 +129,28 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```java public void setAdImpressionsCount(final Integer adImpressionsCount) ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`Integer`）：広告インプレッションの数。 +* `adImpressionsCount` （`Integer`）：広告インプレッションの数。 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -168,8 +158,7 @@ adjustAdRevenue.setAdImpressionsCount(10) Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -177,25 +166,23 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```java public void setAdRevenueNetwork(final String adRevenueNetwork) ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （`String`）：ネットワーク名 +* `adRevenueNetwork` （`String`）：ネットワーク名 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -203,8 +190,7 @@ adjustAdRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -212,25 +198,23 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```java public void setAdRevenueUnit(final String adRevenueUnit) ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （`String`）：広告ユニット +* `adRevenueUnit` （`String`）：広告ユニット - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -238,8 +222,7 @@ adjustAdRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -247,25 +230,23 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```java public void setAdRevenuePlacement(final String adRevenuePlacement) ``` - + 広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： -- `adRevenuePlacement` （`String`）：広告配置 +* `adRevenuePlacement` （`String`）：広告配置 - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -273,8 +254,7 @@ adjustAdRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -282,51 +262,44 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```java public void addCallbackParameter(final String key, final String value) ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`String` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -334,8 +307,7 @@ adjustAdRevenue.addCallbackParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -343,33 +315,25 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```java public void addPartnerParameter(String key, String value) ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 + - +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`String` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 - - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue("applovin_max_sdk") @@ -377,8 +341,7 @@ adjustAdRevenue.addPartnerParameter("key", "value") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -386,24 +349,23 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` - - + ```kotlin val adjustAdRevenue = AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX) @@ -417,8 +379,7 @@ adjustAdRevenue.addPartnerParameter("key2", "value2") Adjust.trackAdRevenue(adjustAdRevenue) ``` - - + ```java AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AD_REVENUE_APPLOVIN_MAX); @@ -432,5 +393,5 @@ adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` - - + + From 433c2d1d369a2d64c748f64d420ffa5568f9fc94 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:46 +0000 Subject: [PATCH 07/39] File src/content/docs/en/sdk/cocos2dx/v4/features/ad-revenue.mdx was translated to ko-KR locale --- .../sdk/cocos2dx/v4/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/ko/sdk/cocos2dx/v4/features/ad-revenue.mdx b/src/content/docs/ko/sdk/cocos2dx/v4/features/ad-revenue.mdx index 87822b47a..414fcb6c9 100644 --- a/src/content/docs/ko/sdk/cocos2dx/v4/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/cocos2dx/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 광고 매출 정보 전송 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 전송합니다. -slug: ko/sdk/cocos2dx/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/cocos2dx/features/ad-revenue +title: "광고 매출 정보 전송" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 전송합니다." +slug: "en/sdk/cocos2dx/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/ko/sdk/cocos2dx/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - +AdjustAdRevenue 객체 인스턴스화 +------------------------ -## AdjustAdRevenue 객체 인스턴스화 - - + ```cpp void AdjustAdRevenue2dx::initAdRevenue(std::string source); ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \( **문자열** \): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \( **문자열** \): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ------------------------------------------------------- | ----------------- | +| 파라미터 | 소스 | +|---------------------------------------------------------|-------------------| | `AdjustConfig2dx.AdjustAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig2dx.AdjustAdRevenueSourceMopub` | MoPub | | `AdjustConfig2dx.AdjustAdRevenueSourceAdMob` | Admob | @@ -45,23 +45,24 @@ Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdReve | `AdjustConfig2dx.AdjustAdRevenueSourceAdMostSource` | Admost | | `AdjustConfig2dx.AdjustAdRevenueSourceUnity` | Unity | | `AdjustConfig2dx.AdjustAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig2dx.AdjustAdRevenueSourceAdx` | Ad\(X\) | -| `AdjustConfig2dx.AdjustAdRevenueSourcePublisher` | 일반적인 소스 | +| `AdjustConfig2dx.AdjustAdRevenueSourceAdx` | Ad\(X\) | +| `AdjustConfig2dx.AdjustAdRevenueSourcePublisher` | 일반적인 소스 | ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 광고 매출 전송 +광고 매출 전송 +-------- - + ```cpp static void trackAdRevenueNew(AdjustAdRevenue2dx adRevenue); ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenueNew` 메서드를 호출합니다. @@ -70,26 +71,26 @@ AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustA Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 광고 매출 금액 기록 +광고 매출 금액 기록 +----------- - + ```cpp void AdjustAdRevenue2dx::setRevenue(double amount, std::string currency); ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `amount` \( **Double** \): 매출 금액 -- `currency` \( **문자열** \): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - - +* `amount` \( **Double** \): 매출 금액 +* `currency` \( **문자열** \): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) -자세한 정보는 Adjust의 [여러 통화로 구매 트래킹](https://help.adjust.com/ko/article/currency-conversion) 가이드를 참조하시기 바랍니다. + - +자세한 정보는 Adjust의 [여러 통화로 구매 트래킹](https://help.adjust.com/en/article/currency-conversion) 가이드를 참조하시기 바랍니다. + ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -97,23 +98,24 @@ adjustAdRevenue.setRevenue(0.01, "EUR"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 +광고 캠페인 세부 항목 기록 +--------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. ### 광고 노출 - + ```cpp void AdjustAdRevenue2dx::setAdImpressionsCount(int adImpressionsCount); ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \( **정수** \): 광고 노출 횟수. +* `adImpressionsCount` \( **정수** \): 광고 노출 횟수. ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -123,17 +125,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 광고 매출 네트워크 - + ```cpp void AdjustAdRevenue2dx::setAdRevenueNetwork(std::string adRevenueNetwork); ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \( **문자열** \): 네트워크 이름. +* `adRevenueNetwork` \( **문자열** \): 네트워크 이름. ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -143,17 +145,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 광고 매출 단위 - + ```cpp void AdjustAdRevenue2dx::setAdRevenueUnit(std::string adRevenueUnit); ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \( **문자열** \): 광고 단위. +* `adRevenueUnit` \( **문자열** \): 광고 단위. ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -163,17 +165,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 광고 매출 게재 위치 - + ```cpp void AdjustAdRevenue2dx::setAdRevenuePlacement(std::string adRevenuePlacement); ``` - + 광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenuePlacement` \( **문자열** \): 광고 게재 위치. +* `adRevenuePlacement` \( **문자열** \): 광고 게재 위치. ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -181,46 +183,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 콜백 파라미터 추가 +콜백 파라미터 추가 +---------- - + ```cpp void AdjustAdRevenue2dx::addCallbackParameter(std::string key, std::string value); ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. **문자열** 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -229,25 +227,20 @@ adjustAdRevenue.addCallbackParameter("foo", "bar"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 파트너 파라미터 추가 +파트너 파라미터 추가 +----------- - + ```cpp void AdjustAdRevenue2dx::addPartnerParameter(std::string key, std::string value); ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. + - +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. **문자열** 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. @@ -258,18 +251,19 @@ adjustAdRevenue.addPartnerParameter("foo", "bar"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 예시 +예시 +--- 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -282,3 +276,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` + From 1130b83b5942f6996027e74e425b5f37e2dec21d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:49 +0000 Subject: [PATCH 08/39] File src/content/docs/en/sdk/cocos2dx/v4/features/ad-revenue.mdx was translated to zh-CN locale --- .../sdk/cocos2dx/v4/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/zh/sdk/cocos2dx/v4/features/ad-revenue.mdx b/src/content/docs/zh/sdk/cocos2dx/v4/features/ad-revenue.mdx index dab328ef1..7f21f6575 100644 --- a/src/content/docs/zh/sdk/cocos2dx/v4/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/cocos2dx/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 发送广告收入信息 -description: 使用 Adjust SDK 发送受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/cocos2dx/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/cocos2dx/features/ad-revenue +title: "发送广告收入信息" +description: "使用 Adjust SDK 发送受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/cocos2dx/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cocos2dx/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - +实例化 AdjustAdRevenue 对象 +---------------------- -## 实例化 AdjustAdRevenue 对象 - - + ```cpp void AdjustAdRevenue2dx::initAdRevenue(std::string source); ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \( **字符串** \)：广告收入来源。请查看下表，了解来源。 +* `source` \( **字符串** \)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ------------------------------------------------------- | ----------------- | +| 参数 | 来源 | +|---------------------------------------------------------|-------------------| | `AdjustConfig2dx.AdjustAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig2dx.AdjustAdRevenueSourceMopub` | mopub | | `AdjustConfig2dx.AdjustAdRevenueSourceAdMob` | AdMob | @@ -45,23 +45,24 @@ void AdjustAdRevenue2dx::initAdRevenue(std::string source); | `AdjustConfig2dx.AdjustAdRevenueSourceAdMostSource` | Admost | | `AdjustConfig2dx.AdjustAdRevenueSourceUnity` | Unity | | `AdjustConfig2dx.AdjustAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig2dx.AdjustAdRevenueSourceAdx` | Ad\(X\) | -| `AdjustConfig2dx.AdjustAdRevenueSourcePublisher` | 通用来源 | +| `AdjustConfig2dx.AdjustAdRevenueSourceAdx` | Ad\(X\) | +| `AdjustConfig2dx.AdjustAdRevenueSourcePublisher` | 通用来源 | ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 发送广告收入 +发送广告收入 +------ - + ```cpp static void trackAdRevenueNew(AdjustAdRevenue2dx adRevenue); ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenueNew` 方法。 @@ -70,26 +71,26 @@ AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustA Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 记录广告收入额 +记录广告收入额 +------- - + ```cpp void AdjustAdRevenue2dx::setRevenue(double amount, std::string currency); ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `amount` \( **Double** \)：收入额 -- `currency` \( **字符串** \)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - - +* `amount` \( **Double** \)：收入额 +* `currency` \( **字符串** \)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 -欢迎查看我们的[跟踪不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 + - +欢迎查看我们的[跟踪不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -97,23 +98,24 @@ adjustAdRevenue.setRevenue(0.01, "EUR"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 记录广告推广活动细节 +记录广告推广活动细节 +---------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 ### 广告展示 - + ```cpp void AdjustAdRevenue2dx::setAdImpressionsCount(int adImpressionsCount); ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \( **整数** \)：广告展示数量。 +* `adImpressionsCount` \( **整数** \)：广告展示数量。 ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -123,17 +125,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 广告收入渠道 - + ```cpp void AdjustAdRevenue2dx::setAdRevenueNetwork(std::string adRevenueNetwork); ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \( **字符串** \)：渠道名称。 +* `adRevenueNetwork` \( **字符串** \)：渠道名称。 ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -143,17 +145,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 广告收入单位 - + ```cpp void AdjustAdRevenue2dx::setAdRevenueUnit(std::string adRevenueUnit); ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \( **字符串** \)：广告单位 +* `adRevenueUnit` \( **字符串** \)：广告单位 ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -163,17 +165,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 广告收入位置 - + ```cpp void AdjustAdRevenue2dx::setAdRevenuePlacement(std::string adRevenuePlacement); ``` - + 要发送广告收入位置，请调用 `setAdRevenuePlacement` 方法，并传送下列参数： -- `adRevenuePlacement` \( **字符串** \)：广告投放。 +* `adRevenuePlacement` \( **字符串** \)：广告投放。 ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -181,46 +183,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 添加回传参数 +添加回传参数 +------ - + ```cpp void AdjustAdRevenue2dx::addCallbackParameter(std::string key, std::string value); ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 **字符串** 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -229,25 +227,20 @@ adjustAdRevenue.addCallbackParameter("foo", "bar"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 添加合作伙伴参数 +添加合作伙伴参数 +-------- - + ```cpp void AdjustAdRevenue2dx::addPartnerParameter(std::string key, std::string value); ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 + - +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 **字符串** 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 @@ -258,18 +251,19 @@ adjustAdRevenue.addPartnerParameter("foo", "bar"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 示例 +示例 +--- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -282,3 +276,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` + From 395958b0150e6bbc41185124b14bb5a5698fd6c3 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:51 +0000 Subject: [PATCH 09/39] File src/content/docs/en/sdk/cocos2dx/v4/features/ad-revenue.mdx was translated to ja-JP locale --- .../sdk/cocos2dx/v4/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/ja/sdk/cocos2dx/v4/features/ad-revenue.mdx b/src/content/docs/ja/sdk/cocos2dx/v4/features/ad-revenue.mdx index 42545a894..e409826a0 100644 --- a/src/content/docs/ja/sdk/cocos2dx/v4/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/cocos2dx/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 広告収益情報を送信する -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を送信します。 -slug: ja/sdk/cocos2dx/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/cocos2dx/features/ad-revenue +title: "広告収益情報を送信する" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を送信します。" +slug: "en/sdk/cocos2dx/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cocos2dx/features/ad-revenue" --- - -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 - - +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + 広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する +------------------------------- -## AdjustAdRevenueオブジェクトをインスタンス化する - - + ```cpp void AdjustAdRevenue2dx::initAdRevenue(std::string source); ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （ **String** ）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （ **String** ）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ------------------------------------------------------- | ----------------- | +| パラメーター | ソース | +|---------------------------------------------------------|-------------------| | `AdjustConfig2dx.AdjustAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig2dx.AdjustAdRevenueSourceMopub` | MoPub | | `AdjustConfig2dx.AdjustAdRevenueSourceAdMob` | AdMob | @@ -45,23 +45,24 @@ Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブ | `AdjustConfig2dx.AdjustAdRevenueSourceAdMostSource` | Admost | | `AdjustConfig2dx.AdjustAdRevenueSourceUnity` | Unity | | `AdjustConfig2dx.AdjustAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig2dx.AdjustAdRevenueSourceAdx` | Ad\(X\) | -| `AdjustConfig2dx.AdjustAdRevenueSourcePublisher` | 汎用ソース | +| `AdjustConfig2dx.AdjustAdRevenueSourceAdx` | Ad\(X\) | +| `AdjustConfig2dx.AdjustAdRevenueSourcePublisher` | 汎用ソース | ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 広告収益の送信 +広告収益の送信 +------- - + ```cpp static void trackAdRevenueNew(AdjustAdRevenue2dx adRevenue); ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenueNew`メソッドを呼び出します。 @@ -70,26 +71,26 @@ AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustA Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 広告収益額を記録する +広告収益額を記録する +---------- - + ```cpp void AdjustAdRevenue2dx::setRevenue(double amount, std::string currency); ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `amount` （ **Double** ）：収益額 -- `currency` （ **String** ）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - - +* `amount` （ **Double** ）：収益額 +* `currency` （ **String** ）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) -詳細は、[異なる通貨での購入計測](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 + - +詳細は、[異なる通貨での購入計測](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -97,23 +98,24 @@ adjustAdRevenue.setRevenue(0.01, "EUR"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する +広告キャンペーンの詳細を記録する +---------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 ### 広告インプレッション数 - + ```cpp void AdjustAdRevenue2dx::setAdImpressionsCount(int adImpressionsCount); ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （ **Integer** ）：広告インプレッション数 +* `adImpressionsCount` （ **Integer** ）：広告インプレッション数 ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -123,17 +125,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 広告収益ネットワーク - + ```cpp void AdjustAdRevenue2dx::setAdRevenueNetwork(std::string adRevenueNetwork); ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （ **String** ）：ネットワーク名 +* `adRevenueNetwork` （ **String** ）：ネットワーク名 ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -143,17 +145,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 広告収益ユニット - + ```cpp void AdjustAdRevenue2dx::setAdRevenueUnit(std::string adRevenueUnit); ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （ **String** ）：広告ユニット +* `adRevenueUnit` （ **String** ）：広告ユニット ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -163,17 +165,17 @@ Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ### 広告収益の配置 - + ```cpp void AdjustAdRevenue2dx::setAdRevenuePlacement(std::string adRevenuePlacement); ``` - + 広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： -- `adRevenuePlacement` （ **String** ）：広告の配置 +* `adRevenuePlacement` （ **String** ）：広告の配置 ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -181,46 +183,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## コールバックパラメーターを追加する +コールバックパラメーターを追加する +----------------- - + ```cpp void AdjustAdRevenue2dx::addCallbackParameter(std::string key, std::string value); ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、 **string** key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -229,25 +227,20 @@ adjustAdRevenue.addCallbackParameter("foo", "bar"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## パートナーパラメーターの追加 +パートナーパラメーターの追加 +-------------- - + ```cpp void AdjustAdRevenue2dx::addPartnerParameter(std::string key, std::string value); ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 + - +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、 **string** key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 @@ -258,18 +251,19 @@ adjustAdRevenue.addPartnerParameter("foo", "bar"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` -## 例 +例 +--- この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` ```cpp AdjustAdRevenue2dx adjustAdRevenue = AdjustAdRevenue2dx(AdjustConfig2dx::AdjustAdRevenueSourceAppLovinMAX); @@ -282,3 +276,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust2dx::trackAdRevenueNew(adjustAdRevenue); ``` + From 993e727c58c5a6a99152727450842f5767e1f786 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:54 +0000 Subject: [PATCH 10/39] File src/content/docs/en/sdk/cordova/v4/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/cordova/v4/features/ad-revenue.mdx | 179 +++++++++--------- 1 file changed, 87 insertions(+), 92 deletions(-) diff --git a/src/content/docs/ko/sdk/cordova/v4/features/ad-revenue.mdx b/src/content/docs/ko/sdk/cordova/v4/features/ad-revenue.mdx index 66af0bcf4..23ce7f863 100644 --- a/src/content/docs/ko/sdk/cordova/v4/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/cordova/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/cordova/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/cordova/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/cordova/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/ko/sdk/cordova/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - - -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- - + ```js constructor(source: string) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ------------------------------------------------------- | ----------------- | +| 파라미터 | 소스 | +|---------------------------------------------------------|-------------------| | `AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustAdRevenueSource.AdRevenueSourceMopub` | MoPub | | `AdjustAdRevenueSource.AdRevenueSourceAdMob` | Admob | @@ -46,8 +46,8 @@ Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdReve | `AdjustAdRevenueSource.AdRevenueSourceUnity` | Unity | | `AdjustAdRevenueSource.AdRevenueSourceHeliumChartboost` | Helium Chartboost | | `AdjustAdRevenueSource.AdRevenueSourceTopOn` | TopOn | -| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | -| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 일반적인 소스 | +| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | +| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 일반적인 소스 | ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -56,15 +56,16 @@ var adjustAdRevenue = new AdjustAdRevenue( Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```js trackAdRevenue(adRevenue: AdjustAdRevenue): void; ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. @@ -75,26 +76,26 @@ var adjustAdRevenue = new AdjustAdRevenue( Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```js setRevenue(revenue: number, currency: string): void ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`number`\): 매출 금액 -- `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`number`\): 매출 금액 +* `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 트래킹](https://help.adjust.com/ko/article/currency-conversion) 가이드를 참조하시기 바랍니다. - - +자세한 정보는 Adjust의 [여러 통화로 구매 트래킹](https://help.adjust.com/en/article/currency-conversion) 가이드를 참조하시기 바랍니다. + ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -104,23 +105,24 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```js setAdImpressionsCount(adImpressionsCount: number) ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`number`\): 광고 노출 횟수 +* `adImpressionsCount` \(`number`\): 광고 노출 횟수 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -130,19 +132,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```js setAdRevenueNetwork(adRevenueNetwork: string) ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`string`\): 네트워크의 이름. +* `adRevenueNetwork` \(`string`\): 네트워크의 이름. ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -152,19 +154,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```js setAdRevenueUnit(adRevenueUnit: string) ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`string`\): 광고 매출 유닛의 이름. +* `adRevenueUnit` \(`string`\): 광고 매출 유닛의 이름. ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -174,19 +176,19 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```js setAdRevenuePlacement(adRevenuePlacement: string) ``` - + 광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenuePlacement` \(`string`\): 광고 매출의 배치. +* `adRevenuePlacement` \(`string`\): 광고 매출의 배치. ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -196,46 +198,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```js addCallbackParameter(key: string, value: string): void ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. -**문자열** 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 개의 파라미터를 추가할 수 있습니다. +**문자열** 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -245,27 +243,22 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```js addPartnerParameter(key: string, value: string): void ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. + -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - - -**문자열** 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 개의 파라미터를 추가할 수 있습니다. +**문자열** 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -275,18 +268,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -301,3 +295,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 4b8332379a184ff4c918a8ceec1ae6f635acbb24 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:56 +0000 Subject: [PATCH 11/39] File src/content/docs/en/sdk/cordova/v4/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/cordova/v4/features/ad-revenue.mdx | 175 +++++++++--------- 1 file changed, 85 insertions(+), 90 deletions(-) diff --git a/src/content/docs/zh/sdk/cordova/v4/features/ad-revenue.mdx b/src/content/docs/zh/sdk/cordova/v4/features/ad-revenue.mdx index 8ac61e6c3..bee5382db 100644 --- a/src/content/docs/zh/sdk/cordova/v4/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/cordova/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/cordova/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/cordova/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/cordova/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - - -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- - + ```js constructor(source: string) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ------------------------------------------------------- | ----------------- | +| 参数 | 来源 | +|---------------------------------------------------------|-------------------| | `AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustAdRevenueSource.AdRevenueSourceMopub` | mopub | | `AdjustAdRevenueSource.AdRevenueSourceAdMob` | AdMob | @@ -46,8 +46,8 @@ constructor(source: string) | `AdjustAdRevenueSource.AdRevenueSourceUnity` | Unity | | `AdjustAdRevenueSource.AdRevenueSourceHeliumChartboost` | Helium Chartboost | | `AdjustAdRevenueSource.AdRevenueSourceTopOn` | TopOn | -| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | -| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 通用来源 | +| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | +| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 通用来源 | ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -56,15 +56,16 @@ var adjustAdRevenue = new AdjustAdRevenue( Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```js trackAdRevenue(adRevenue: AdjustAdRevenue): void; ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 @@ -75,26 +76,26 @@ var adjustAdRevenue = new AdjustAdRevenue( Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```js setRevenue(revenue: number, currency: string): void ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`number`\)：收入额 -- `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`number`\)：收入额 +* `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看我们的[跟踪不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - +欢迎查看我们的[跟踪不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -104,23 +105,24 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```js setAdImpressionsCount(adImpressionsCount: number) ``` - + 要发送广告展示量记录，请使用下列参数调用 `setAdImpressionsCount` 方法： -- `adImpressionsCount` \(`number`\)：广告展示数量。 +* `adImpressionsCount` \(`number`\)：广告展示数量。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -130,19 +132,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```js setAdRevenueNetwork(adRevenueNetwork: string) ``` - + 要发送广告收入渠道，请使用下列参数调用 `setAdRevenueNetwork` 方法： -- `adRevenueNetwork` \( `string` \)：渠道名称。 +* `adRevenueNetwork` \( `string` \)：渠道名称。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -152,19 +154,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```js setAdRevenueUnit(adRevenueUnit: string) ``` - + 要发送广告收入单位，请使用下列参数调用 `setAdRevenueUnit` 方法： -- `adRevenueUnit` \( `string` \)：广告收入单位的名称。 +* `adRevenueUnit` \( `string` \)：广告收入单位的名称。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -174,19 +176,19 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```js setAdRevenuePlacement(adRevenuePlacement: string) ``` - + 要发送广告收入位置，请使用下列参数调用 `setAdRevenuePlacement` 方法： -- `adRevenuePlacement` \( `string` \)：广告收入的位置。 +* `adRevenuePlacement` \( `string` \)：广告收入的位置。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -196,46 +198,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```js addCallbackParameter(key: string, value: string): void ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 **字符串** 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -245,25 +243,20 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```js addPartnerParameter(key: string, value: string): void ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 + -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - - -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 **字符串** 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 @@ -275,18 +268,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -301,3 +295,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From d9f29e3f1c4846eec7ef113da4f76b9e64c96364 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:44:58 +0000 Subject: [PATCH 12/39] File src/content/docs/en/sdk/cordova/v4/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/cordova/v4/features/ad-revenue.mdx | 179 +++++++++--------- 1 file changed, 87 insertions(+), 92 deletions(-) diff --git a/src/content/docs/ja/sdk/cordova/v4/features/ad-revenue.mdx b/src/content/docs/ja/sdk/cordova/v4/features/ad-revenue.mdx index 9cbdd8cac..17be02a0c 100644 --- a/src/content/docs/ja/sdk/cordova/v4/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/cordova/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/cordova/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/cordova/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/cordova/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/cordova/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```js constructor(source: string) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ------------------------------------------------------- | ----------------- | +| パラメーター | ソース | +|---------------------------------------------------------|-------------------| | `AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustAdRevenueSource.AdRevenueSourceMopub` | MoPub | | `AdjustAdRevenueSource.AdRevenueSourceAdMob` | AdMob | @@ -46,8 +46,8 @@ Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブ | `AdjustAdRevenueSource.AdRevenueSourceUnity` | Unity | | `AdjustAdRevenueSource.AdRevenueSourceHeliumChartboost` | Helium Chartboost | | `AdjustAdRevenueSource.AdRevenueSourceTopOn` | TopOn | -| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | -| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 汎用ソース | +| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | +| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 汎用ソース | ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -56,15 +56,16 @@ var adjustAdRevenue = new AdjustAdRevenue( Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```js trackAdRevenue(adRevenue: AdjustAdRevenue): void; ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 @@ -75,26 +76,26 @@ var adjustAdRevenue = new AdjustAdRevenue( Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```js setRevenue(revenue: number, currency: string): void ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `number`）：収益額 -- `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `number`）：収益額 +* `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入計測](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - +詳細は、[異なる通貨での購入計測](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -104,23 +105,24 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```js setAdImpressionsCount(adImpressionsCount: number) ``` - + 記録された広告インプレッションを送信するには、以下の引数で`setAdImpressionsCount`メソッドを呼び出します： -- `adImpressionsCount` （`number`）：広告インプレッションの数。 +* `adImpressionsCount` （`number`）：広告インプレッションの数。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -130,19 +132,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```js setAdRevenueNetwork(adRevenueNetwork: string) ``` - + 広告収益ネットワークを送信するには、以下の引数で`setAdRevenueNetwork`メソッドを呼び出します： -- `adRevenueNetwork` \( `string` \)：ネットワークの名前。 +* `adRevenueNetwork` \( `string` \)：ネットワークの名前。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -152,19 +154,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```js setAdRevenueUnit(adRevenueUnit: string) ``` - + 広告収益ユニットを送信するには、以下の引数で`setAdRevenueUnit`メソッドを呼び出します： -- `adRevenueUnit` \( `string` \)：広告収益ユニットの名前。 +* `adRevenueUnit` \( `string` \)：広告収益ユニットの名前。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -174,19 +176,19 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```js setAdRevenuePlacement(adRevenuePlacement: string) ``` - + -広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： +広告収益プレースメントを送信するには、次の引数を指定して`setAdRevenuePlacement`を呼び出してください。 -- `adRevenuePlacement` \( `string` \)：広告収益の配置。 +* `adRevenuePlacement` \( `string` \)：広告収益の配置。 ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -196,46 +198,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```js addCallbackParameter(key: string, value: string): void ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、 **string** key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -245,25 +243,20 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```js addPartnerParameter(key: string, value: string): void ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 + -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - - -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、 **string** key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 @@ -275,18 +268,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` ```js var adjustAdRevenue = new AdjustAdRevenue( @@ -301,3 +295,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 6f2052f81be9111f860e0e1cecb65759789c5fe0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:01 +0000 Subject: [PATCH 13/39] File src/content/docs/en/sdk/cordova/v5/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/cordova/v5/features/ad-revenue.mdx | 283 +++++++++--------- 1 file changed, 136 insertions(+), 147 deletions(-) diff --git a/src/content/docs/ko/sdk/cordova/v5/features/ad-revenue.mdx b/src/content/docs/ko/sdk/cordova/v5/features/ad-revenue.mdx index 8cb3b21ab..a57b2ff59 100644 --- a/src/content/docs/ko/sdk/cordova/v5/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/cordova/v5/features/ad-revenue.mdx @@ -1,297 +1,285 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/cordova/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/cordova/v4/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/cordova/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/cordova/v4/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - - -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- - + -```js +```ts constructor(source: string) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 - -| 파라미터 | 소스 | -| ------------------------------------------------------- | ----------------- | -| `AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX` | AppLovin MAX | -| `AdjustAdRevenueSource.AdRevenueSourceMopub` | MoPub | -| `AdjustAdRevenueSource.AdRevenueSourceAdMob` | Admob | -| `AdjustAdRevenueSource.AdRevenueSourceIronSource` | ironSource | -| `AdjustAdRevenueSource.AdRevenueSourceAdmost` | Admost | -| `AdjustAdRevenueSource.AdRevenueSourceUnity` | Unity | -| `AdjustAdRevenueSource.AdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustAdRevenueSource.AdRevenueSourceTopOn` | TopOn | -| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | -| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 일반적인 소스 | +* `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 + +| 파라미터 | 소스 | +|---------------------------|-------------------| +| `"applovin_max_sdk"` | AppLovin MAX | +| `"admob_sdk"` | Admob | +| `"ironsource_sdk"` | ironSource | +| `"admost_sdk"` | Admost | +| `"unity_sdk"` | Unity | +| `"helium_chartboost_sdk"` | Helium Chartboost | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 일반적인 소스 | +| `"tradplus_sdk"` | TradPlus | +| `"topon_sdk"` | TopOn | ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + -```js -trackAdRevenue(adRevenue: AdjustAdRevenue): void; +```ts +trackAdRevenue(adjustAdRevenue: AdjustAdRevenue): void ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + -```js +```ts setRevenue(revenue: number, currency: string): void ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`number`\): 매출 금액 -- `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`number`\): 매출 금액 +* `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 트래킹](https://help.adjust.com/ko/article/currency-conversion) 가이드를 참조하시기 바랍니다. - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setRevenue(1.0, "EUR"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + -```js -setAdImpressionsCount(adImpressionsCount: number) +```ts +setAdImpressionsCount(adImpressionsCount: number): void ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`number`\): 광고 노출 횟수 +* `adImpressionsCount` \(`number`\): 광고 노출 횟수 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdImpressionsCount(10); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + -```js -setAdRevenueNetwork(adRevenueNetwork: string) +```ts +setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`string`\): 네트워크의 이름. +* `adRevenueNetwork` \(`string`\): 네트워크 이름 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenueNetwork("network1"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + -```js -setAdRevenueUnit(adRevenueUnit: string) +```ts +setAdRevenueUnit(adRevenueUnit: string): void ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`string`\): 광고 매출 유닛의 이름. +* `adRevenueUnit` \(`string`\): 광고 단위 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenueUnit("unit1"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + -```js -setAdRevenuePlacement(adRevenuePlacement: string) +```ts +setAdRevenuePlacement(adRevenuePlacement: string): void ``` - - -광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. + -- `adRevenuePlacement` \(`string`\): 광고 매출의 배치. +`string` 값을 `setAdRevenuePlacement` 메서드에 전달하면 광고의 게재 위치를 기록할 수 있습니다. ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenuePlacement("banner"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. -**문자열** 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 개의 파라미터를 추가할 수 있습니다. +`string` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.addCallbackParameter("key", "value"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + -```js +```ts addPartnerParameter(key: string, value: string): void ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. + - +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. - - -**문자열** 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 개의 파라미터를 추가할 수 있습니다. +`string` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.addPartnerParameter("key", "value"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); adjustAdRevenue.setRevenue(1.0, "EUR"); adjustAdRevenue.setAdImpressionsCount(10); adjustAdRevenue.setAdRevenueNetwork("network1"); @@ -301,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From c453e95b54b87ccfc35ccf8fb2a60aeb228080cd Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:04 +0000 Subject: [PATCH 14/39] File src/content/docs/en/sdk/cordova/v5/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/cordova/v5/features/ad-revenue.mdx | 289 +++++++++--------- 1 file changed, 139 insertions(+), 150 deletions(-) diff --git a/src/content/docs/zh/sdk/cordova/v5/features/ad-revenue.mdx b/src/content/docs/zh/sdk/cordova/v5/features/ad-revenue.mdx index 44c7fe909..2ed943af6 100644 --- a/src/content/docs/zh/sdk/cordova/v5/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/cordova/v5/features/ad-revenue.mdx @@ -1,297 +1,285 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/cordova/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/cordova/v4/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/cordova/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - - -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- - + -```js +```ts constructor(source: string) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 - -| 参数 | 来源 | -| ------------------------------------------------------- | ----------------- | -| `AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX` | AppLovin MAX | -| `AdjustAdRevenueSource.AdRevenueSourceMopub` | mopub | -| `AdjustAdRevenueSource.AdRevenueSourceAdMob` | AdMob | -| `AdjustAdRevenueSource.AdRevenueSourceIronSource` | IronSource | -| `AdjustAdRevenueSource.AdRevenueSourceAdmost` | Admost | -| `AdjustAdRevenueSource.AdRevenueSourceUnity` | Unity | -| `AdjustAdRevenueSource.AdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustAdRevenueSource.AdRevenueSourceTopOn` | TopOn | -| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | -| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 通用来源 | +* `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 + +| 参数 | 来源 | +|---------------------------|-------------------| +| `"applovin_max_sdk"` | AppLovin MAX | +| `"admob_sdk"` | AdMob | +| `"ironsource_sdk"` | IronSource | +| `"admost_sdk"` | Admost | +| `"unity_sdk"` | Unity | +| `"helium_chartboost_sdk"` | Helium Chartboost | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 通用来源 | +| `"tradplus_sdk"` | TradPlus | +| `"topon_sdk"` | TopOn | ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + -```js -trackAdRevenue(adRevenue: AdjustAdRevenue): void; +```ts +trackAdRevenue(adjustAdRevenue: AdjustAdRevenue): void ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + -```js +```ts setRevenue(revenue: number, currency: string): void ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`number`\)：收入额 -- `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`number`\)：收入额 +* `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看我们的[跟踪不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setRevenue(1.0, "EUR"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + -```js -setAdImpressionsCount(adImpressionsCount: number) +```ts +setAdImpressionsCount(adImpressionsCount: number): void ``` - + -要发送广告展示量记录，请使用下列参数调用 `setAdImpressionsCount` 方法： +要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`number`\)：广告展示数量。 +* `adImpressionsCount` \(`number`\)：广告展示数量。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdImpressionsCount(10); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + -```js -setAdRevenueNetwork(adRevenueNetwork: string) +```ts +setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + -要发送广告收入渠道，请使用下列参数调用 `setAdRevenueNetwork` 方法： +要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \( `string` \)：渠道名称。 +* `adRevenueNetwork` \(`string`\)：渠道名称 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenueNetwork("network1"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + -```js -setAdRevenueUnit(adRevenueUnit: string) +```ts +setAdRevenueUnit(adRevenueUnit: string): void ``` - + -要发送广告收入单位，请使用下列参数调用 `setAdRevenueUnit` 方法： +要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \( `string` \)：广告收入单位的名称。 +* `adRevenueUnit` \(`string`\)：广告单位 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenueUnit("unit1"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + -```js -setAdRevenuePlacement(adRevenuePlacement: string) +```ts +setAdRevenuePlacement(adRevenuePlacement: string): void ``` - - -要发送广告收入位置，请使用下列参数调用 `setAdRevenuePlacement` 方法： + -- `adRevenuePlacement` \( `string` \)：广告收入的位置。 +通过传递一个`string` 值至 `setAdRevenuePlacement` 方法来记录广告位。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenuePlacement("banner"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 -使用 **字符串** 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 +使用 `string` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.addCallbackParameter("key", "value"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + -```js +```ts addPartnerParameter(key: string, value: string): void ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 + - +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 - - -使用 **字符串** 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 +使用 `string` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.addPartnerParameter("key", "value"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); adjustAdRevenue.setRevenue(1.0, "EUR"); adjustAdRevenue.setAdImpressionsCount(10); adjustAdRevenue.setAdRevenueNetwork("network1"); @@ -301,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From ed1628b69e497f04dcad70ddd95b0570df469017 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:06 +0000 Subject: [PATCH 15/39] File src/content/docs/en/sdk/cordova/v5/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/cordova/v5/features/ad-revenue.mdx | 291 +++++++++--------- 1 file changed, 140 insertions(+), 151 deletions(-) diff --git a/src/content/docs/ja/sdk/cordova/v5/features/ad-revenue.mdx b/src/content/docs/ja/sdk/cordova/v5/features/ad-revenue.mdx index 6346aad77..934adc1f2 100644 --- a/src/content/docs/ja/sdk/cordova/v5/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/cordova/v5/features/ad-revenue.mdx @@ -1,297 +1,285 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/cordova/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/cordova/v4/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/cordova/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/cordova/v4/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - - -```js +```ts constructor(source: string) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 - -| パラメーター | ソース | -| ------------------------------------------------------- | ----------------- | -| `AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX` | AppLovin MAX | -| `AdjustAdRevenueSource.AdRevenueSourceMopub` | MoPub | -| `AdjustAdRevenueSource.AdRevenueSourceAdMob` | AdMob | -| `AdjustAdRevenueSource.AdRevenueSourceIronSource` | ironSource | -| `AdjustAdRevenueSource.AdRevenueSourceAdmost` | Admost | -| `AdjustAdRevenueSource.AdRevenueSourceUnity` | Unity | -| `AdjustAdRevenueSource.AdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustAdRevenueSource.AdRevenueSourceTopOn` | TopOn | -| `AdjustAdRevenueSource.AdRevenueSourceAdx` | Ad\(X\) | -| `AdjustAdRevenueSource.AdRevenueSourcePublisher` | 汎用ソース | +* `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 + +| パラメーター | ソース | +|---------------------------|-------------------| +| `"applovin_max_sdk"` | AppLovin MAX | +| `"admob_sdk"` | AdMob | +| `"ironsource_sdk"` | ironSource | +| `"admost_sdk"` | Admost | +| `"unity_sdk"` | Unity | +| `"helium_chartboost_sdk"` | Helium Chartboost | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 汎用ソース | +| `"tradplus_sdk"` | TradPlus | +| `"topon_sdk"` | TopOn | ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + -```js -trackAdRevenue(adRevenue: AdjustAdRevenue): void; +```ts +trackAdRevenue(adjustAdRevenue: AdjustAdRevenue): void ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + -```js +```ts setRevenue(revenue: number, currency: string): void ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `number`）：収益額 -- `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `number`）：収益額 +* `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入計測](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setRevenue(1.0, "EUR"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + -```js -setAdImpressionsCount(adImpressionsCount: number) +```ts +setAdImpressionsCount(adImpressionsCount: number): void ``` - + -記録された広告インプレッションを送信するには、以下の引数で`setAdImpressionsCount`メソッドを呼び出します： +記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`number`）：広告インプレッションの数。 +* `adImpressionsCount` （`number`）：広告インプレッションの数。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdImpressionsCount(10); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + -```js -setAdRevenueNetwork(adRevenueNetwork: string) +```ts +setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + -広告収益ネットワークを送信するには、以下の引数で`setAdRevenueNetwork`メソッドを呼び出します： +広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` \( `string` \)：ネットワークの名前。 +* `adRevenueNetwork` （`string`）：ネットワーク名 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenueNetwork("network1"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + -```js -setAdRevenueUnit(adRevenueUnit: string) +```ts +setAdRevenueUnit(adRevenueUnit: string): void ``` - + -広告収益ユニットを送信するには、以下の引数で`setAdRevenueUnit`メソッドを呼び出します： +広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` \( `string` \)：広告収益ユニットの名前。 +* `adRevenueUnit` （`string`）：広告ユニット ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenueUnit("unit1"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + -```js -setAdRevenuePlacement(adRevenuePlacement: string) +```ts +setAdRevenuePlacement(adRevenuePlacement: string): void ``` - - -広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： + -- `adRevenuePlacement` \( `string` \)：広告収益の配置。 +`setAdRevenuePlacement`メソッドに`string`値をパスすることで、広告の配置先を記録します。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.setAdRevenuePlacement("banner"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + -```js +```ts addCallbackParameter(key: string, value: string): void ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 -イベントにコールバックパラメーターを追加するには、 **string** key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 +イベントにコールバックパラメーターを追加するには、`string` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.addCallbackParameter("key", "value"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + -```js +```ts addPartnerParameter(key: string, value: string): void ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 + - +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 - - -イベントにパートナーパラメーターを追加するには、 **string** key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 +イベントにパートナーパラメーターを追加するには、`string` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("source"); + adjustAdRevenue.addPartnerParameter("key", "value"); + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` ```js -var adjustAdRevenue = new AdjustAdRevenue( - AdjustAdRevenueSource.AdRevenueSourceAppLovinMAX, -); +var adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); adjustAdRevenue.setRevenue(1.0, "EUR"); adjustAdRevenue.setAdImpressionsCount(10); adjustAdRevenue.setAdRevenueNetwork("network1"); @@ -301,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From aba101c467e9510af7e3e141e46cbf1c706bfe7d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:09 +0000 Subject: [PATCH 16/39] File src/content/docs/en/sdk/flutter/v4/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/flutter/v4/features/ad-revenue.mdx | 165 +++++++++--------- 1 file changed, 80 insertions(+), 85 deletions(-) diff --git a/src/content/docs/ko/sdk/flutter/v4/features/ad-revenue.mdx b/src/content/docs/ko/sdk/flutter/v4/features/ad-revenue.mdx index a2a831507..a60b964fe 100644 --- a/src/content/docs/ko/sdk/flutter/v4/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/flutter/v4/features/ad-revenue.mdx @@ -1,28 +1,28 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/flutter/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/flutter/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/flutter/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/ko/sdk/flutter/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - - -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} +AdjustAdRevenue 객체 인스턴스화 +------------------------ - + ```dart AdjustAdRevenue(this._source) { @@ -32,16 +32,16 @@ AdjustAdRevenue(this._source) { ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ---------------------------------------------- | ----------------- | +| 파라미터 | 소스 | +|------------------------------------------------|-------------------| | `AdjustConfig.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdRevenueSourceMopub` | MoPub | | `AdjustConfig.AdRevenueSourceAdMob` | Admob | @@ -51,16 +51,17 @@ Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdReve | `AdjustConfig.AdRevenueSourceHeliumChartboost` | Helium Chartboost | | `AdjustConfig.AdRevenueSourceTradPlus` | TradPlus | | `AdjustConfig.AdRevenueSourceTopOn` | TopOn | -| `AdjustConfig.AdRevenueSourcePublisher` | 일반적인 소스 | +| `AdjustConfig.AdRevenueSourcePublisher` | 일반적인 소스 | ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```dart static void trackAdRevenue(String source, String payload) { @@ -70,7 +71,7 @@ static void trackAdRevenue(String source, String payload) { ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. @@ -79,9 +80,10 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```dart void setRevenue(num revenue, String currency) { @@ -91,18 +93,17 @@ void setRevenue(num revenue, String currency) { ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`num`\): 매출 금액 -- `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`num`\): 매출 금액 +* `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -110,19 +111,20 @@ adjustAdRevenue.setRevenue(1.00, 'EUR'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```dart num? adImpressionsCount ``` - + 기록된 광고 노출 횟수를 전송하려면 광고 매출 인스턴스의 `adImpressionsCount` 속성에 `num` 값을 할당합니다. @@ -132,15 +134,15 @@ adjustAdRevenue.adImpressionsCount = 10; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```dart String? adRevenueNetwork ``` - + 광고 매출 네트워크를 전송하려면 광고 매출 인스턴스의 `adRevenueNetwork` 속성에 `String` 값으로 네트워크 이름을 할당합니다. @@ -150,15 +152,15 @@ adjustAdRevenue.adRevenueNetwork = 'network1'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```dart String? adRevenueUnit ``` - + 광고 매출 게재 단위를 전송하려면 광고 매출 인스턴스의 `adRevenueUnit` 속성에 `String` 값으로 단위를 할당합니다. @@ -168,15 +170,15 @@ adjustAdRevenue.adRevenueUnit = 'unit1'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```dart String? adRevenuePlacement ``` - + 광고 매출 게재 위치를 전송하려면 광고 매출 인스턴스의 `adRevenuePlacement` 속성에 `String` 값으로 게재 위치를 할당합니다. @@ -186,9 +188,10 @@ adjustAdRevenue.adRevenuePlacement = 'banner'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```dart void addCallbackParameter(String key, String value) { @@ -197,38 +200,33 @@ void addCallbackParameter(String key, String value) { ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `String` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -236,9 +234,10 @@ adjustAdRevenue.addCallbackParameter('key', 'value') Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```dart void addPartnerParameter(String key, String value) { @@ -247,17 +246,11 @@ void addPartnerParameter(String key, String value) { ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. + -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - - -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `String` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. @@ -267,18 +260,19 @@ adjustAdRevenue.addPartnerParameter('key', 'value'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`'network1'`_ -- 광고 매출 단위: _`'unit1'`_ -- 광고 매출 게재 위치: _`'banner'`_ -- 콜백 파라미터: `'key1' = 'value1'` -- 파트너 파라미터: `'key2' = 'value2'` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`'network1'`* +* 광고 매출 단위: *`'unit1'`* +* 광고 매출 게재 위치: *`'banner'`* +* 콜백 파라미터: `'key1' = 'value1'` +* 파트너 파라미터: `'key2' = 'value2'` ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdRevenueSourceAppLovinMAX); @@ -291,3 +285,4 @@ adjustAdRevenue.addCallbackParameter('key1', 'value1'); adjustAdRevenue.addPartnerParameter('key2', 'value2'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` + From c05387dd06d2f906c24dc53057ca672c11ff0ce1 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:12 +0000 Subject: [PATCH 17/39] File src/content/docs/en/sdk/flutter/v4/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/flutter/v4/features/ad-revenue.mdx | 165 +++++++++--------- 1 file changed, 80 insertions(+), 85 deletions(-) diff --git a/src/content/docs/zh/sdk/flutter/v4/features/ad-revenue.mdx b/src/content/docs/zh/sdk/flutter/v4/features/ad-revenue.mdx index 543c5eeb3..60baa9481 100644 --- a/src/content/docs/zh/sdk/flutter/v4/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/flutter/v4/features/ad-revenue.mdx @@ -1,28 +1,28 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/flutter/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/flutter/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/flutter/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - - -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- - + ```dart AdjustAdRevenue(this._source) { @@ -32,16 +32,16 @@ AdjustAdRevenue(this._source) { ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ---------------------------------------------- | ----------------- | +| 参数 | 来源 | +|------------------------------------------------|-------------------| | `AdjustConfig.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdRevenueSourceMopub` | mopub | | `AdjustConfig.AdRevenueSourceAdMob` | AdMob | @@ -51,16 +51,17 @@ AdjustAdRevenue(this._source) { | `AdjustConfig.AdRevenueSourceHeliumChartboost` | Helium Chartboost | | `AdjustConfig.AdRevenueSourceTradPlus` | TradPlus | | `AdjustConfig.AdRevenueSourceTopOn` | TopOn | -| `AdjustConfig.AdRevenueSourcePublisher` | 通用来源 | +| `AdjustConfig.AdRevenueSourcePublisher` | 通用来源 | ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```dart static void trackAdRevenue(String source, String payload) { @@ -70,7 +71,7 @@ static void trackAdRevenue(String source, String payload) { ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 @@ -79,9 +80,10 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```dart void setRevenue(num revenue, String currency) { @@ -91,18 +93,17 @@ void setRevenue(num revenue, String currency) { ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`num`\)：收入额 -- `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`num`\)：收入额 +* `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -110,19 +111,20 @@ adjustAdRevenue.setRevenue(1.00, 'EUR'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```dart num? adImpressionsCount ``` - + 要发送广告展示数量记录，请为广告收入实例 `adImpressionsCount` 属性指定 `num` 值。 @@ -132,15 +134,15 @@ adjustAdRevenue.adImpressionsCount = 10; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```dart String? adRevenueNetwork ``` - + 要发送广告收入渠道，请在广告收入实例 `adRevenueNetwork` 属性上将渠道名称指定 `String` 值。 @@ -150,15 +152,15 @@ adjustAdRevenue.adRevenueNetwork = 'network1'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```dart String? adRevenueUnit ``` - + 要发送广告收入单位，请在广告收入实例 `adRevenueUnit` 属性上将单位指定为 `String` 值。 @@ -168,15 +170,15 @@ adjustAdRevenue.adRevenueUnit = 'unit1'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```dart String? adRevenuePlacement ``` - + 要发送广告收入位置，请在广告收入实例 `adRevenuePlacement` 属性上将位置指定为 `String` 值。 @@ -186,9 +188,10 @@ adjustAdRevenue.adRevenuePlacement = 'banner'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```dart void addCallbackParameter(String key, String value) { @@ -197,38 +200,33 @@ void addCallbackParameter(String key, String value) { ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `String` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -236,9 +234,10 @@ adjustAdRevenue.addCallbackParameter('key', 'value') Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```dart void addPartnerParameter(String key, String value) { @@ -247,17 +246,11 @@ void addPartnerParameter(String key, String value) { ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 + -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - - -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `String` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 @@ -267,18 +260,19 @@ adjustAdRevenue.addPartnerParameter('key', 'value'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`'network1'`_ 为广告收入渠道 -- _`'unit1'`_ 为广告收入单位 -- _`'banner'`_ 为广告收入位置 -- 回传参数： `'key1' = 'value1'` -- 合作伙伴参数： `'key2' = 'value2'` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`'network1'`* 为广告收入渠道 +* *`'unit1'`* 为广告收入单位 +* *`'banner'`* 为广告收入位置 +* 回传参数： `'key1' = 'value1'` +* 合作伙伴参数： `'key2' = 'value2'` ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdRevenueSourceAppLovinMAX); @@ -291,3 +285,4 @@ adjustAdRevenue.addCallbackParameter('key1', 'value1'); adjustAdRevenue.addPartnerParameter('key2', 'value2'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` + From 898469bbb0bbd34773f8fc246d8ff5abe0aef1ac Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:15 +0000 Subject: [PATCH 18/39] File src/content/docs/en/sdk/flutter/v4/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/flutter/v4/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/ja/sdk/flutter/v4/features/ad-revenue.mdx b/src/content/docs/ja/sdk/flutter/v4/features/ad-revenue.mdx index e1db0d039..b13feca2e 100644 --- a/src/content/docs/ja/sdk/flutter/v4/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/flutter/v4/features/ad-revenue.mdx @@ -1,28 +1,28 @@ --- -title: 広告収益情報を記録する -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/flutter/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/flutter/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/flutter/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/flutter/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```dart AdjustAdRevenue(this._source) { @@ -32,16 +32,16 @@ AdjustAdRevenue(this._source) { ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ---------------------------------------------- | ----------------- | +| パラメーター | ソース | +|------------------------------------------------|-------------------| | `AdjustConfig.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdRevenueSourceMopub` | MoPub | | `AdjustConfig.AdRevenueSourceAdMob` | AdMob | @@ -51,16 +51,17 @@ Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブ | `AdjustConfig.AdRevenueSourceHeliumChartboost` | Helium Chartboost | | `AdjustConfig.AdRevenueSourceTradPlus` | TradPlus | | `AdjustConfig.AdRevenueSourceTopOn` | TopOn | -| `AdjustConfig.AdRevenueSourcePublisher` | 汎用ソース | +| `AdjustConfig.AdRevenueSourcePublisher` | 汎用ソース | ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```dart static void trackAdRevenue(String source, String payload) { @@ -70,7 +71,7 @@ static void trackAdRevenue(String source, String payload) { ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 @@ -79,9 +80,10 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```dart void setRevenue(num revenue, String currency) { @@ -91,18 +93,17 @@ void setRevenue(num revenue, String currency) { ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `num`）：収益額 -- `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `num`）：収益額 +* `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -110,19 +111,20 @@ adjustAdRevenue.setRevenue(1.00, 'EUR'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```dart num? adImpressionsCount ``` - + 記録された広告インプレッション数を送信するには、広告収益インスタンスの`adImpressionsCount`プロパティに`num`値を割り当てます。 @@ -132,15 +134,15 @@ adjustAdRevenue.adImpressionsCount = 10; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```dart String? adRevenueNetwork ``` - + 広告収益ネットワークを送信するには、広告収益インスタンスの`adRevenueNetwork`プロパティにネットワーク名を`String`値として割り当てます。 @@ -150,15 +152,15 @@ adjustAdRevenue.adRevenueNetwork = 'network1'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```dart String? adRevenueUnit ``` - + 広告収益ユニットを送信するには、広告収益インスタンスの`adRevenueUnit`プロパティにユニットを`String`値として割り当てます。 @@ -168,15 +170,15 @@ adjustAdRevenue.adRevenueUnit = 'unit1'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```dart String? adRevenuePlacement ``` - + 広告収益の配置を送信するには、広告収益インスタンスの`adRevenuePlacement`プロパティに配置を`String`値として割り当てます。 @@ -186,9 +188,10 @@ adjustAdRevenue.adRevenuePlacement = 'banner'; Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```dart void addCallbackParameter(String key, String value) { @@ -197,38 +200,33 @@ void addCallbackParameter(String key, String value) { ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`String` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -236,9 +234,10 @@ adjustAdRevenue.addCallbackParameter('key', 'value') Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```dart void addPartnerParameter(String key, String value) { @@ -247,17 +246,11 @@ void addPartnerParameter(String key, String value) { ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 + -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - - -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`String` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 @@ -267,18 +260,19 @@ adjustAdRevenue.addPartnerParameter('key', 'value'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`'network1'`_ とする -- 広告収益ユニットを _`'unit1'`_ とする -- 広告収益の配置を _`'banner'`_ とする -- コールバックパラメーター： `'key1' = 'value1'` -- パートナーパラメーター： `'key2' = 'value2'` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`'network1'`* とする +* 広告収益ユニットを *`'unit1'`* とする +* 広告収益の配置を *`'banner'`* とする +* コールバックパラメーター： `'key1' = 'value1'` +* パートナーパラメーター： `'key2' = 'value2'` ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdRevenueSourceAppLovinMAX); @@ -291,3 +285,4 @@ adjustAdRevenue.addCallbackParameter('key1', 'value1'); adjustAdRevenue.addPartnerParameter('key2', 'value2'); Adjust.trackAdRevenueNew(adjustAdRevenue); ``` + From 25ded17f7fc9eee849c51deb6a29b3878d9f7188 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:18 +0000 Subject: [PATCH 19/39] File src/content/docs/en/sdk/flutter/v5/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/flutter/v5/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/ko/sdk/flutter/v5/features/ad-revenue.mdx b/src/content/docs/ko/sdk/flutter/v5/features/ad-revenue.mdx index 10f758f38..6966f5c05 100644 --- a/src/content/docs/ko/sdk/flutter/v5/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/flutter/v5/features/ad-revenue.mdx @@ -1,52 +1,52 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/flutter/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/flutter/v4/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/flutter/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/flutter/v4/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - - -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- - + ```dart AdjustAdRevenue(String source) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`String`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ------------------------- | ----------------- | +| 파라미터 | 소스 | +|---------------------------|-------------------| | `'applovin_max_sdk'` | AppLovin MAX | | `'admob_sdk'` | Admob | | `'ironsource_sdk'` | ironSource | | `'admost_sdk'` | Admost | | `'unity_sdk'` | Unity | | `'helium_chartboost_sdk'` | Helium Chartboost | -| `'adx_sdk'` | Ad\(X\) | -| `'publisher_sdk'` | 일반적인 소스 | +| `'adx_sdk'` | Ad\(X\) | +| `'publisher_sdk'` | 일반적인 소스 | | `'tradplus_sdk'` | TradPlus | | `'topon_sdk'` | TopOn | @@ -55,15 +55,16 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 전송 {#send-ad-revenue} +S2S 광고 매출 전송 \{\#send\-ad\-revenue\} +----------------------------------------- - + ```dart static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. @@ -72,27 +73,27 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```dart void setRevenue(num revenue, String currency) ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`num`\): 매출 금액 -- `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`num`\): 매출 금액 +* `currency` \(`String`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -100,19 +101,20 @@ adjustAdRevenue.setRevenue(1.00, 'EUR'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```dart num? adImpressionsCount ``` - + 기록된 광고 노출 횟수를 전송하려면 광고 매출 인스턴스의 `adImpressionsCount` 속성에 `num` 값을 할당합니다. @@ -122,15 +124,15 @@ adjustAdRevenue.adImpressionsCount = 10; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```dart String? adRevenueNetwork ``` - + 광고 매출 네트워크를 전송하려면 광고 매출 인스턴스의 `adRevenueNetwork` 속성에 `String` 값으로 네트워크 이름을 할당합니다. @@ -140,15 +142,15 @@ adjustAdRevenue.adRevenueNetwork = 'network1'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```dart String? adRevenueUnit ``` - + 광고 매출 게재 단위를 전송하려면 광고 매출 인스턴스의 `adRevenueUnit` 속성에 `String` 값으로 단위를 할당합니다. @@ -158,15 +160,15 @@ adjustAdRevenue.adRevenueUnit = 'unit1'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```dart String? adRevenuePlacement ``` - + 광고 매출 게재 위치를 전송하려면 광고 매출 인스턴스의 `adRevenuePlacement` 속성에 `String` 값으로 게재 위치를 할당합니다. @@ -176,46 +178,42 @@ adjustAdRevenue.adRevenuePlacement = 'banner'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```dart void addCallbackParameter(String key, String value) ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `String` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -223,25 +221,20 @@ adjustAdRevenue.addCallbackParameter('key', 'value') Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```dart void addPartnerParameter(String key, String value) ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. + -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - - -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `String` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. @@ -251,18 +244,19 @@ adjustAdRevenue.addPartnerParameter('key', 'value'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`'network1'`_ -- 광고 매출 단위: _`'unit1'`_ -- 광고 매출 게재 위치: _`'banner'`_ -- 콜백 파라미터: `'key1' = 'value1'` -- 파트너 파라미터: `'key2' = 'value2'` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`'network1'`* +* 광고 매출 단위: *`'unit1'`* +* 광고 매출 게재 위치: *`'banner'`* +* 콜백 파라미터: `'key1' = 'value1'` +* 파트너 파라미터: `'key2' = 'value2'` ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('applovin_max_sdk'); @@ -275,3 +269,4 @@ adjustAdRevenue.addCallbackParameter('key1', 'value1'); adjustAdRevenue.addPartnerParameter('key2', 'value2'); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 20af208779ce9bcef06f51052075083a8b516703 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:23 +0000 Subject: [PATCH 20/39] File src/content/docs/en/sdk/flutter/v5/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/flutter/v5/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/zh/sdk/flutter/v5/features/ad-revenue.mdx b/src/content/docs/zh/sdk/flutter/v5/features/ad-revenue.mdx index 97be8ebe1..8da84854d 100644 --- a/src/content/docs/zh/sdk/flutter/v5/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/flutter/v5/features/ad-revenue.mdx @@ -1,52 +1,52 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/flutter/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/flutter/v4/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/flutter/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/flutter/v4/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - - -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- - + ```dart AdjustAdRevenue(String source) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`String`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ------------------------- | ----------------- | +| 参数 | 来源 | +|---------------------------|-------------------| | `'applovin_max_sdk'` | AppLovin MAX | | `'admob_sdk'` | AdMob | | `'ironsource_sdk'` | IronSource | | `'admost_sdk'` | Admost | | `'unity_sdk'` | Unity | | `'helium_chartboost_sdk'` | Helium Chartboost | -| `'adx_sdk'` | Ad\(X\) | -| `'publisher_sdk'` | 通用来源 | +| `'adx_sdk'` | Ad\(X\) | +| `'publisher_sdk'` | 通用来源 | | `'tradplus_sdk'` | TradPlus | | `'topon_sdk'` | TopOn | @@ -55,15 +55,16 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```dart static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 @@ -72,27 +73,27 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```dart void setRevenue(num revenue, String currency) ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`num`\)：收入额 -- `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`num`\)：收入额 +* `currency` \(`String`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -100,19 +101,20 @@ adjustAdRevenue.setRevenue(1.00, 'EUR'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```dart num? adImpressionsCount ``` - + 要发送广告展示数量记录，请为广告收入实例 `adImpressionsCount` 属性指定 `num` 值。 @@ -122,15 +124,15 @@ adjustAdRevenue.adImpressionsCount = 10; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```dart String? adRevenueNetwork ``` - + 要发送广告收入渠道，请在广告收入实例 `adRevenueNetwork` 属性上将渠道名称指定 `String` 值。 @@ -140,15 +142,15 @@ adjustAdRevenue.adRevenueNetwork = 'network1'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```dart String? adRevenueUnit ``` - + 要发送广告收入单位，请在广告收入实例 `adRevenueUnit` 属性上将单位指定为 `String` 值。 @@ -158,15 +160,15 @@ adjustAdRevenue.adRevenueUnit = 'unit1'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```dart String? adRevenuePlacement ``` - + 要发送广告收入位置，请在广告收入实例 `adRevenuePlacement` 属性上将位置指定为 `String` 值。 @@ -176,46 +178,42 @@ adjustAdRevenue.adRevenuePlacement = 'banner'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```dart void addCallbackParameter(String key, String value) ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `String` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -223,25 +221,20 @@ adjustAdRevenue.addCallbackParameter('key', 'value') Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```dart void addPartnerParameter(String key, String value) ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 + -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - - -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `String` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 @@ -251,18 +244,19 @@ adjustAdRevenue.addPartnerParameter('key', 'value'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`'network1'`_ 为广告收入渠道 -- _`'unit1'`_ 为广告收入单位 -- _`'banner'`_ 为广告收入位置 -- 回传参数： `'key1' = 'value1'` -- 合作伙伴参数： `'key2' = 'value2'` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`'network1'`* 为广告收入渠道 +* *`'unit1'`* 为广告收入单位 +* *`'banner'`* 为广告收入位置 +* 回传参数： `'key1' = 'value1'` +* 合作伙伴参数： `'key2' = 'value2'` ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('applovin_max_sdk'); @@ -275,3 +269,4 @@ adjustAdRevenue.addCallbackParameter('key1', 'value1'); adjustAdRevenue.addPartnerParameter('key2', 'value2'); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From d7b17dd1d2ae4400dc0d8ac2960d655e0e345b4d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:26 +0000 Subject: [PATCH 21/39] File src/content/docs/en/sdk/flutter/v5/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/flutter/v5/features/ad-revenue.mdx | 169 +++++++++--------- 1 file changed, 82 insertions(+), 87 deletions(-) diff --git a/src/content/docs/ja/sdk/flutter/v5/features/ad-revenue.mdx b/src/content/docs/ja/sdk/flutter/v5/features/ad-revenue.mdx index 090214c00..5bbf1ce9b 100644 --- a/src/content/docs/ja/sdk/flutter/v5/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/flutter/v5/features/ad-revenue.mdx @@ -1,52 +1,52 @@ --- -title: 広告収益情報を記録する -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/flutter/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/flutter/v4/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/flutter/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/flutter/v4/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```dart AdjustAdRevenue(String source) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`String`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ------------------------- | ----------------- | +| パラメーター | ソース | +|---------------------------|-------------------| | `'applovin_max_sdk'` | AppLovin MAX | | `'admob_sdk'` | AdMob | | `'ironsource_sdk'` | ironSource | | `'admost_sdk'` | Admost | | `'unity_sdk'` | Unity | | `'helium_chartboost_sdk'` | Helium Chartboost | -| `'adx_sdk'` | Ad\(X\) | -| `'publisher_sdk'` | 汎用ソース | +| `'adx_sdk'` | Ad\(X\) | +| `'publisher_sdk'` | 汎用ソース | | `'tradplus_sdk'` | TradPlus | | `'topon_sdk'` | TopOn | @@ -55,15 +55,16 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```dart static void trackAdRevenue(AdjustAdRevenue adRevenue) ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 @@ -72,27 +73,27 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```dart void setRevenue(num revenue, String currency) ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `num`）：収益額 -- `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `num`）：収益額 +* `currency` （`String`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -100,19 +101,20 @@ adjustAdRevenue.setRevenue(1.00, 'EUR'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```dart num? adImpressionsCount ``` - + 記録された広告インプレッション数を送信するには、広告収益インスタンスの`adImpressionsCount`プロパティに`num`値を割り当てます。 @@ -122,15 +124,15 @@ adjustAdRevenue.adImpressionsCount = 10; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```dart String? adRevenueNetwork ``` - + 広告収益ネットワークを送信するには、広告収益インスタンスの`adRevenueNetwork`プロパティにネットワーク名を`String`値として割り当てます。 @@ -140,15 +142,15 @@ adjustAdRevenue.adRevenueNetwork = 'network1'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```dart String? adRevenueUnit ``` - + 広告収益ユニットを送信するには、広告収益インスタンスの`adRevenueUnit`プロパティにユニットを`String`値として割り当てます。 @@ -158,15 +160,15 @@ adjustAdRevenue.adRevenueUnit = 'unit1'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```dart String? adRevenuePlacement ``` - + 広告収益の配置を送信するには、広告収益インスタンスの`adRevenuePlacement`プロパティに配置を`String`値として割り当てます。 @@ -176,46 +178,42 @@ adjustAdRevenue.adRevenuePlacement = 'banner'; Adjust.trackAdRevenue(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```dart void addCallbackParameter(String key, String value) ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`String` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('source'); @@ -223,25 +221,20 @@ adjustAdRevenue.addCallbackParameter('key', 'value') Adjust.trackAdRevenue(adjustAdRevenue); ``` -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```dart void addPartnerParameter(String key, String value) ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 + -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - - -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`String` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 @@ -251,18 +244,19 @@ adjustAdRevenue.addPartnerParameter('key', 'value'); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`'network1'`_ とする -- 広告収益ユニットを _`'unit1'`_ とする -- 広告収益の配置を _`'banner'`_ とする -- コールバックパラメーター： `'key1' = 'value1'` -- パートナーパラメーター： `'key2' = 'value2'` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`'network1'`* とする +* 広告収益ユニットを *`'unit1'`* とする +* 広告収益の配置を *`'banner'`* とする +* コールバックパラメーター： `'key1' = 'value1'` +* パートナーパラメーター： `'key2' = 'value2'` ```dart AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue('applovin_max_sdk'); @@ -275,3 +269,4 @@ adjustAdRevenue.addCallbackParameter('key1', 'value1'); adjustAdRevenue.addPartnerParameter('key2', 'value2'); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 187833b6c777af272b7ace9a3d086aceaa026f37 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:30 +0000 Subject: [PATCH 22/39] File src/content/docs/en/sdk/ios/v4/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/ios/v4/features/ad-revenue.mdx | 265 ++++++++---------- 1 file changed, 113 insertions(+), 152 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v4/features/ad-revenue.mdx b/src/content/docs/ko/sdk/ios/v4/features/ad-revenue.mdx index f17b487a4..5cdbe7b19 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/ios/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/ios/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/ios/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/ko/sdk/ios/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - +ADJAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjadrevenue\-object\} +----------------------------------------------------------------------- -## ADJAdRevenue 객체 인스턴스화 {#instantiate-an-adjadrevenue-object} - - + ```objc - (nullable id)initWithSource:(nonnull NSString *)source; ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `ADJAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `ADJAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`NSString`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`NSString`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ------------------------------------ | ----------------- | +| 파라미터 | 소스 | +|--------------------------------------|-------------------| | `ADJAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `ADJAdRevenueSourceMopub` | MoPub | | `ADJAdRevenueSourceAdMob` | Admob | @@ -45,13 +45,12 @@ Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `ADJAdRevenue | `ADJAdRevenueSourceAdmost` | Admost | | `ADJAdRevenueSourceUnity` | Unity | | `ADJAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `ADJAdRevenueSourceADX` | Ad\(X\) | +| `ADJAdRevenueSourceADX` | Ad\(X\) | | `ADJAdRevenueSourceTradplus` | TradPlus | | `ADJAdRevenueSourceTopon` | TopOn | -| `ADJAdRevenueSourcePublisher` | 일반적인 소스 | +| `ADJAdRevenueSourcePublisher` | 일반적인 소스 | - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -59,8 +58,7 @@ let adRevenue = ADJAdRevenue(source: source); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -68,31 +66,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 광고 매출 전송 {#send-ad-revenue} +S2S 광고 매출 전송 \{\#send\-ad\-revenue\} +----------------------------------------- - + ```objc + (void)trackAdRevenue:(nonnull NSString *)source payload:(nonnull NSData *)payload; ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. - - - + ```swift let adRevenue = ADJAdRevenue(source: source); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -100,31 +95,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```objc - (void)setRevenue:(double)amount currency:(nonnull NSString *)currency; ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`double`\): 매출 금액 -- `currency` \(`NSString`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`double`\): 매출 금액 +* `currency` \(`NSString`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -132,8 +124,7 @@ adRevenue.setRevenue(1.6, currency: "USD"); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -141,29 +132,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `ADJAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```objc - (void)setAdImpressionsCount:(int)adImpressionsCount; ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`int`\): 광고 노출 횟수 +* `adImpressionsCount` \(`int`\): 광고 노출 횟수 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -171,8 +161,7 @@ adRevenue?.adImpressionsCount = 1; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -180,25 +169,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```objc - (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork; ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`NSString`\): 네트워크 이름 +* `adRevenueNetwork` \(`NSString`\): 네트워크 이름 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -206,8 +193,7 @@ adRevenue?.adRevenueNetwork = "network1"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -215,25 +201,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```objc - (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit; ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`NSString`\): 광고 단위 +* `adRevenueUnit` \(`NSString`\): 광고 단위 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -241,8 +225,7 @@ adRevenue?.adRevenueUnit = "unit1"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -250,25 +233,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```objc - (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement; ``` - + 광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenuePlacement` \(`NSString`\): 광고 게재 위치 +* `adRevenuePlacement` \(`NSString`\): 광고 게재 위치 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -276,8 +257,7 @@ adRevenue?.adRevenuePlacement = "banner"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -285,51 +265,44 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `NSString` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -337,8 +310,7 @@ adRevenue.addCallbackParameter(key, value: value); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -346,33 +318,25 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. + - +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `NSString` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. - - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -380,8 +344,7 @@ adRevenue.addPartnerParameter(key, value: value); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -389,24 +352,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` - - + ```swift let adRevenue = ADJAdRevenue(source: ADJAdRevenueSourceAppLovinMAX); @@ -420,8 +382,7 @@ adRevenue.addPartnerParameter("key2", value: "value2") Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX]; @@ -435,5 +396,5 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourc [Adjust trackAdRevenue:adRevenue]; ``` - - + + From 1a2cd1d362011f4eddbcdeb22aff906b69e5be78 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:34 +0000 Subject: [PATCH 23/39] File src/content/docs/en/sdk/ios/v4/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/ios/v4/features/ad-revenue.mdx | 265 ++++++++---------- 1 file changed, 113 insertions(+), 152 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v4/features/ad-revenue.mdx b/src/content/docs/zh/sdk/ios/v4/features/ad-revenue.mdx index 46a03560c..2242c08e9 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/ios/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/ios/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/ios/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - +实例化 ADJAdRevenue 对象\{\#instantiate\-an\-adjadrevenue\-object\} +-------------------------------------------------------------------- -## 实例化 ADJAdRevenue 对象 {#instantiate-an-adjadrevenue-object} - - + ```objc - (nullable id)initWithSource:(nonnull NSString *)source; ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `ADJAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `ADJAdRevenue` 实例，并传送下列参数： -- `source` \(`NSString`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`NSString`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ------------------------------------ | ----------------- | +| 参数 | 来源 | +|--------------------------------------|-------------------| | `ADJAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `ADJAdRevenueSourceMopub` | mopub | | `ADJAdRevenueSourceAdMob` | AdMob | @@ -45,13 +45,12 @@ redirects: | `ADJAdRevenueSourceAdmost` | Admost | | `ADJAdRevenueSourceUnity` | Unity | | `ADJAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `ADJAdRevenueSourceADX` | Ad\(X\) | +| `ADJAdRevenueSourceADX` | Ad\(X\) | | `ADJAdRevenueSourceTradplus` | TradPlus | | `ADJAdRevenueSourceTopon` | TopOn | -| `ADJAdRevenueSourcePublisher` | 通用来源 | +| `ADJAdRevenueSourcePublisher` | 通用来源 | - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -59,8 +58,7 @@ let adRevenue = ADJAdRevenue(source: source); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -68,31 +66,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```objc + (void)trackAdRevenue:(nonnull NSString *)source payload:(nonnull NSData *)payload; ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 - - - + ```swift let adRevenue = ADJAdRevenue(source: source); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -100,31 +95,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```objc - (void)setRevenue:(double)amount currency:(nonnull NSString *)currency; ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`double`\)：收入额 -- `currency` \(`NSString`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`double`\)：收入额 +* `currency` \(`NSString`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -132,8 +124,7 @@ adRevenue.setRevenue(1.6, currency: "USD"); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -141,29 +132,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `ADJAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```objc - (void)setAdImpressionsCount:(int)adImpressionsCount; ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`int`\)：广告展示数量。 +* `adImpressionsCount` \(`int`\)：广告展示数量。 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -171,8 +161,7 @@ adRevenue?.adImpressionsCount = 1; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -180,25 +169,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```objc - (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork; ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \(`NSString`\)：渠道名称 +* `adRevenueNetwork` \(`NSString`\)：渠道名称 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -206,8 +193,7 @@ adRevenue?.adRevenueNetwork = "network1"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -215,25 +201,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```objc - (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit; ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \(`NSString`\)：广告单位 +* `adRevenueUnit` \(`NSString`\)：广告单位 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -241,8 +225,7 @@ adRevenue?.adRevenueUnit = "unit1"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -250,25 +233,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```objc - (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement; ``` - + 要发送广告收入位置，请调用 `setAdRevenuePlacement` 方法，并传送下列参数： -- `adRevenuePlacement` \(`NSString`\)：广告位 +* `adRevenuePlacement` \(`NSString`\)：广告位 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -276,8 +257,7 @@ adRevenue?.adRevenuePlacement = "banner"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -285,51 +265,44 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `NSString` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -337,8 +310,7 @@ adRevenue.addCallbackParameter(key, value: value); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -346,33 +318,25 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 + - +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `NSString` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 - - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -380,8 +344,7 @@ adRevenue.addPartnerParameter(key, value: value); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -389,24 +352,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` - - + ```swift let adRevenue = ADJAdRevenue(source: ADJAdRevenueSourceAppLovinMAX); @@ -420,8 +382,7 @@ adRevenue.addPartnerParameter("key2", value: "value2") Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX]; @@ -435,5 +396,5 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourc [Adjust trackAdRevenue:adRevenue]; ``` - - + + From 6e30f84e0bdb57f7169b241c52b7d0ca0499f517 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:36 +0000 Subject: [PATCH 24/39] File src/content/docs/en/sdk/ios/v4/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/ios/v4/features/ad-revenue.mdx | 267 ++++++++---------- 1 file changed, 114 insertions(+), 153 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/features/ad-revenue.mdx b/src/content/docs/ja/sdk/ios/v4/features/ad-revenue.mdx index 1dbc27ee5..7e07b66b2 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/ios/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/ios/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/ios/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +ADJAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjadrevenue\-object\} +------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## ADJAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjadrevenue-object} - - + ```objc - (nullable id)initWithSource:(nonnull NSString *)source; ``` - + Adjust SDKで広告収益情報を送信するには、`ADJAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`ADJAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`NSString`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`NSString`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ------------------------------------ | ----------------- | +| パラメーター | ソース | +|--------------------------------------|-------------------| | `ADJAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `ADJAdRevenueSourceMopub` | MoPub | | `ADJAdRevenueSourceAdMob` | AdMob | @@ -45,13 +45,12 @@ Adjust SDKで広告収益情報を送信するには、`ADJAdRevenue`オブジ | `ADJAdRevenueSourceAdmost` | Admost | | `ADJAdRevenueSourceUnity` | Unity | | `ADJAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `ADJAdRevenueSourceADX` | Ad\(X\) | +| `ADJAdRevenueSourceADX` | Ad\(X\) | | `ADJAdRevenueSourceTradplus` | TradPlus | | `ADJAdRevenueSourceTopon` | TopOn | -| `ADJAdRevenueSourcePublisher` | 汎用ソース | +| `ADJAdRevenueSourcePublisher` | 汎用ソース | - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -59,8 +58,7 @@ let adRevenue = ADJAdRevenue(source: source); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -68,31 +66,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```objc + (void)trackAdRevenue:(nonnull NSString *)source payload:(nonnull NSData *)payload; ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 - - - + ```swift let adRevenue = ADJAdRevenue(source: source); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -100,31 +95,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```objc - (void)setRevenue:(double)amount currency:(nonnull NSString *)currency; ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `double`）：収益額 -- `currency` （`NSString`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `double`）：収益額 +* `currency` （`NSString`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -132,8 +124,7 @@ adRevenue.setRevenue(1.6, currency: "USD"); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -141,29 +132,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `ADJAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```objc - (void)setAdImpressionsCount:(int)adImpressionsCount; ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`int`）：広告インプレッションの数。 +* `adImpressionsCount` （`int`）：広告インプレッションの数。 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -171,8 +161,7 @@ adRevenue?.adImpressionsCount = 1; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -180,25 +169,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```objc - (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork; ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （`NSString`）：ネットワーク名 +* `adRevenueNetwork` （`NSString`）：ネットワーク名 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -206,8 +193,7 @@ adRevenue?.adRevenueNetwork = "network1"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -215,25 +201,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```objc - (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit; ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （`NSString`）：広告ユニット +* `adRevenueUnit` （`NSString`）：広告ユニット - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -241,8 +225,7 @@ adRevenue?.adRevenueUnit = "unit1"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -250,25 +233,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```objc - (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement; ``` - + 広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： -- `adRevenuePlacement` （`NSString`）：広告配置 +* `adRevenuePlacement` （`NSString`）：広告配置 - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -276,8 +257,7 @@ adRevenue?.adRevenuePlacement = "banner"; Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -285,51 +265,44 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`NSString` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -337,8 +310,7 @@ adRevenue.addCallbackParameter(key, value: value); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -346,33 +318,25 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 + - +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`NSString` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 - - - + ```swift let adRevenue = ADJAdRevenue(source: source); @@ -380,8 +344,7 @@ adRevenue.addPartnerParameter(key, value: value); Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; @@ -389,24 +352,23 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:source]; [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` - - + ```swift let adRevenue = ADJAdRevenue(source: ADJAdRevenueSourceAppLovinMAX); @@ -420,8 +382,7 @@ adRevenue.addPartnerParameter("key2", value: "value2") Adjust.trackAdRevenue(adRevenue); ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourceAppLovinMAX]; @@ -435,5 +396,5 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] initWithSource:ADJAdRevenueSourc [Adjust trackAdRevenue:adRevenue]; ``` - - + + From 94ff79d4bf851ab14b2172bf168431f5a0b09f63 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:38 +0000 Subject: [PATCH 25/39] File src/content/docs/en/sdk/ios/v5/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/ios/v5/features/ad-revenue.mdx | 303 ++++++++---------- 1 file changed, 132 insertions(+), 171 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v5/features/ad-revenue.mdx b/src/content/docs/ko/sdk/ios/v5/features/ad-revenue.mdx index 9e4bd76a4..eed66aa9a 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/ad-revenue.mdx @@ -1,66 +1,64 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/ios/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/ios/v4/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/ios/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/ios/v4/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - +ADJAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjadrevenue\-object\} +----------------------------------------------------------------------- -## ADJAdRevenue 객체 인스턴스화 {#instantiate-an-adjadrevenue-object} - - + ```objc - (nullable id)initWithSource:(nonnull NSString *)source; ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `ADJAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `ADJAdRevenue` 인스턴스를 생성하고 다음 인수를 전달합니다. -- `source` \(`NSString`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스를 참조하세요. +* `source` \(`NSString`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스를 참조하세요. -| 인수 \(Arguments\) | 광고 매출 소스 | -| ------------------------- | ----------------- | +| 인수 \(Arguments\) | 광고 매출 소스 | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | Admob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 일반적인 소스 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 일반적인 소스 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | | `"mopub"` | MoPub | - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } //... Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -69,31 +67,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```objc + (void)trackAdRevenue:(nonnull ADJAdRevenue *)adRevenue; ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. - - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -102,40 +97,36 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```objc - (void)setRevenue:(double)amount currency:(nonnull NSString *)currency; ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`double`\): 매출 금액 -- `currency` \(`NSString`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`double`\): 매출 금액 +* `currency` \(`NSString`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.setRevenue(1.6, currency: "USD") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -144,38 +135,36 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `ADJAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```objc - (void)setAdImpressionsCount:(int)adImpressionsCount; ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`int`\): 광고 노출 횟수 +* `adImpressionsCount` \(`int`\): 광고 노출 횟수 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adImpressionsCount = 1 +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdImpressionsCount(1) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -184,34 +173,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```objc - (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork; ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`NSString`\): 네트워크 이름 +* `adRevenueNetwork` \(`NSString`\): 네트워크 이름 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenueNetwork = "network1" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -220,34 +206,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```objc - (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit; ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`NSString`\): 광고 단위 +* `adRevenueUnit` \(`NSString`\): 광고 단위 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenueUnit = "unit1" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -256,34 +239,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```objc - (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement; ``` - + 광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenuePlacement` \(`NSString`\): 광고 게재 위치 +* `adRevenuePlacement` \(`NSString`\): 광고 게재 위치 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenuePlacement = "banner" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -292,60 +272,52 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `NSString` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.addCallbackParameter(key, value: value) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -354,42 +326,33 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. + - +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `NSString` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. - - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.addPartnerParameter(key, value: value) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -398,39 +361,37 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.setRevenue(1, currency: "EUR") adRevenue.setAdImpressionsCount(10) -adRevenue?.adRevenueNetwork = "network1" -adRevenue?.adRevenueUnit = "unit1" -adRevenue?.adRevenuePlacement = "banner" +adRevenue.setAdRevenueNetwork("network1") +adRevenue.setAdRevenueUnit("unit1") +adRevenue.setAdRevenuePlacement("banner") adRevenue.addCallbackParameter("key1", value: "value1") adRevenue.addPartnerParameter("key2", value: "value2") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -440,10 +401,10 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [adRevenue setAdRevenueNetwork:@"network1"]; [adRevenue setAdRevenueUnit:@"unit1"]; [adRevenue setAdRevenuePlacement:@"banner"]; -[adRevenue addCallbackParameter:key1 value:@"value1"]; -[adRevenue addPartnerParameter:key2 value:"@value2"]; +[adRevenue addCallbackParameter:@"key1" value:@"value1"]; +[adRevenue addPartnerParameter:@"key2" value:@"value2"]; [Adjust trackAdRevenue:adRevenue]; ``` - - + + From 413e026d512c0d7674975d8b4a0da49899ff2720 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:40 +0000 Subject: [PATCH 26/39] File src/content/docs/en/sdk/ios/v5/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/ios/v5/features/ad-revenue.mdx | 303 ++++++++---------- 1 file changed, 132 insertions(+), 171 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v5/features/ad-revenue.mdx b/src/content/docs/zh/sdk/ios/v5/features/ad-revenue.mdx index 6b41dfbb8..8eb198ff2 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/ad-revenue.mdx @@ -1,66 +1,64 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/ios/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/ios/v4/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/ios/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - +实例化 ADJAdRevenue 对象\{\#instantiate\-an\-adjadrevenue\-object\} +-------------------------------------------------------------------- -## 实例化 ADJAdRevenue 对象 {#instantiate-an-adjadrevenue-object} - - + ```objc - (nullable id)initWithSource:(nonnull NSString *)source; ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `ADJAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `ADJAdRevenue` 实例，并传送下列参数： -- `source` \(`NSString`\)：广告收入来源。请查看下表，了解可用来源。 +* `source` \(`NSString`\)：广告收入来源。请查看下表，了解可用来源。 -| 参数 | 广告收入来源 | -| ------------------------- | ----------------- | +| 参数 | 广告收入来源 | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | IronSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 通用来源 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 通用来源 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | | `"mopub"` | mopub | - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } //... Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -69,31 +67,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```objc + (void)trackAdRevenue:(nonnull ADJAdRevenue *)adRevenue; ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 - - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -102,40 +97,36 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```objc - (void)setRevenue:(double)amount currency:(nonnull NSString *)currency; ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`double`\)：收入额 -- `currency` \(`NSString`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`double`\)：收入额 +* `currency` \(`NSString`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.setRevenue(1.6, currency: "USD") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -144,38 +135,36 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `ADJAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```objc - (void)setAdImpressionsCount:(int)adImpressionsCount; ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`int`\)：广告展示数量。 +* `adImpressionsCount` \(`int`\)：广告展示数量。 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adImpressionsCount = 1 +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdImpressionsCount(1) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -184,34 +173,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```objc - (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork; ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \(`NSString`\)：渠道名称 +* `adRevenueNetwork` \(`NSString`\)：渠道名称 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenueNetwork = "network1" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -220,34 +206,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```objc - (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit; ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \(`NSString`\)：广告单位 +* `adRevenueUnit` \(`NSString`\)：广告单位 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenueUnit = "unit1" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -256,34 +239,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```objc - (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement; ``` - + 要发送广告收入位置，请调用 `setAdRevenuePlacement` 方法，并传送下列参数： -- `adRevenuePlacement` \(`NSString`\)：广告位 +* `adRevenuePlacement` \(`NSString`\)：广告位 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenuePlacement = "banner" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -292,60 +272,52 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `NSString` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.addCallbackParameter(key, value: value) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -354,42 +326,33 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 + - +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `NSString` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 - - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.addPartnerParameter(key, value: value) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -398,39 +361,37 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.setRevenue(1, currency: "EUR") adRevenue.setAdImpressionsCount(10) -adRevenue?.adRevenueNetwork = "network1" -adRevenue?.adRevenueUnit = "unit1" -adRevenue?.adRevenuePlacement = "banner" +adRevenue.setAdRevenueNetwork("network1") +adRevenue.setAdRevenueUnit("unit1") +adRevenue.setAdRevenuePlacement("banner") adRevenue.addCallbackParameter("key1", value: "value1") adRevenue.addPartnerParameter("key2", value: "value2") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -440,10 +401,10 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [adRevenue setAdRevenueNetwork:@"network1"]; [adRevenue setAdRevenueUnit:@"unit1"]; [adRevenue setAdRevenuePlacement:@"banner"]; -[adRevenue addCallbackParameter:key1 value:@"value1"]; -[adRevenue addPartnerParameter:key2 value:"@value2"]; +[adRevenue addCallbackParameter:@"key1" value:@"value1"]; +[adRevenue addPartnerParameter:@"key2" value:@"value2"]; [Adjust trackAdRevenue:adRevenue]; ``` - - + + From eeff599a89f40cef8fb8371b3b809ff110d641f0 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:43 +0000 Subject: [PATCH 27/39] File src/content/docs/en/sdk/ios/v5/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/ios/v5/features/ad-revenue.mdx | 305 ++++++++---------- 1 file changed, 133 insertions(+), 172 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v5/features/ad-revenue.mdx b/src/content/docs/ja/sdk/ios/v5/features/ad-revenue.mdx index df34cb2fe..6fed7fd62 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/ad-revenue.mdx @@ -1,66 +1,64 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/ios/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/ios/v4/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/ios/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +ADJAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjadrevenue\-object\} +------------------------------------------------------------------------------ -広告収益を計測するには、Adjustのダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## ADJAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjadrevenue-object} - - + ```objc - (nullable id)initWithSource:(nonnull NSString *)source; ``` - + Adjust SDKで広告収益情報を送信するには、`ADJAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`ADJAdRevenue`インスタンスを作成して以下の引数をパスしてください。 -- `source` （`NSString`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`NSString`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| 引数 | 広告収益ソース | -| ------------------------- | ----------------- | +| 引数 | 広告収益ソース | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 汎用ソース | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 汎用ソース | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | | `"mopub"` | MoPub | - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } //... Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -69,31 +67,28 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```objc + (void)trackAdRevenue:(nonnull ADJAdRevenue *)adRevenue; ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 - - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -102,40 +97,36 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```objc - (void)setRevenue:(double)amount currency:(nonnull NSString *)currency; ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `double`）：収益額 -- `currency` （`NSString`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `double`）：収益額 +* `currency` （`NSString`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.setRevenue(1.6, currency: "USD") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -144,38 +135,36 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `ADJAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```objc - (void)setAdImpressionsCount:(int)adImpressionsCount; ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`int`）：広告インプレッションの数。 +* `adImpressionsCount` （`int`）：広告インプレッションの数。 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adImpressionsCount = 1 +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdImpressionsCount(1) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -184,34 +173,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```objc - (void)setAdRevenueNetwork:(nonnull NSString *)adRevenueNetwork; ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （`NSString`）：ネットワーク名 +* `adRevenueNetwork` （`NSString`）：ネットワーク名 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenueNetwork = "network1" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenueNetwork("network1") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -220,34 +206,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```objc - (void)setAdRevenueUnit:(nonnull NSString *)adRevenueUnit; ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （`NSString`）：広告ユニット +* `adRevenueUnit` （`NSString`）：広告ユニット - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenueUnit = "unit1" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenueUnit("unit1") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -256,34 +239,31 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```objc - (void)setAdRevenuePlacement:(nonnull NSString *)adRevenuePlacement; ``` - + 広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： -- `adRevenuePlacement` （`NSString`）：広告配置 +* `adRevenuePlacement` （`NSString`）：広告配置 - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") -adRevenue?.adRevenuePlacement = "banner" +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } +adRevenue.setAdRevenuePlacement("banner") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -292,60 +272,52 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```objc - (void)addCallbackParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`NSString` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.addCallbackParameter(key, value: value) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -354,42 +326,33 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```objc - (void)addPartnerParameter:(nonnull NSString *)key value:(nonnull NSString *)value; ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 + - +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`NSString` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 - - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.addPartnerParameter(key, value: value) Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -398,39 +361,37 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [Adjust trackAdRevenue:adRevenue]; ``` - - + -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` - - + ```swift -let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") +guard let adRevenue = ADJAdRevenue(source: "applovin_max_sdk") else { return } adRevenue.setRevenue(1, currency: "EUR") adRevenue.setAdImpressionsCount(10) -adRevenue?.adRevenueNetwork = "network1" -adRevenue?.adRevenueUnit = "unit1" -adRevenue?.adRevenuePlacement = "banner" +adRevenue.setAdRevenueNetwork("network1") +adRevenue.setAdRevenueUnit("unit1") +adRevenue.setAdRevenuePlacement("banner") adRevenue.addCallbackParameter("key1", value: "value1") adRevenue.addPartnerParameter("key2", value: "value2") Adjust.trackAdRevenue(adRevenue) ``` - - + ```objc ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] @@ -440,10 +401,10 @@ ADJAdRevenue *adRevenue = [[ADJAdRevenue alloc] [adRevenue setAdRevenueNetwork:@"network1"]; [adRevenue setAdRevenueUnit:@"unit1"]; [adRevenue setAdRevenuePlacement:@"banner"]; -[adRevenue addCallbackParameter:key1 value:@"value1"]; -[adRevenue addPartnerParameter:key2 value:"@value2"]; +[adRevenue addCallbackParameter:@"key1" value:@"value1"]; +[adRevenue addPartnerParameter:@"key2" value:@"value2"]; [Adjust trackAdRevenue:adRevenue]; ``` - - + + From 7486e410214fb0c7eac3cb369c0da444364f5fdc Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:45 +0000 Subject: [PATCH 28/39] File src/content/docs/en/sdk/react-native/v4/features/ad-revenue.mdx was translated to ko-KR locale --- .../react-native/v4/features/ad-revenue.mdx | 203 +++++++++--------- 1 file changed, 99 insertions(+), 104 deletions(-) diff --git a/src/content/docs/ko/sdk/react-native/v4/features/ad-revenue.mdx b/src/content/docs/ko/sdk/react-native/v4/features/ad-revenue.mdx index 54111603e..2d14bbb11 100644 --- a/src/content/docs/ko/sdk/react-native/v4/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/react-native/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/react-native/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/react-native/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/react-native/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/ko/sdk/react-native/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} - - + ```ts constructor(source: string) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ---------------------------------------------- | ----------------- | +| 파라미터 | 소스 | +|------------------------------------------------|-------------------| | `AdjustConfig.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdRevenueSourceMopub` | MoPub | | `AdjustConfig.AdRevenueSourceAdMob` | Admob | @@ -45,242 +45,236 @@ Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdReve | `AdjustConfig.AdRevenueSourceAdmost` | Admost | | `AdjustConfig.AdRevenueSourceUnity` | Unity | | `AdjustConfig.AdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig.AdRevenueSourcePublisher` | 일반적인 소스 | +| `AdjustConfig.AdRevenueSourcePublisher` | 일반적인 소스 | ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```ts trackAdRevenue: ((source: string, payload: string) => void) & ((source: AdjustAdRevenue) => void) ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```ts public setRevenue(revenue: number, currency: string): void ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`number`\): 매출 금액 -- `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - - +* `revenue` \(`number`\): 매출 금액 +* `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. + - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setRevenue(1.0, "EUR"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```ts public setAdImpressionsCount(adImpressionsCount: number): void ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`number`\): 광고 노출 횟수 +* `adImpressionsCount` \(`number`\): 광고 노출 횟수 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdImpressionsCount(10); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```ts public setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`string`\): 네트워크 이름 +* `adRevenueNetwork` \(`string`\): 네트워크 이름 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenueNetwork("network1"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```ts public setAdRevenueUnit(adRevenueUnit: string): void ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`string`\): 광고 단위 +* `adRevenueUnit` \(`string`\): 광고 단위 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenueUnit("unit1"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```ts public setAdRevenuePlacement(adRevenuePlacement: string): void ``` - + `string` 값을 `setAdRevenuePlacement` 메서드에 전달하면 광고의 게재 위치를 기록할 수 있습니다. ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenuePlacement("banner"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```ts public addCallbackParameter(key: string, value: string): void ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `string` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.addCallbackParameter("key", "value"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```ts public addPartnerParameter(key: string, value: string): void ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. - - + -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `string` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.addPartnerParameter("key", "value"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` ```jsx var adjustAdRevenue = new AdjustAdRevenue( @@ -295,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 7cb9fbe39a975152823e086f60f962b03104518e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:47 +0000 Subject: [PATCH 29/39] File src/content/docs/en/sdk/react-native/v4/features/ad-revenue.mdx was translated to zh-CN locale --- .../react-native/v4/features/ad-revenue.mdx | 203 +++++++++--------- 1 file changed, 99 insertions(+), 104 deletions(-) diff --git a/src/content/docs/zh/sdk/react-native/v4/features/ad-revenue.mdx b/src/content/docs/zh/sdk/react-native/v4/features/ad-revenue.mdx index c1f70437a..6307a07f4 100644 --- a/src/content/docs/zh/sdk/react-native/v4/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/react-native/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/react-native/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/react-native/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/react-native/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/react-native/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} - - + ```ts constructor(source: string) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ---------------------------------------------- | ----------------- | +| 参数 | 来源 | +|------------------------------------------------|-------------------| | `AdjustConfig.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdRevenueSourceMopub` | mopub | | `AdjustConfig.AdRevenueSourceAdMob` | AdMob | @@ -45,242 +45,236 @@ constructor(source: string) | `AdjustConfig.AdRevenueSourceAdmost` | Admost | | `AdjustConfig.AdRevenueSourceUnity` | Unity | | `AdjustConfig.AdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig.AdRevenueSourcePublisher` | 通用来源 | +| `AdjustConfig.AdRevenueSourcePublisher` | 通用来源 | ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```ts trackAdRevenue: ((source: string, payload: string) => void) & ((source: AdjustAdRevenue) => void) ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```ts public setRevenue(revenue: number, currency: string): void ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`number`\)：收入额 -- `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - - +* `revenue` \(`number`\)：收入额 +* `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 + - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setRevenue(1.0, "EUR"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```ts public setAdImpressionsCount(adImpressionsCount: number): void ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`number`\)：广告展示数量。 +* `adImpressionsCount` \(`number`\)：广告展示数量。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdImpressionsCount(10); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```ts public setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \(`string`\)：渠道名称 +* `adRevenueNetwork` \(`string`\)：渠道名称 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenueNetwork("network1"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```ts public setAdRevenueUnit(adRevenueUnit: string): void ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \(`string`\)：广告单位 +* `adRevenueUnit` \(`string`\)：广告单位 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenueUnit("unit1"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```ts public setAdRevenuePlacement(adRevenuePlacement: string): void ``` - + 通过传递一个`string` 值至 `setAdRevenuePlacement` 方法来记录广告位。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenuePlacement("banner"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```ts public addCallbackParameter(key: string, value: string): void ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `string` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.addCallbackParameter("key", "value"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```ts public addPartnerParameter(key: string, value: string): void ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 - - + -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `string` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.addPartnerParameter("key", "value"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` ```jsx var adjustAdRevenue = new AdjustAdRevenue( @@ -295,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 84a78c803763e85ceec24bb68af11bf827a471e2 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:49 +0000 Subject: [PATCH 30/39] File src/content/docs/en/sdk/react-native/v4/features/ad-revenue.mdx was translated to ja-JP locale --- .../react-native/v4/features/ad-revenue.mdx | 205 +++++++++--------- 1 file changed, 100 insertions(+), 105 deletions(-) diff --git a/src/content/docs/ja/sdk/react-native/v4/features/ad-revenue.mdx b/src/content/docs/ja/sdk/react-native/v4/features/ad-revenue.mdx index cdd3f026a..c8da6e591 100644 --- a/src/content/docs/ja/sdk/react-native/v4/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/react-native/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/react-native/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/react-native/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/react-native/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/react-native/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```ts constructor(source: string) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ---------------------------------------------- | ----------------- | +| パラメーター | ソース | +|------------------------------------------------|-------------------| | `AdjustConfig.AdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdRevenueSourceMopub` | MoPub | | `AdjustConfig.AdRevenueSourceAdMob` | AdMob | @@ -45,242 +45,236 @@ Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブ | `AdjustConfig.AdRevenueSourceAdmost` | Admost | | `AdjustConfig.AdRevenueSourceUnity` | Unity | | `AdjustConfig.AdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig.AdRevenueSourcePublisher` | 汎用ソース | +| `AdjustConfig.AdRevenueSourcePublisher` | 汎用ソース | ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```ts trackAdRevenue: ((source: string, payload: string) => void) & ((source: AdjustAdRevenue) => void) ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```ts public setRevenue(revenue: number, currency: string): void ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `number`）：収益額 -- `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - - +* `revenue` `number`）：収益額 +* `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 + - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setRevenue(1.0, "EUR"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```ts public setAdImpressionsCount(adImpressionsCount: number): void ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`number`）：広告インプレッションの数。 +* `adImpressionsCount` （`number`）：広告インプレッションの数。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdImpressionsCount(10); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```ts public setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （`string`）：ネットワーク名 +* `adRevenueNetwork` （`string`）：ネットワーク名 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenueNetwork("network1"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```ts public setAdRevenueUnit(adRevenueUnit: string): void ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （`string`）：広告ユニット +* `adRevenueUnit` （`string`）：広告ユニット ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenueUnit("unit1"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```ts public setAdRevenuePlacement(adRevenuePlacement: string): void ``` - + `setAdRevenuePlacement`メソッドに`string`値をパスすることで、広告の配置先を記録します。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.setAdRevenuePlacement("banner"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```ts public addCallbackParameter(key: string, value: string): void ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`string` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.addCallbackParameter("key", "value"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```ts public addPartnerParameter(key: string, value: string): void ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 - - + -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`string` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); -//... + adjustAdRevenue.addPartnerParameter("key", "value"); -//... + Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` ```jsx var adjustAdRevenue = new AdjustAdRevenue( @@ -295,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 0f2b4f6005d4c64ab59b07fb5dac3bbd3f539f62 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:51 +0000 Subject: [PATCH 31/39] File src/content/docs/en/sdk/react-native/v5/features/ad-revenue.mdx was translated to ko-KR locale --- .../react-native/v5/features/ad-revenue.mdx | 175 +++++++++--------- 1 file changed, 85 insertions(+), 90 deletions(-) diff --git a/src/content/docs/ko/sdk/react-native/v5/features/ad-revenue.mdx b/src/content/docs/ko/sdk/react-native/v5/features/ad-revenue.mdx index 27f4cd0f3..51c106a4f 100644 --- a/src/content/docs/ko/sdk/react-native/v5/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/react-native/v5/features/ad-revenue.mdx @@ -1,51 +1,51 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/react-native/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/react-native/v4/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/react-native/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/react-native/v4/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - - -## Instantiate an AdjustAdRevenue object {#instantiate-an-adjustadrevenue-object} +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- - + ```ts constructor(source: string) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ------------------------- | ----------------- | -| "applovin_max_sdk"\` | AppLovin MAX | +| 파라미터 | 소스 | +|---------------------------|-------------------| +| "applovin\_max\_sdk"\` | AppLovin MAX | | `"admob_sdk"` | Admob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 일반적인 소스 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 일반적인 소스 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | @@ -55,15 +55,16 @@ var adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Send ad revenue {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```ts trackAdRevenue: (source: AdjustAdRevenue) => void ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. @@ -73,26 +74,26 @@ var adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Record ad revenue amount {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```ts public setRevenue(revenue: number, currency: string): void ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`number`\): 매출 금액 -- `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`number`\): 매출 금액 +* `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -102,23 +103,24 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Record ad campaign details {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### Ad impressions {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```ts public setAdImpressionsCount(adImpressionsCount: number): void ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`number`\): 광고 노출 횟수 +* `adImpressionsCount` \(`number`\): 광고 노출 횟수 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -128,19 +130,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### Ad revenue network {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```ts public setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`string`\): 네트워크 이름 +* `adRevenueNetwork` \(`string`\): 네트워크 이름 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -150,19 +152,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### Ad revenue unit {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```ts public setAdRevenueUnit(adRevenueUnit: string): void ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`string`\): 광고 단위 +* `adRevenueUnit` \(`string`\): 광고 단위 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -172,15 +174,15 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### Ad revenue placement {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```ts public setAdRevenuePlacement(adRevenuePlacement: string): void ``` - + `string` 값을 `setAdRevenuePlacement` 메서드에 전달하면 광고의 게재 위치를 기록할 수 있습니다. @@ -192,46 +194,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Add callback parameters {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- - + ```ts public addCallbackParameter(key: string, value: string): void ``` - + -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `string` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -241,25 +239,20 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Add partner parameters {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- - + ```ts public addPartnerParameter(key: string, value: string): void ``` - - -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. + -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - - -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `string` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. @@ -271,18 +264,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Example {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` ```jsx var adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -295,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 9d1d8b95ba4053dd36572e02ea8d69d8bcc88b11 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:53 +0000 Subject: [PATCH 32/39] File src/content/docs/en/sdk/react-native/v5/features/ad-revenue.mdx was translated to zh-CN locale --- .../react-native/v5/features/ad-revenue.mdx | 175 +++++++++--------- 1 file changed, 85 insertions(+), 90 deletions(-) diff --git a/src/content/docs/zh/sdk/react-native/v5/features/ad-revenue.mdx b/src/content/docs/zh/sdk/react-native/v5/features/ad-revenue.mdx index 72b2ac815..cb757aa92 100644 --- a/src/content/docs/zh/sdk/react-native/v5/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/react-native/v5/features/ad-revenue.mdx @@ -1,51 +1,51 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/react-native/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/react-native/v4/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/react-native/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/react-native/v4/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - - -## Instantiate an AdjustAdRevenue object {#instantiate-an-adjustadrevenue-object} +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- - + ```ts constructor(source: string) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ------------------------- | ----------------- | -| "applovin_max_sdk"\` | AppLovin MAX | +| 参数 | 来源 | +|---------------------------|-------------------| +| "applovin\_max\_sdk"\` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | IronSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 通用来源 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 通用来源 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | @@ -55,15 +55,16 @@ var adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Send ad revenue {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```ts trackAdRevenue: (source: AdjustAdRevenue) => void ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 @@ -73,26 +74,26 @@ var adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Record ad revenue amount {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```ts public setRevenue(revenue: number, currency: string): void ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`number`\)：收入额 -- `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`number`\)：收入额 +* `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -102,23 +103,24 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Record ad campaign details {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### Ad impressions {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```ts public setAdImpressionsCount(adImpressionsCount: number): void ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`number`\)：广告展示数量。 +* `adImpressionsCount` \(`number`\)：广告展示数量。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -128,19 +130,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### Ad revenue network {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```ts public setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \(`string`\)：渠道名称 +* `adRevenueNetwork` \(`string`\)：渠道名称 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -150,19 +152,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### Ad revenue unit {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```ts public setAdRevenueUnit(adRevenueUnit: string): void ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \(`string`\)：广告单位 +* `adRevenueUnit` \(`string`\)：广告单位 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -172,15 +174,15 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### Ad revenue placement {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```ts public setAdRevenuePlacement(adRevenuePlacement: string): void ``` - + 通过传递一个`string` 值至 `setAdRevenuePlacement` 方法来记录广告位。 @@ -192,46 +194,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Add callback parameters {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ - + ```ts public addCallbackParameter(key: string, value: string): void ``` - + -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `string` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -241,25 +239,20 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Add partner parameters {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- - + ```ts public addPartnerParameter(key: string, value: string): void ``` - - -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 + -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - - -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `string` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 @@ -271,18 +264,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## Example {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` ```jsx var adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -295,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 3ad4e4e61e05d0e909aefc08e68a308ac5504c9a Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:55 +0000 Subject: [PATCH 33/39] File src/content/docs/en/sdk/react-native/v5/features/ad-revenue.mdx was translated to ja-JP locale --- .../react-native/v5/features/ad-revenue.mdx | 177 +++++++++--------- 1 file changed, 86 insertions(+), 91 deletions(-) diff --git a/src/content/docs/ja/sdk/react-native/v5/features/ad-revenue.mdx b/src/content/docs/ja/sdk/react-native/v5/features/ad-revenue.mdx index dd3c34b7b..a648f183e 100644 --- a/src/content/docs/ja/sdk/react-native/v5/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/react-native/v5/features/ad-revenue.mdx @@ -1,51 +1,51 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/react-native/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/react-native/v4/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/react-native/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/react-native/v4/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```ts constructor(source: string) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ------------------------- | ----------------- | -| "applovin_max_sdk"\` | AppLovin MAX | +| パラメーター | ソース | +|---------------------------|-------------------| +| "applovin\_max\_sdk"\` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 汎用ソース | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 汎用ソース | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | @@ -55,15 +55,16 @@ var adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益を送信する {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```ts trackAdRevenue: (source: AdjustAdRevenue) => void ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 @@ -73,26 +74,26 @@ var adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```ts public setRevenue(revenue: number, currency: string): void ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `number`）：収益額 -- `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `number`）：収益額 +* `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -102,23 +103,24 @@ adjustAdRevenue.setRevenue(1.0, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```ts public setAdImpressionsCount(adImpressionsCount: number): void ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`number`）：広告インプレッションの数。 +* `adImpressionsCount` （`number`）：広告インプレッションの数。 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -128,19 +130,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```ts public setAdRevenueNetwork(adRevenueNetwork: string): void ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （`string`）：ネットワーク名 +* `adRevenueNetwork` （`string`）：ネットワーク名 ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -150,19 +152,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```ts public setAdRevenueUnit(adRevenueUnit: string): void ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （`string`）：広告ユニット +* `adRevenueUnit` （`string`）：広告ユニット ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -172,15 +174,15 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```ts public setAdRevenuePlacement(adRevenuePlacement: string): void ``` - + `setAdRevenuePlacement`メソッドに`string`値をパスすることで、広告の配置先を記録します。 @@ -192,46 +194,42 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ - + ```ts public addCallbackParameter(key: string, value: string): void ``` - + -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`string` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```jsx var adjustAdRevenue = new AdjustAdRevenue("source"); @@ -241,25 +239,20 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## パートナーパラメーターを追加する {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- - + ```ts public addPartnerParameter(key: string, value: string): void ``` - - -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 + -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - - -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`string` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 @@ -271,18 +264,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` ```jsx var adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -295,3 +289,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 5512665af3cd4770505a82e0843570b83e010c44 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:45:57 +0000 Subject: [PATCH 34/39] File src/content/docs/en/sdk/unity/v4/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/unity/v4/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v4/features/ad-revenue.mdx b/src/content/docs/ko/sdk/unity/v4/features/ad-revenue.mdx index f2e0479a9..597f6880d 100644 --- a/src/content/docs/ko/sdk/unity/v4/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/unity/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/unity/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/unity/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/unity/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/ko/sdk/unity/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - - -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- - + ```cs public AdjustAdRevenue(string source) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 파라미터 | 소스 | -| ---------------------------------------------------- | ----------------- | +| 파라미터 | 소스 | +|------------------------------------------------------|-------------------| | `AdjustConfig.AdjustAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdjustAdRevenueSourceMopub` | MoPub | | `AdjustConfig.AdjustAdRevenueSourceAdMob` | Admob | @@ -45,25 +45,26 @@ Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdReve | `AdjustConfig.AdjustAdRevenueSourceAdmost` | Admost | | `AdjustConfig.AdjustAdRevenueSourceUnity` | Unity | | `AdjustConfig.AdjustAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig.AdjustAdRevenueSourceAdx` | AD\(X\) | +| `AdjustConfig.AdjustAdRevenueSourceAdx` | AD\(X\) | | `AdjustConfig.AdjustAdRevenueSourceTradPlus` | TradPlus | | `AdjustConfig.AdjustAdRevenueSourceTopOn` | TopOn | -| `AdjustConfig.AdjustAdRevenueSourcePublisher` | 일반적인 소스 | +| `AdjustConfig.AdjustAdRevenueSourcePublisher` | 일반적인 소스 | ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```cs public static void trackAdRevenue(AdjustAdRevenue adRevenue); ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `trackAdRevenue` 메서드를 호출합니다. @@ -73,26 +74,26 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```cs public void setRevenue(double amount, string currency); ``` - + 광고 매출 금액을 전송하려면 `setRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`double`\): 매출 금액 -- `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`double`\): 매출 금액 +* `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -102,23 +103,24 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```cs public void setAdImpressionsCount(int adImpressionsCount); ``` - + 기록된 광고 노출 횟수를 전송하려면 `setAdImpressionsCount` 메서드를 호출하고 다음 인수를 전달합니다. -- `adImpressionsCount` \(`int`\): 광고 노출 횟수 +* `adImpressionsCount` \(`int`\): 광고 노출 횟수 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -128,19 +130,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```cs public void setAdRevenueNetwork(string adRevenueNetwork); ``` - + 광고 매출 네트워크를 전송하려면 `setAdRevenueNetwork` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueNetwork` \(`string`\): 네트워크 이름 +* `adRevenueNetwork` \(`string`\): 네트워크 이름 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -150,19 +152,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```cs public void setAdRevenueUnit(string adRevenueUnit); ``` - + 광고 매출 단위를 전송하려면 `setAdRevenueUnit` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenueUnit` \(`string`\): 광고 단위 +* `adRevenueUnit` \(`string`\): 광고 단위 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -172,19 +174,19 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```cs public void setAdRevenuePlacement(string adRevenuePlacement); ``` - + 광고 매출 게재 위치를 전송하려면 `setAdRevenuePlacement` 메서드를 호출하고 다음 인수를 전달합니다. -- `adRevenuePlacement` \(`string`\): 광고 게재 위치 +* `adRevenuePlacement` \(`string`\): 광고 게재 위치 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -194,42 +196,38 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- ```cs public void addCallbackParameter(string key, string value); ``` -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `string` 키\-값 인수와 함께 `addCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -239,21 +237,16 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- ```cs public void addPartnerParameter(string key, string value); ``` -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - - -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `string` 키\-값 인수와 함께 `addPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. @@ -265,18 +258,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceAppLovinMAX); @@ -289,3 +283,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 821bd392cc58799f7125906a7f039300cf9b7543 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:46:00 +0000 Subject: [PATCH 35/39] File src/content/docs/en/sdk/unity/v4/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/unity/v4/features/ad-revenue.mdx | 167 +++++++++--------- 1 file changed, 81 insertions(+), 86 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v4/features/ad-revenue.mdx b/src/content/docs/zh/sdk/unity/v4/features/ad-revenue.mdx index 9f0491a27..93e5e1ffa 100644 --- a/src/content/docs/zh/sdk/unity/v4/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/unity/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/unity/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/unity/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/unity/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - - -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- - + ```cs public AdjustAdRevenue(string source) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 来源 | -| ---------------------------------------------------- | ----------------- | +| 参数 | 来源 | +|------------------------------------------------------|-------------------| | `AdjustConfig.AdjustAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdjustAdRevenueSourceMopub` | mopub | | `AdjustConfig.AdjustAdRevenueSourceAdMob` | AdMob | @@ -45,25 +45,26 @@ public AdjustAdRevenue(string source) | `AdjustConfig.AdjustAdRevenueSourceAdmost` | Admost | | `AdjustConfig.AdjustAdRevenueSourceUnity` | Unity | | `AdjustConfig.AdjustAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig.AdjustAdRevenueSourceAdx` | Ad\(X\) | +| `AdjustConfig.AdjustAdRevenueSourceAdx` | Ad\(X\) | | `AdjustConfig.AdjustAdRevenueSourceTradPlus` | TradPlus | | `AdjustConfig.AdjustAdRevenueSourceTopOn` | TopOn | -| `AdjustConfig.AdjustAdRevenueSourcePublisher` | 通用来源 | +| `AdjustConfig.AdjustAdRevenueSourcePublisher` | 通用来源 | ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```cs public static void trackAdRevenue(AdjustAdRevenue adRevenue); ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `trackAdRevenue` 方法。 @@ -73,26 +74,26 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```cs public void setRevenue(double amount, string currency); ``` - + 要发送广告收入额，请调用 `setRevenue` 方法，并传送下列参数： -- `revenue` \(`double`\)：收入额 -- `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`double`\)：收入额 +* `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -102,23 +103,24 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```cs public void setAdImpressionsCount(int adImpressionsCount); ``` - + 要发送广告展示量记录，请调用 `setAdImpressionsCount` 方法，并传送下列参数： -- `adImpressionsCount` \(`int`\)：广告展示数量。 +* `adImpressionsCount` \(`int`\)：广告展示数量。 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -128,19 +130,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```cs public void setAdRevenueNetwork(string adRevenueNetwork); ``` - + 要发送广告收入渠道，请调用 `setAdRevenueNetwork` 方法，并传送下列参数： -- `adRevenueNetwork` \(`string`\)：渠道名称 +* `adRevenueNetwork` \(`string`\)：渠道名称 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -150,19 +152,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```cs public void setAdRevenueUnit(string adRevenueUnit); ``` - + 要发送广告收入单位，请调用 `setAdRevenueUnit` 方法，并传送下列参数： -- `adRevenueUnit` \(`string`\)：广告单位 +* `adRevenueUnit` \(`string`\)：广告单位 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -172,19 +174,19 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```cs public void setAdRevenuePlacement(string adRevenuePlacement); ``` - + 要发送广告收入位置，请调用 `setAdRevenuePlacement` 方法，并传送下列参数： -- `adRevenuePlacement` \(`string`\)：广告位 +* `adRevenuePlacement` \(`string`\)：广告位 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -194,42 +196,38 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ ```cs public void addCallbackParameter(string key, string value); ``` -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `string` 键值对 argument 调用`addCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -239,21 +237,16 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- ```cs public void addPartnerParameter(string key, string value); ``` -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - - -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `string` 键值对 argument 调用`addPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 @@ -265,18 +258,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceAppLovinMAX); @@ -289,3 +283,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From 64f653f55715fa88a308aaa8a918c21fd3fece2d Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:46:02 +0000 Subject: [PATCH 36/39] File src/content/docs/en/sdk/unity/v4/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/unity/v4/features/ad-revenue.mdx | 169 +++++++++--------- 1 file changed, 82 insertions(+), 87 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v4/features/ad-revenue.mdx b/src/content/docs/ja/sdk/unity/v4/features/ad-revenue.mdx index 9a0507aa8..e9d5e9f32 100644 --- a/src/content/docs/ja/sdk/unity/v4/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/unity/v4/features/ad-revenue.mdx @@ -1,43 +1,43 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/unity/v4/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/unity/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/unity/v4/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/unity/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```cs public AdjustAdRevenue(string source) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| パラメーター | ソース | -| ---------------------------------------------------- | ----------------- | +| パラメーター | ソース | +|------------------------------------------------------|-------------------| | `AdjustConfig.AdjustAdRevenueSourceAppLovinMAX` | AppLovin MAX | | `AdjustConfig.AdjustAdRevenueSourceMopub` | MoPub | | `AdjustConfig.AdjustAdRevenueSourceAdMob` | AdMob | @@ -45,25 +45,26 @@ Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブ | `AdjustConfig.AdjustAdRevenueSourceAdmost` | Admost | | `AdjustConfig.AdjustAdRevenueSourceUnity` | Unity | | `AdjustConfig.AdjustAdRevenueSourceHeliumChartboost` | Helium Chartboost | -| `AdjustConfig.AdjustAdRevenueSourceAdx` | Ad\(X\) | +| `AdjustConfig.AdjustAdRevenueSourceAdx` | Ad\(X\) | | `AdjustConfig.AdjustAdRevenueSourceTradPlus` | TradPlus | | `AdjustConfig.AdjustAdRevenueSourceTopOn` | TopOn | -| `AdjustConfig.AdjustAdRevenueSourcePublisher` | 汎用ソース | +| `AdjustConfig.AdjustAdRevenueSourcePublisher` | 汎用ソース | ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```cs public static void trackAdRevenue(AdjustAdRevenue adRevenue); ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`trackAdRevenue`メソッドを呼び出します。 @@ -73,26 +74,26 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```cs public void setRevenue(double amount, string currency); ``` - + 広告収益額を送信するには、`setRevenue`メソッドを呼び出し、以下の引数をパスします： -- `revenue` `double`）：収益額 -- `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `double`）：収益額 +* `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入の記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -102,23 +103,24 @@ adjustAdRevenue.setRevenue(1.00, "EUR"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```cs public void setAdImpressionsCount(int adImpressionsCount); ``` - + 記録された広告インプレッションを送信するには、`setAdImpressionsCount`メソッドを呼び出し、以下の引数をパスします： -- `adImpressionsCount` （`int`）：広告インプレッションの数。 +* `adImpressionsCount` （`int`）：広告インプレッションの数。 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -128,19 +130,19 @@ adjustAdRevenue.setAdImpressionsCount(10); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```cs public void setAdRevenueNetwork(string adRevenueNetwork); ``` - + 広告収益ネットワークを送信するには、`setAdRevenueNetwork`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueNetwork` （`string`）：ネットワーク名 +* `adRevenueNetwork` （`string`）：ネットワーク名 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -150,19 +152,19 @@ adjustAdRevenue.setAdRevenueNetwork("network1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```cs public void setAdRevenueUnit(string adRevenueUnit); ``` - + 広告収益ユニットを送信するには、`setAdRevenueUnit`メソッドを呼び出し、以下の引数をパスします： -- `adRevenueUnit` （`string`）：広告ユニット +* `adRevenueUnit` （`string`）：広告ユニット ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -172,19 +174,19 @@ adjustAdRevenue.setAdRevenueUnit("unit1"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```cs public void setAdRevenuePlacement(string adRevenuePlacement); ``` - + 広告収益の配置を送信するには、`setAdRevenuePlacement`メソッドを呼び出し、以下の引数をパスします： -- `adRevenuePlacement` （`string`）：広告配置 +* `adRevenuePlacement` （`string`）：広告配置 ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -194,42 +196,38 @@ adjustAdRevenue.setAdRevenuePlacement("banner"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ ```cs public void addCallbackParameter(string key, string value); ``` -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`string` key\-value引数を指定して`addCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -239,21 +237,16 @@ adjustAdRevenue.addCallbackParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- ```cs public void addPartnerParameter(string key, string value); ``` -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - - -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`string` key\-value引数を指定して`addPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 @@ -265,18 +258,19 @@ adjustAdRevenue.addPartnerParameter("key", "value"); Adjust.trackAdRevenue(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue(AdjustConfig.AdjustAdRevenueSourceAppLovinMAX); @@ -289,3 +283,4 @@ adjustAdRevenue.addCallbackParameter("key1", "value1"); adjustAdRevenue.addPartnerParameter("key2", "value2"); Adjust.trackAdRevenue(adjustAdRevenue); ``` + From ac9d54d3ec016ac37e5798daf578b46dc60ae1b1 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:46:04 +0000 Subject: [PATCH 37/39] File src/content/docs/en/sdk/unity/v5/features/ad-revenue.mdx was translated to ko-KR locale --- .../ko/sdk/unity/v5/features/ad-revenue.mdx | 163 +++++++++--------- 1 file changed, 79 insertions(+), 84 deletions(-) diff --git a/src/content/docs/ko/sdk/unity/v5/features/ad-revenue.mdx b/src/content/docs/ko/sdk/unity/v5/features/ad-revenue.mdx index 67f9c1c51..5d193ba7b 100644 --- a/src/content/docs/ko/sdk/unity/v5/features/ad-revenue.mdx +++ b/src/content/docs/ko/sdk/unity/v5/features/ad-revenue.mdx @@ -1,51 +1,51 @@ --- -title: 광고 매출 정보 기록 -description: Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다. -slug: ko/sdk/unity/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/unity/v4/features/ad-revenue +title: "광고 매출 정보 기록" +description: "Adjust SDK를 사용하여 지원되는 네트워크 파트너의 광고 매출 정보를 기록합니다." +slug: "en/sdk/unity/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/unity/v4/features/ad-revenue" --- - -Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/ko/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. - - +Adjust SDK를 사용하여 [지원되는 네트워크 파트너](https://help.adjust.com/en/article/ad-revenue)의 광고 매출을 기록할 수 있습니다. + 광고 매출을 측정하려면 Adjust 대시보드에서 몇 가지 추가 설정 단계를 거쳐야 합니다. 자세한 정보는 담당 테크니컬 어카운트 매니저나 [support@adjust.com](mailto:support@adjust.com)으로 연락주시기 바랍니다. + - - -## AdjustAdRevenue 객체 인스턴스화 {#instantiate-an-adjustadrevenue-object} +AdjustAdRevenue 객체 인스턴스화 \{\#instantiate\-an\-adjustadrevenue\-object\} +----------------------------------------------------------------------------- - + ```cs public AdjustAdRevenue(string source) ``` - + Adjust SDK를 사용하여 광고 매출 정보를 전송하려면 `AdjustAdRevenue` 객체를 인스턴스화해야 합니다. 이 객체에는 광고 매출이 앱에 기록될 때 Adjust로 전송되는 변수가 포함됩니다. 광고 매출 객체를 인스턴스화하려면 새로운 `AdjustAdRevenue` 인스턴스를 생성하고 다음 파라미터를 전달합니다. -- `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 +* `source` \(`string`\): 광고 매출 소스. 아래 표에서 이용 가능한 소스 참조 -| 인수 \(Arguments\) | 광고 매출 소스 | -| ------------------------- | ----------------- | +| 인수 \(Arguments\) | 광고 매출 소스 | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | Admob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 일반적인 소스 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 일반적인 소스 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | @@ -54,15 +54,16 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 전송 {#send-ad-revenue} +광고 매출 전송 \{\#send\-ad\-revenue\} +------------------------------------- - + ```cs public static void TrackAdRevenue(AdjustAdRevenue adRevenue); ``` - + Adjust로 광고 매출을 전송하려면 광고 매출 인스턴스를 인수로 사용하여 `Adjust.TrackAdRevenue` 메서드를 호출합니다. @@ -72,26 +73,26 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 광고 매출 금액 기록 {#record-ad-revenue-amount} +광고 매출 금액 기록 \{\#record\-ad\-revenue\-amount\} +--------------------------------------------------- - + ```cs public void SetRevenue(double revenue, string currency); ``` - + -광고 매출 금액을 전송하려면 `SetRevenue` 메서드를 호출하고 다음 인수를 전달합니다. +광고 매출 금액을 전송하려면 `AdjustAdRevenue` 인스턴스에서 `SetRevenue` 메서드를 호출하고 다음 인수를 전달합니다. -- `revenue` \(`double`\): 매출 금액 -- `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) +* `revenue` \(`double`\): 매출 금액 +* `currency` \(`string`\): 리포팅에 사용하는 통화의 3글자 [ISO 4217 코드](https://www.iban.com/currency-codes) - + -자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/ko/article/currency-conversion)를 참조하시기 바랍니다. - - +자세한 정보는 Adjust의 [여러 통화로 구매 기록 가이드](https://help.adjust.com/en/article/currency-conversion)를 참조하시기 바랍니다. + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -101,19 +102,20 @@ adjustAdRevenue.SetRevenue(1.00, "EUR"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 광고 캠페인 세부 항목 기록 {#record-ad-campaign-details} +광고 캠페인 세부 사항 기록 \{\#record\-ad\-campaign\-details\} +--------------------------------------------------------- `AdjustAdRevenue` 클래스에 광고 캠페인 리포트에 사용할 수 있는 속성이 포함됩니다. -### 광고 노출 {#ad-impressions} +### 광고 노출 \{\#ad\-impressions\} - + ```cs public int? AdImpressionsCount { get; set; } ``` - + 기록된 광고 노출 수를 전송하려면 `AdjustAdRevenue` 인스턴스의 `AdImpressionsCount` 속성을 광고 노출 수로 설정합니다. @@ -125,15 +127,15 @@ adjustAdRevenue.AdImpressionsCount = 10; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 네트워크 {#ad-revenue-network} +### 광고 매출 네트워크 \{\#ad\-revenue\-network\} - + ```cs public string AdRevenueNetwork { get; set; } ``` - + 광고 매출과 관련된 네트워크를 기록하려면 `AdjustAdRevenue` 인스턴스의 `AdRevenueNetwork` 속성에 네트워크 이름을 할당합니다. @@ -145,15 +147,15 @@ adjustAdRevenue.AdRevenueNetwork = "network1"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 단위 {#ad-revenue-unit} +### 광고 매출 단위 \{\#ad\-revenue\-unit\} - + ```cs public string AdRevenueUnit { get; set; } ``` - + 광고 매출 게재 단위를 전송하려면 광고 매출 인스턴스의 `AdjustAdRevenue` 속성에 `AdRevenueUnit` 값으로 단위를 할당합니다. @@ -165,17 +167,17 @@ adjustAdRevenue.AdRevenueUnit = "unit1"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 광고 매출 게재 위치 {#ad-revenue-placement} +### 광고 매출 게재 위치 \{\#ad\-revenue\-placement\} - + ```cs public string AdRevenuePlacement { get; set; } ``` - + -광고 매출 게재 위치를 전송하려면 광고 매출 인스턴스의 `AdjustAdRevenue` 속성에 `AdRevenuePlacement` 값으로 게재 위치를 할당합니다. +광고 매출 게재 위치를 전송하려면 `AdjustAdRevenue` 인스턴스의 `AdRevenuePlacement` 속성에 광고 게재 위치를 할당합니다. ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -185,42 +187,38 @@ adjustAdRevenue.AdRevenuePlacement = "banner"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 콜백 파라미터 추가 {#add-callback-parameters} +콜백 파라미터 추가 \{\#add\-callback\-parameters\} +----------------------------------------------- ```cs public void AddCallbackParameter(string key, string value); ``` -Adjust 대시보드에 [콜백 URL](https://help.adjust.com/ko/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. +Adjust 대시보드에 [콜백 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)을 등록하면 SDK가 이벤트를 기록할 때 ADK가 GET 요청을 콜백 URL로 보냅니다. -콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/ko/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. +콜백 파라미터를 서버에 구성할 수 있습니다. 이벤트에 대한 파라미터 구성이 완료되면 SDK는 이를 [콜백 URL](https://help.adjust.com/en/article/raw-data-exports)에 추가합니다. 해당 정보를 사용하여, BI 시스템을 통해 사용자 인앱 행동을 분석할 수 있습니다. `string` 키\-값 인수와 함께 `AddCallbackParameter` 메서드를 호출하여 이벤트에 콜백 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. Adjust SDK는 이벤트를 측정하고 콜백 파라미터가 추가된 URL로 요청을 전송합니다. 예를 들어 URL `https://www.mydomain.com/callback`을 등록한 경우 콜백은 다음과 같습니다. - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust는 사용자의 커스텀 콜백 파라미터를 보관하지 않습니다. 커스텀 파라미터는 콜백 URL에만 추가됩니다. - - + CSV 업로드를 사용하는 경우, 반드시 CSV 정의에 파라미터를 추가하시기 바랍니다. Adjust는 SDK에서 URL로 정보를 전송하는 데 사용할 수 있는 다양한 플레이스홀더를 지원합니다. 예를 들어, iOS의 경우 `{idfa}` 플레이스홀더, Android의 경우 `{gps_adid}` 플레이스홀더입니다. `{publisher_parameter}` 플레이스홀더는 단일 문자열의 모든 콜백 파라미터를 나타냅니다. + - - -Adjust [콜백 가이드](https://help.adjust.com/ko/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. - - +Adjust [콜백 가이드](https://help.adjust.com/en/article/callbacks)에서 사용 가능한 값의 전체 목록을 비롯하여 URL 콜백을 사용하는 방법을 자세히 알아보실 수 있습니다. + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -230,21 +228,16 @@ adjustAdRevenue.AddCallbackParameter("key", "value"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 파트너 파라미터 추가 {#add-partner-parameters} +파트너 파라미터 추가 \{\#add\-partner\-parameters\} +----------------------------------------------- ```cs public void AddPartnerParameter(string key, string value); ``` -[파트너 파라미터](https://help.adjust.com/ko/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - -Adjust는 설정한 [외부 파트너](https://help.adjust.com/ko/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. +[파트너 파라미터](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)를 추가하여 네트워크 파트너에게 추가 정보를 전송할 수 있습니다. - - -파트너 파라미터는 기본 설정에 따라 로 데이터에 나타나지 않습니다. `{partner_parameters}` 플레이스홀더를 추가하여 단일 문자열로 수신할 수 있습니다. - - +Adjust는 설정한 [외부 파트너](https://help.adjust.com/en/article/integrated-partners)에게 파트너 파라미터를 전송합니다. 이러한 정보는 보다 세분화된 분석과 리타겟팅에 유용할 것입니다. 파트너에 대해 파라미터를 설정하고 활성화하면 Adjust 서버는 해당 파라미터를 포워드 합니다. `string` 키\-값 인수와 함께 `AddPartnerParameter` 메서드를 호출하여 이벤트에 파트너 파라미터를 추가합니다. 이 메서드를 여러 번 호출함으로써 여러 파라미터를 추가할 수 있습니다. @@ -256,18 +249,19 @@ adjustAdRevenue.AddPartnerParameter("key", "value"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 예시 {#example} +예 \{\#example\} +------------------ 이 예시는 다음 속성을 사용하여 광고 매출 객체를 설정하고 기록하는 방법을 보여줍니다. -- 매출 소스: AppLovin MAX -- 매출액: 1유로\(Euro\) -- 광고 노출: 10 -- 광고 매출 네트워크: _`"network1"`_ -- 광고 매출 단위: _`"unit1"`_ -- 광고 매출 게재 위치: _`"banner"`_ -- 콜백 파라미터: `"key1" = "value1"` -- 파트너 파라미터: `"key2" = "value2"` +* 매출 소스: AppLovin MAX +* 매출액: 1유로\(Euro\) +* 광고 노출: 10 +* 광고 매출 네트워크: *`"network1"`* +* 광고 매출 단위: *`"unit1"`* +* 광고 매출 게재 위치: *`"banner"`* +* 콜백 파라미터: `"key1" = "value1"` +* 파트너 파라미터: `"key2" = "value2"` ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -280,3 +274,4 @@ adjustAdRevenue.AddCallbackParameter("key1", "value1"); adjustAdRevenue.AddPartnerParameter("key2", "value2"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` + From 5f1fcf2401116180b3b2c58224fc759c05a5cd7b Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:46:06 +0000 Subject: [PATCH 38/39] File src/content/docs/en/sdk/unity/v5/features/ad-revenue.mdx was translated to zh-CN locale --- .../zh/sdk/unity/v5/features/ad-revenue.mdx | 159 +++++++++--------- 1 file changed, 77 insertions(+), 82 deletions(-) diff --git a/src/content/docs/zh/sdk/unity/v5/features/ad-revenue.mdx b/src/content/docs/zh/sdk/unity/v5/features/ad-revenue.mdx index 42f2cffd9..4075e4dbe 100644 --- a/src/content/docs/zh/sdk/unity/v5/features/ad-revenue.mdx +++ b/src/content/docs/zh/sdk/unity/v5/features/ad-revenue.mdx @@ -1,51 +1,51 @@ --- -title: 记录广告收入信息 -description: 使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。 -slug: zh/sdk/unity/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/unity/v4/features/ad-revenue +title: "记录广告收入信息" +description: "使用 Adjust SDK 记录受支持渠道合作伙伴的广告收入信息。" +slug: "en/sdk/unity/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/ad-revenue" --- - -您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/zh/article/ad-revenue)的广告收入。 - - +您可以使用 Adjust SDK 记录[受支持渠道合作伙伴](https://help.adjust.com/en/article/ad-revenue)的广告收入。 + 要监测收入，您需要在 Adjust 控制面板中进行一些额外设置步骤。请联系您的技术客户经理或发送邮件至 [support@adjust.com](mailto:support@adjust.com) 来开始设置。 + - - -## 实例化 AdjustAdRevenue 对象 {#instantiate-an-adjustadrevenue-object} +实例化 AdjustAdRevenue 对象\{\#instantiate\-an\-adjustadrevenue\-object\} +-------------------------------------------------------------------------- - + ```cs public AdjustAdRevenue(string source) ``` - + 要使用 Adjust SDK 发送广告收入信息，请实例化一个 `AdjustAdRevenue` 对象。该对象中包含的变量会在应用中记录到广告收入时被发送给 Adjust。 要实例化广告收入对象，请创建新的 `AdjustAdRevenue` 实例，并传送下列参数： -- `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 +* `source` \(`string`\)：广告收入来源。请查看下表，了解来源。 -| 参数 | 广告收入来源 | -| ------------------------- | ----------------- | +| 参数 | 广告收入来源 | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | IronSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 通用来源 | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 通用来源 | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | @@ -54,15 +54,16 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 发送广告收入 {#send-ad-revenue} +发送广告收入\{\#send\-ad\-revenue\} +---------------------------------- - + ```cs public static void TrackAdRevenue(AdjustAdRevenue adRevenue); ``` - + 要向 Adjust 发送广告收入数据，请以广告收入实例作为参数，调用 `Adjust.TrackAdRevenue` 方法。 @@ -72,26 +73,26 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 记录广告收入额 {#record-ad-revenue-amount} +记录广告收入额\{\#record\-ad\-revenue\-amount\} +---------------------------------------------- - + ```cs public void SetRevenue(double revenue, string currency); ``` - + 要发送广告收入额，请调用`AdjustAdRevenue`实例的`SetRevenue`方法，并传送下列参数： -- `revenue` \(`double`\)：收入额 -- `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 +* `revenue` \(`double`\)：收入额 +* `currency` \(`string`\)：您报告币种的 [ISO 4217 代码](https://www.iban.com/currency-codes)，由 3 个字符组成 - + -欢迎查看[记录不同币种的购买](https://help.adjust.com/zh/article/currency-conversion)一文，了解更多信息。 - - +欢迎查看[记录不同币种的购买](https://help.adjust.com/en/article/currency-conversion)一文，了解更多信息。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -101,19 +102,20 @@ adjustAdRevenue.SetRevenue(1.00, "EUR"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 记录广告推广活动细节 {#record-ad-campaign-details} +记录广告推广活动细节\{\#record\-ad\-campaign\-details\} +--------------------------------------------------- `AdjustAdRevenue` 类包含多种属性，您可以通过这些属性来报告广告推广活动信息。 -### 广告展示 {#ad-impressions} +### 广告展示\{\#ad\-impressions\} - + ```cs public int? AdImpressionsCount { get; set; } ``` - + 要发送记录的广告展示数量，请将`AdjustAdRevenue`实例的`AdImpressionsCount`属性设置为广告展示数量。 @@ -125,15 +127,15 @@ adjustAdRevenue.AdImpressionsCount = 10; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 广告收入渠道 {#ad-revenue-network} +### 广告收入渠道\{\#ad\-revenue\-network\} - + ```cs public string AdRevenueNetwork { get; set; } ``` - + 要记录与广告收入关联的渠道，请将渠道名称指定至`AdjustAdRevenue`实例的`AdRevenueNetwork`属性。 @@ -145,15 +147,15 @@ adjustAdRevenue.AdRevenueNetwork = "network1"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 广告收入单位 {#ad-revenue-unit} +### 广告收入单元\{\#ad\-revenue\-unit\} - + ```cs public string AdRevenueUnit { get; set; } ``` - + 要发送广告收入单位，请将单位指定至 `AdjustAdRevenue` 实例的`AdRevenueUnit`属性。 @@ -165,15 +167,15 @@ adjustAdRevenue.AdRevenueUnit = "unit1"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 广告收入位置 {#ad-revenue-placement} +### 广告收入位置\{\#ad\-revenue\-placement\} - + ```cs public string AdRevenuePlacement { get; set; } ``` - + 要发送广告收入位置，请将广告位置指定至 `AdjustAdRevenue` 实例的 `AdRevenuePlacement`属性。 @@ -185,42 +187,38 @@ adjustAdRevenue.AdRevenuePlacement = "banner"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 添加回传参数 {#add-callback-parameters} +添加回传参数\{\#add\-callback\-parameters\} +------------------------------------------ ```cs public void AddCallbackParameter(string key, string value); ``` -您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/zh/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 +您在 Adjust 控制面板中[注册回传 URL](https://help.adjust.com/en/article/recommended-placeholders-callbacks)，SDK 监测到事件后，会向您的回传 URL 发送一个 GET 请求。 -您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/zh/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 +您可以为自己的服务器设置回传参数。配置好事件的参数后，SDK 会将参数附加至[您的回传 URL](https://help.adjust.com/en/article/raw-data-exports)。您可以利用该信息，通过自己的 BI 系统分析用户应用内行为。 使用 `string` 键值对 argument 调用`AddCallbackParameter`方法，以此向事件添加回传参数。多次调用该方法可添加多个参数。 Adjust SDK 监测事件，并向附加回传参数的 URL 发送请求。例如，如果您注册了 URL`https://www.mydomain.com/callback`，则回传为： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjust 不会存储您的自定义回传参数。自定义回传参数只会附加在您的回传 URL 中。 - - + 如果您使用的是 CSV 上传，请务必在 CSV 定义中添加参数。 Adjust 支持许多占位符，这些占位符可用来将信息从 SDK 发送至您的 URL。例如，iOS 的`{idfa}`占位符和安卓的`{gps_adid}`占位符。`{publisher_parameter}`占位符可在单一字符串中呈现所有回传参数。 + - - -若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/zh/article/callbacks)。 - - +若想进一步了解 URL 回传，查看可用参数的完整列表，请参阅[回传指南](https://help.adjust.com/en/article/callbacks)。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -230,21 +228,16 @@ adjustAdRevenue.AddCallbackParameter("key", "value"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 添加合作伙伴参数 {#add-partner-parameters} +添加合作伙伴参数\{\#add\-partner\-parameters\} +------------------------------------------- ```cs public void AddPartnerParameter(string key, string value); ``` -您可以添加[合作伙伴参数](https://help.adjust.com/zh/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - -Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/zh/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 +您可以添加[合作伙伴参数](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)，向渠道合作伙伴发送额外的信息。 - - -合作伙伴参数不会默认出现在原始数据中。您可以添加`{partner_parameters}`占位符，在同一个字符串中接收参数。 - - +Adjust 可向您设置的[外部合作伙伴](https://help.adjust.com/en/article/integrated-partners)发送合作伙伴参数。这些信息可用来进行更精细的数据分析，开展再营销活动。您设置好参数并为合作伙伴启用参数转发后，Adjust 服务器就会将这些参数转发给合作伙伴。 使用 `string` 键值对 argument 调用`AddPartnerParameter`方法，以此向事件添加合作伙伴参数。多次调用该方法可添加多个参数。 @@ -256,18 +249,19 @@ adjustAdRevenue.AddPartnerParameter("key", "value"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 示例 {#example} +示例 \{\#example\} +------------------- 该示例展示了如何设置并记录一个广告收入对象，其属性如下： -- AppLovin MAX 作为收入来源 -- 收入金额为 1 欧元 -- 10 次广告展示 -- _`"network1"`_ 为广告收入渠道 -- _`"unit1"`_ 为广告收入单位 -- _`"banner"`_ 为广告收入位置 -- 回传参数： `"key1" = "value1"` -- 合作伙伴参数： `"key2" = "value2"` +* AppLovin MAX 作为收入来源 +* 收入金额为 1 欧元 +* 10 次广告展示 +* *`"network1"`* 为广告收入渠道 +* *`"unit1"`* 为广告收入单位 +* *`"banner"`* 为广告收入位置 +* 回传参数： `"key1" = "value1"` +* 合作伙伴参数： `"key2" = "value2"` ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -280,3 +274,4 @@ adjustAdRevenue.AddCallbackParameter("key1", "value1"); adjustAdRevenue.AddPartnerParameter("key2", "value2"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` + From 1d59df53776b791c433f6c92d951ed8cdceaec9c Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 5 Nov 2024 12:46:09 +0000 Subject: [PATCH 39/39] File src/content/docs/en/sdk/unity/v5/features/ad-revenue.mdx was translated to ja-JP locale --- .../ja/sdk/unity/v5/features/ad-revenue.mdx | 161 +++++++++--------- 1 file changed, 78 insertions(+), 83 deletions(-) diff --git a/src/content/docs/ja/sdk/unity/v5/features/ad-revenue.mdx b/src/content/docs/ja/sdk/unity/v5/features/ad-revenue.mdx index f8dbce22e..24d8e8bdf 100644 --- a/src/content/docs/ja/sdk/unity/v5/features/ad-revenue.mdx +++ b/src/content/docs/ja/sdk/unity/v5/features/ad-revenue.mdx @@ -1,51 +1,51 @@ --- -title: 広告収益情報の記録 -description: Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。 -slug: ja/sdk/unity/features/ad-revenue -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/unity/v4/features/ad-revenue +title: "広告収益情報の記録" +description: "Adjust SDKを使用して、サポートされているネットワークパートナーの広告収益情報を記録します。" +slug: "en/sdk/unity/features/ad-revenue" +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/unity/v4/features/ad-revenue" --- +Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/en/article/ad-revenue)の広告収益を記録することができます。 + -Adjust SDKを使用して、[サポートされているネットワークパートナー](https://help.adjust.com/ja/article/ad-revenue)の広告収益を記録することができます。 +広告収益を計測するには、Adjustの管理画面で行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 + - +AdjustAdRevenueオブジェクトをインスタンス化する \{\#instantiate\-an\-adjustadrevenue\-object\} +------------------------------------------------------------------------------------ -広告収益を計測するには、Adjustダッシュボードで行っていただく追加ステップがあります。担当のテクニカルアカウントマネージャーまたは[support@adjust.com](mailto:support@adjust.com)にお問い合わせください。 - - - -## AdjustAdRevenueオブジェクトをインスタンス化する {#instantiate-an-adjustadrevenue-object} - - + ```cs public AdjustAdRevenue(string source) ``` - + Adjust SDKで広告収益情報を送信するには、`AdjustAdRevenue`オブジェクトをインスタンス化する必要があります。このオブジェクトには、アプリで広告収益が記録されたときにAdjustに送信される変数が含まれます。 広告収益オブジェクトをインスタンス化するには、新しい`AdjustAdRevenue`インスタンスを作成して以下のパラメーターをパスしてください： -- `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 +* `source` （`string`）：広告収益のソース。利用可能なソースについては、以下の表を参照してください。 -| 引数 | 広告収益ソース | -| ------------------------- | ----------------- | +| 引数 | 広告収益ソース | +|---------------------------|-------------------| | `"applovin_max_sdk"` | AppLovin MAX | | `"admob_sdk"` | AdMob | | `"ironsource_sdk"` | ironSource | | `"admost_sdk"` | Admost | | `"unity_sdk"` | Unity | | `"helium_chartboost_sdk"` | Helium Chartboost | -| `"adx_sdk"` | Ad\(X\) | -| `"publisher_sdk"` | 汎用ソース | +| `"adx_sdk"` | Ad\(X\) | +| `"publisher_sdk"` | 汎用ソース | | `"tradplus_sdk"` | TradPlus | | `"topon_sdk"` | TopOn | @@ -54,15 +54,16 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 広告収益の送信 {#send-ad-revenue} +広告収益を送信する \{\#send\-ad\-revenue\} +-------------------------------------- - + ```cs public static void TrackAdRevenue(AdjustAdRevenue adRevenue); ``` - + 広告収益をAdjustに送信するには、広告収益のインスタンスを引数として`Adjust.TrackAdRevenue`メソッドを呼び出します。 @@ -72,26 +73,26 @@ AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 広告収益額を記録する {#record-ad-revenue-amount} +広告収益額を記録する \{\#record\-ad\-revenue\-amount\} +-------------------------------------------------- - + ```cs public void SetRevenue(double revenue, string currency); ``` - + 広告収益額を送信するには、`AdjustAdRevenue`インスタンスの`SetRevenue`メソッドを呼び出して、以下の引数をパスします： -- `revenue` `double`）：収益額 -- `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) +* `revenue` `double`）：収益額 +* `currency` （`string`）：レポート通貨の3桁の[ISO 4217コード](https://www.iban.com/currency-codes) - + -詳細は、[異なる通貨での購入の記録](https://help.adjust.com/ja/article/currency-conversion)に関するガイドをご覧ください。 - - +詳細は、[異なる通貨での購入記録](https://help.adjust.com/en/article/currency-conversion)に関するガイドをご覧ください。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -101,19 +102,20 @@ adjustAdRevenue.SetRevenue(1.00, "EUR"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 広告キャンペーンの詳細を記録する {#record-ad-campaign-details} +広告キャンペーンの詳細を記録する \{\#record\-ad\-campaign\-details\} +---------------------------------------------------------- `AdjustAdRevenue`クラスには、広告キャンペーンのレポート作成に使用できるプロパティが含まれています。 -### 広告インプレッション数 {#ad-impressions} +### 広告インプレッション数 \{\#ad\-impressions\} - + ```cs public int? AdImpressionsCount { get; set; } ``` - + 記録された広告インプレッション数を送信するには、 `AdjustAdRevenue`インスタンスの`AdImpressionsCount`プロパティを広告インプレッション数に設定してください。 @@ -125,15 +127,15 @@ adjustAdRevenue.AdImpressionsCount = 10; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 広告収益ネットワーク {#ad-revenue-network} +### 広告収益ネットワーク \{\#ad\-revenue\-network\} - + ```cs public string AdRevenueNetwork { get; set; } ``` - + 広告収益に関連するネットワークを記録するには、 `AdjustAdRevenue`インスタンスの`AdRevenueNetwork`プロパティにネットワーク名を割り当てます。 @@ -145,15 +147,15 @@ adjustAdRevenue.AdRevenueNetwork = "network1"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 広告収益ユニット {#ad-revenue-unit} +### 広告収益ユニット \{\#ad\-revenue\-unit\} - + ```cs public string AdRevenueUnit { get; set; } ``` - + 広告収益ユニットを送信するには、広告収益インスタンスの`AdjustAdRevenue`プロパティにユニットを`AdRevenueUnit`値として割り当てます。 @@ -165,15 +167,15 @@ adjustAdRevenue.AdRevenueUnit = "unit1"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -### 広告収益の配置 {#ad-revenue-placement} +### 広告収益の配置 \{\#ad\-revenue\-placement\} - + ```cs public string AdRevenuePlacement { get; set; } ``` - + 広告収益の配置を送信するには、広告収益インスタンスの`AdjustAdRevenue`プロパティに配置を`AdRevenuePlacement`値として割り当てます。 @@ -185,42 +187,38 @@ adjustAdRevenue.AdRevenuePlacement = "banner"; Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## コールバックパラメーターを追加する {#add-callback-parameters} +コールバックパラメーターを追加する \{\#add\-callback\-parameters\} +------------------------------------------------------ ```cs public void AddCallbackParameter(string key, string value); ``` -Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/ja/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 +Adjustダッシュボードで[コールバックURLを登録](https://help.adjust.com/en/article/recommended-placeholders-callbacks)した場合、SDKがイベントを記録する際にコールバックURLにGETリクエストを送信します。 -コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/ja/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 +コールバックパラメーターをサーバーに設定できます。イベントにパラメーターを設定すると、SDKはそれらを[コールバックURL](https://help.adjust.com/en/article/raw-data-exports)に追加します。この情報を使用して、自社のBIシステムでユーザーのアプリ内行動を分析することが可能です。 イベントにコールバックパラメーターを追加するには、`string` key\-value引数を指定して`AddCallbackParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 Adjust SDKはイベントを計測し、コールバックパラメーターが追加されたURLにリクエストを送信します。例えば、URL `https://www.mydomain.com/callback`が登録されている場合、コールバックは以下のようになります： - - + ```http https://www.mydomain.com/callback?key=value&foo=bar ``` - - + Adjustは、カスタムコールバックパラメーターを保存しません。カスタムパラメーターは、コールバックURLにのみ追加されます。 - - + CSVレポートを使用している場合、CSVの定義欄にパラメーターを追加するようにしてください。 Adjustでは、SDKからURLに情報をパスするための様々なプレースホルダーをサポートしています。例えば、iOSの`{idfa}`プレースホルダーやAndroidの`{gps_adid}`プレースホルダーなどです。`{publisher_parameter}`プレースホルダーは、単一の文字列での全てのコールバックパラメーターを表示します。 + - - -使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/ja/article/callbacks)をご覧ください。 - - +使用可能な値の全リストを含むURLコールバックの詳細については、[コールバックガイド](https://help.adjust.com/en/article/callbacks)をご覧ください。 + ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("source"); @@ -230,21 +228,16 @@ adjustAdRevenue.AddCallbackParameter("key", "value"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## パートナーパラメーターの追加 {#add-partner-parameters} +パートナーパラメーターを追加する \{\#add\-partner\-parameters\} +---------------------------------------------------- ```cs public void AddPartnerParameter(string key, string value); ``` -[パートナーパラメーター](https://help.adjust.com/ja/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - -Adjustは、設定した[外部パートナー](https://help.adjust.com/ja/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 +[パートナーパラメーター](https://help.adjust.com/en/article/data-sharing-ad-network#map-parameters)を追加することで、ネットワークパートナーに追加情報を送信することができます。 - - -パートナーパラメーターはデフォルトではローデータに表示されません。ご希望の場合は、プレースホルダー`{partner_parameters}`を追加することで、それらを単一の文字列として受信することができます。 - - +Adjustは、設定した[外部パートナー](https://help.adjust.com/en/article/integrated-partners)にパートナーパラメーターを送信します。この情報は、より詳細な分析やリターゲティング施策にご利用いただけます。パートナー用にパラメーターの設定が完了し、機能が有効化されると、Adjustのサーバーはデータ転送を開始します。 イベントにパートナーパラメーターを追加するには、`string` key\-value引数を指定して`AddPartnerParameter`メソッドを呼び出してください。このメソッドを複回呼び出すことで、複数のパラメーターを追加することができます。 @@ -256,18 +249,19 @@ adjustAdRevenue.AddPartnerParameter("key", "value"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` -## 例 {#example} +例 \{\#example\} +------------------ この例では、以下のプロパティを含む広告収益オブジェクトを設定し、記録する方法を示しています： -- 収益ソースをAppLovin MAXとする -- 収益額を1 Euroとする -- 10広告インプレッション数 -- 広告収益ネットワークを _`"network1"`_ とする -- 広告収益ユニットを _`"unit1"`_ とする -- 広告収益の配置を _`"banner"`_ とする -- コールバックパラメーター： `"key1" = "value1"` -- パートナーパラメーター： `"key2" = "value2"` +* 収益ソースをAppLovin MAXとする +* 収益額を1 Euroとする +* 10広告インプレッション数 +* 広告収益ネットワークを *`"network1"`* とする +* 広告収益ユニットを *`"unit1"`* とする +* 広告収益の配置を *`"banner"`* とする +* コールバックパラメーター： `"key1" = "value1"` +* パートナーパラメーター： `"key2" = "value2"` ```cs AdjustAdRevenue adjustAdRevenue = new AdjustAdRevenue("applovin_max_sdk"); @@ -280,3 +274,4 @@ adjustAdRevenue.AddCallbackParameter("key1", "value1"); adjustAdRevenue.AddPartnerParameter("key2", "value2"); Adjust.TrackAdRevenue(adjustAdRevenue); ``` +