- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- CustomerSkAdNetworkConversionValueSchemaOperation
- CustomerSkAdNetworkConversionValueSchema
- SkAdNetworkConversionValueSchema
- FineGrainedConversionValueMappings
- ConversionValueMapping
- 이벤트
- RevenueRange
- EventOccurrenceRange
- PostbackMapping
- CoarseGrainedConversionValueMappings
- MutateCustomerSkAdNetworkConversionValueSchemaResult
- 실습
CustomerSkAdNetworkConversionValueSchema를 만들거나 업데이트합니다.
발생한 오류 목록: AuthenticationError AuthorizationError FieldError InternalError MutateError
HTTP 요청
POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
공유 세트가 수정 중인 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"operation": {
object ( |
입력란 | |
---|---|
operation |
수행할 연산입니다. |
validateOnly |
true인 경우 요청의 유효성이 검사되지만 실행되지는 않습니다. 결과는 반환되지 않고 오류만 반환됩니다. |
enableWarnings |
선택사항입니다. true인 경우 경고 반환을 사용 설정합니다. 경고는 변경 작업의 실행을 차단하지 않고 오류 메시지와 오류 코드를 반환합니다. |
응답 본문
customerSkAdNetworkConversionValueSchemas.mut의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "result": { object ( |
입력란 | |
---|---|
result |
뮤테이션에 대한 모든 결과입니다. |
warning |
스키마 유효성 검사 실패 세부정보를 제공하는 비차단 오류입니다. enableWarnings = true인 경우에만 반환됩니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
CustomerSkAdNetworkConversionValueSchemaOperation
CustomerSkAdNetworkConversionValueSchema의 단일 업데이트 작업입니다.
JSON 표현 |
---|
{
"update": {
object ( |
입력란 | |
---|---|
update |
업데이트 작업: 스키마에 유효한 리소스 이름이 있어야 합니다. |
CustomerSkAdNetworkConversionValueSchema
CustomerSkAdNetworkConversionValueSchema입니다.
JSON 표현 |
---|
{
"resourceName": string,
"schema": {
object ( |
입력란 | |
---|---|
resourceName |
출력 전용입니다. 스키마의 리소스 이름입니다. CustomerSkAdNetworkConversionValueSchema 리소스 이름의 형식은 customer/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}입니다. |
schema |
출력 전용입니다. 지정된 리소스의 스키마입니다. |
SkAdNetworkConversionValueSchema
CustomerLink 전용 SkAdNetworkConversionValueSchema입니다.
JSON 표현 |
---|
{ "appId": string, "measurementWindowHours": integer, "fineGrainedConversionValueMappings": [ { object ( |
입력란 | |
---|---|
appId |
필수 항목입니다. 출력 전용입니다. Apple App Store 앱 ID입니다. |
measurementWindowHours |
출력 전용입니다. 설치 후 앱 기여 분석 파트너 또는 광고주가 updateConversionValue 호출을 중지한 후 경과한 시간 (시간 단위로 측정됨)입니다. |
fineGrainedConversionValueMappings[] |
출력 전용입니다. 세분화된 전환 가치 매핑 여러 전환 추적 기간을 지원하는 SkAdNetwork 버전이 4.0 이상인 경우 세분화된 전환 가치 매핑은 첫 번째 포스트백에만 적용됩니다. |
postbackMappings[] |
출력 전용입니다. 여러 전환 추적 기간의 포스트백에 대한 포스트백별 전환 가치 매핑입니다. SkAdNetwork 버전 4.0 이상에만 적용됩니다. |
FineGrainedConversionValueMappings
세분화된 전환 가치 매핑
JSON 표현 |
---|
{
"fineGrainedConversionValue": integer,
"conversionValueMapping": {
object ( |
입력란 | |
---|---|
fineGrainedConversionValue |
출력 전용입니다. 세분화된 전환 가치. 유효한 값의 범위는 [0,63]입니다. |
conversionValueMapping |
출력 전용입니다. 세분화된 전환 가치가 매핑되는 전환 이벤트입니다. |
ConversionValueMapping
하나의 전환 가치에서 하나 이상의 전환 이벤트로의 매핑을 나타냅니다.
JSON 표현 |
---|
{
"minTimePostInstallHours": string,
"maxTimePostInstallHours": string,
"mappedEvents": [
{
object ( |
입력란 | |
---|---|
minTimePostInstallHours |
출력 전용입니다. 측정 기간 동안 사용자가 마지막으로 활성 상태였던 기간의 최소 시간입니다. |
maxTimePostInstallHours |
출력 전용입니다. 측정 기간 동안 사용자가 마지막으로 활성 상태였던 기간의 최댓값입니다. |
mappedEvents[] |
출력 전용입니다. 전환 가치는 다양한 속성을 가진 여러 이벤트에 매핑될 수 있습니다. |
이벤트
전환 가치가 매핑되는 Google 전환 이벤트를 정의합니다.
JSON 표현 |
---|
{ "mappedEventName": string, "currencyCode": string, // Union field |
입력란 | |
---|---|
mappedEventName |
출력 전용입니다. 이 전환 가치로 표시되는 Google 이벤트 이름입니다. |
currencyCode |
출력 전용입니다. event_revenue에 대해 보고된 통화입니다. ISO 4217 3자리 통화 코드(예: 'USD')입니다. |
통합 필드 revenue_rate . 이벤트 수익의 범위 또는 특정 값입니다. revenue_rate 은 다음 중 하나여야 합니다. |
|
eventRevenueRange |
출력 전용입니다. 이벤트 수익 범위입니다. |
eventRevenueValue |
출력 전용입니다. 특정 이벤트 수익 값입니다. |
통합 필드 event_rate . 범위 또는 이벤트 카운터의 특정 값입니다. event_rate 은 다음 중 하나여야 합니다. |
|
eventOccurrenceRange |
출력 전용입니다. 이벤트 카운터 범위입니다. |
eventCounter |
출력 전용입니다. 특정 이벤트 카운터 값 |
RevenueRange
수익 값의 범위를 정의합니다.
JSON 표현 |
---|
{ "minEventRevenue": number, "maxEventRevenue": number } |
입력란 | |
---|---|
minEventRevenue |
출력 전용입니다. 수익 범위에서 이 전환 가치가 업데이트될 |
maxEventRevenue |
출력 전용입니다. 수익 범위의 경우 이 전환 가치가 업데이트될 |
EventOccurrenceRange
이벤트 카운터 값의 범위를 정의합니다.
JSON 표현 |
---|
{ "minEventCount": string, "maxEventCount": string } |
입력란 | |
---|---|
minEventCount |
출력 전용입니다. 이벤트 카운터 범위의 경우 정의된 범위의 최솟값입니다. 0 값은 설정되지 않은 것으로 간주됩니다. |
maxEventCount |
출력 전용입니다. 이벤트 카운터 범위의 경우 정의된 범위의 최대값입니다. 0 값은 설정되지 않은 것으로 간주됩니다. |
PostbackMapping
여러 전환 추적 기간의 각 포스트백에 대한 매핑
JSON 표현 |
---|
{ "postbackSequenceIndex": integer, "coarseGrainedConversionValueMappings": { object ( |
입력란 | |
---|---|
postbackSequenceIndex |
출력 전용입니다. 포스트백 순서를 나타내는 0 기반 색인입니다. 유효한 값의 범위는 [0,2]입니다. |
coarseGrainedConversionValueMappings |
출력 전용입니다. 모든 대략적인 전환 가치에 대한 전환 가치 매핑입니다. |
통합 필드 lock_window_trigger . 전환 추적 기간을 잠그는 데 사용되는 이벤트 또는 전환 가치입니다. lock_window_trigger 은 다음 중 하나여야 합니다. |
|
lockWindowCoarseConversionValue |
출력 전용입니다. 전환 추적 기간 잠금을 트리거하는 대략적인 전환 가치입니다. |
lockWindowFineConversionValue |
출력 전용입니다. 전환 추적 기간 잠금을 트리거하는 세분화된 전환 가치입니다. |
lockWindowEvent |
출력 전용입니다. 전환 추적 기간 잠금을 트리거하는 이벤트 이름입니다. |
CoarseGrainedConversionValueMappings
대략적인 전환 가치 매핑
JSON 표현 |
---|
{ "lowConversionValueMapping": { object ( |
입력란 | |
---|---|
lowConversionValueMapping |
출력 전용입니다. '낮음' 대략적인 전환 가치 매핑 |
mediumConversionValueMapping |
출력 전용입니다. '중간' 대략적인 전환 가치 매핑 |
highConversionValueMapping |
출력 전용입니다. '높음' 대략적인 전환 가치 매핑 |
MutateCustomerSkAdNetworkConversionValueSchemaResult
CustomerSkAdNetworkConversionValueSchema 변경의 결과입니다.
JSON 표현 |
---|
{ "resourceName": string, "appId": string } |
입력란 | |
---|---|
resourceName |
수정된 고객의 리소스 이름입니다. |
appId |
수정된 SkanConversionValue의 앱 ID입니다. |