Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Tworzy lub aktualizuje obiekt CustomerSkAdNetworkConversionValueSchema.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError FieldError InternalError MutateError.

Żądanie HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

Identyfikator klienta, którego wspólne zestawy są modyfikowane.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
Pola
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Operacja do wykonania.
validateOnly

boolean

Jeśli ma wartość true (prawda), żądanie jest sprawdzane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.

Treść odpowiedzi

Komunikat z odpowiedzią na temat customerSkAdNetworkConversionValueSchemas.mutate.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
Pola
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Wszystkie wyniki dla mutacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Pojedyncza operacja aktualizacji obiektu CustomerSkAdNetworkConversionValueSchema.

Zapis JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Pola
update

object (CustomerSkAdNetworkConversionValueSchema)

Operacja aktualizacji: schemat powinien mieć prawidłową nazwę zasobu.

CustomerSkAdNetworkConversionValueSchema

Obiekt CustomerSkAdNetworkConversionValueSchema.

Zapis JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Pola
resourceName

string

Tylko dane wyjściowe. Nazwa zasobu schematu. Nazwy zasobów CustomerSkAdNetworkConversionValueSchema mają postać: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

Tylko dane wyjściowe. Schemat określonego zasobu.

SkAdNetworkConversionValueSchema

Specyficzny dla obiektu CustomerLink SkAdNetworkConversionValueSchema.

Zapis JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
Pola
appId

string

To pole jest wymagane. Tylko dane wyjściowe. Identyfikator aplikacji Apple App Store.
measurementWindowHours

integer

Tylko dane wyjściowe. Przedział czasu (mierzony w godzinach) po instalacji, po upływie którego partner uczestniczący w programie App Attribution Partner lub reklamodawca przestaje wywoływać parametr updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Tylko dane wyjściowe. Szczegółowe mapowanie wartości konwersji.

FineGrainedConversionValueMappings

Mapowanie szczegółowej wartości konwersji.

Zapis JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Pola
fineGrainedConversionValue

integer

Tylko dane wyjściowe. Szczegółowa wartość konwersji. Prawidłowe wartości mieszczą się w zakresie [0,63].
conversionValueMapping

object (ConversionValueMapping)

Tylko dane wyjściowe. Zdarzenia konwersji, na które jest przypisana szczegółowa wartość konwersji.

ConversionValueMapping

Reprezentuje mapowanie z jednej wartości konwersji na co najmniej 1 zdarzenie konwersji.

Zapis JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Pola
minTimePostInstallHours

string (int64 format)

Tylko dane wyjściowe. Minimalny zakres czasu, w którym użytkownik był ostatnio aktywny w okresie pomiaru.
maxTimePostInstallHours

string (int64 format)

Tylko dane wyjściowe. Maksymalny zakres czasu, w którym użytkownik był ostatnio aktywny w okresie pomiaru.
mappedEvents[]

object (Event)

Tylko dane wyjściowe. Wartość konwersji można zmapować na wiele zdarzeń o różnych atrybutach.

Zdarzenie

Określa zdarzenie konwersji Google, na które jest mapowana wartość konwersji.

Zapis JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
Pola
mappedEventName

string

Tylko dane wyjściowe. Nazwa zdarzenia Google reprezentowana przez tę wartość konwersji.
currencyCode

string

Tylko dane wyjściowe. Waluta w raportach dotycząca parametru event_revenue. Trzyliterowy kod waluty w standardzie ISO 4217, np. „PLN”
Pole sumy revenue_rate. Podaj zakres lub konkretną wartość przychodów ze zdarzeń. revenue_rate może mieć tylko jedną z tych wartości:
eventRevenueRange

object (RevenueRange)

Tylko dane wyjściowe. Zakres przychodów ze zdarzeń.
eventRevenueValue

number

Tylko dane wyjściowe. Wartość przychodów z konkretnego zdarzenia.
Pole sumy event_rate. Zakres lub konkretną wartość licznika zdarzeń. event_rate może mieć tylko jedną z tych wartości:
eventOccurrenceRange

object (EventOccurrenceRange)

Tylko dane wyjściowe. Zakres licznika zdarzeń.
eventCounter

string (int64 format)

Tylko dane wyjściowe. Określa wartości licznika zdarzeń.

RevenueRange

Określa zakres wartości przychodów.

Zapis JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Pola
minEventRevenue

number

Tylko dane wyjściowe. Dla zakresów przychodów: minimalna wartość w currencyCode, dla której zostanie zaktualizowana ta wartość konwersji. Wartość 0 będzie traktowana jako nieskonfigurowana.
maxEventRevenue

number

Tylko dane wyjściowe. Dla zakresów przychodów: maksymalna wartość w currencyCode, dla której zostanie zaktualizowana ta wartość konwersji. Wartość 0 będzie traktowana jako nieskonfigurowana.

EventOccurrenceRange

Definiuje zakres wartości licznika zdarzeń.

Zapis JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
Pola
minEventCount

string (int64 format)

Tylko dane wyjściowe. W przypadku zakresów licznika zdarzeń jest to minimalna wartość z zdefiniowanego zakresu. Wartość 0 będzie traktowana jako nieskonfigurowana.
maxEventCount

string (int64 format)

Tylko dane wyjściowe. W przypadku zakresów licznika zdarzeń jest to maksymalna wartość z zdefiniowanego zakresu. Wartość 0 będzie traktowana jako nieskonfigurowana.

MutateCustomerSkAdNetworkConversionValueSchemaResult

Wynik mutacji CustomerSkAdNetworkConversionValueSchema.

Zapis JSON 
{
  "resourceName": string,
  "appId": string
}
Pola
resourceName

string

Nazwa zasobu klienta, który został zmodyfikowany.
appId

string

Zmodyfikowano identyfikator aplikacji SkanConversionValue.