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/v17/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

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

Treść żądania

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

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

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Operacja do wykonania.
validateOnly

boolean

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

boolean

Opcjonalnie. Jeśli ma wartość true (prawda), włącza wyświetlanie ostrzeżeń. Ostrzeżenia zwracają komunikaty o błędach i kody błędów bez blokowania wykonywania operacji mutacji.

Treść odpowiedzi

Komunikat z odpowiedzią na żądanie customerSkAdNetworkConversionValueSchemas.mutate.

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

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Wszystkie wyniki dla mutacji.
warning

object (Status)

Błędy nieblokujące, które zawierają szczegóły błędów weryfikacji schematu. Zwracana tylko wtedy, gdy parametr allowOstrzeżenies ma wartość true (prawda).

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

SchematSkAdNetworkConversionValueSchema.

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

string

Tylko dane wyjściowe. Nazwa zasobu schematu. Nazwy zasobówSkAdNetworkConversionValueSchema mają format: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

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

SkAdNetworkConversionValueSchema

Specyficzny dla CustomerLink schemat SkAdNetworkConversionValueSchema.

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

string

Wymagane. Tylko dane wyjściowe. Identyfikator aplikacji w Apple App Store.
measurementWindowHours

integer

Tylko dane wyjściowe. przedział czasu (mierzony w godzinach) po instalacji, po którym partner lub reklamodawca App Attribution Partner przestaje wywoływać metodę updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Tylko dane wyjściowe. Precyzyjne mapowania wartości konwersji. W przypadku wersji SkAdNetwork >= 4.0, które obsługują wiele okien konwersji, szczegółowe mapowanie wartości konwersji ma zastosowanie tylko do pierwszego wywołania zwrotnego.
postbackMappings[]

object (PostbackMapping)

Tylko dane wyjściowe. Mapowania wartości konwersji na wywołanie zwrotne dla wywołań zwrotnych w wielu oknach konwersji. Dotyczy tylko SkAdNetwork w wersji 4.0 lub nowszej.

FineGrainedConversionValueMappings

Mapowania, aby uzyskać szczegółową wartość konwersji.

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

integer

Tylko dane wyjściowe. Szczegółowa wartość konwersji. Prawidłowe wartości należą do zakresu obejmującego [0,63].
conversionValueMapping

object (ConversionValueMapping)

Tylko dane wyjściowe. Zdarzenia konwersji, na które mapowana jest 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że być przypisana do wielu zdarzeń o różnych atrybutach.

Zdarzenie

Definiuje zdarzenie konwersji Google, na które jest zmapowana 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 używana w raportach parametru event_revenue. trzyliterowy kod waluty zgodny ze standardem ISO 4217, np. „PLN”.
Pole sumy revenue_rate. Zakres lub konkretna 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 zdarzenia.
eventRevenueValue

number

Tylko dane wyjściowe. Wartość przychodów z konkretnego zdarzenia.
Pole sumy event_rate. Zakres lub konkretna 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. Dla określonych wartości licznika zdarzeń.

RevenueRange

Definiuje zakres wartości przychodów.

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

number

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

number

Tylko dane wyjściowe. Dla zakresów przychodów maksymalna wartość w currencyCode, w przypadku której ta wartość konwersji zostanie zaktualizowana. 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. Dla zakresów liczników zdarzeń jest to minimalna wartość z zdefiniowanego zakresu. Wartość 0 będzie traktowana jako nieskonfigurowana.
maxEventCount

string (int64 format)

Tylko dane wyjściowe. Maksymalna wartość z zdefiniowanego zakresu dla zakresów licznika zdarzeń. Wartość 0 będzie traktowana jako nieskonfigurowana.

PostbackMapping

Odwzorowania każdego wywołania zwrotnego w wielu oknach konwersji.

Zapis JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
Pola
postbackSequenceIndex

integer

Tylko dane wyjściowe. Indeks z wartością 0, który określa kolejność wywołań zwrotnych. Prawidłowe wartości należą do zakresu [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Tylko dane wyjściowe. Mapowanie wartości wszystkich konwersji o przybliżonej ziarnistości.
Pole sumy lock_window_trigger. Wartość zdarzenia lub konwersji używana do zablokowania okna konwersji. lock_window_trigger może mieć tylko jedną z tych wartości:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Tylko dane wyjściowe. Przybliżona wartość konwersji, która powoduje zablokowanie okna konwersji.
lockWindowFineConversionValue

integer

Tylko dane wyjściowe. Szczegółowa wartość konwersji, która powoduje zablokowanie okna konwersji.
lockWindowEvent

string

Tylko dane wyjściowe. Nazwa zdarzenia, które uruchamia blokadę okna konwersji.

CoarseGrainedConversionValueMappings

Mapowanie wartości konwersji o dużej ziarnistości.

Zapis JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Pola
lowConversionValueMapping

object (ConversionValueMapping)

Tylko dane wyjściowe. Mapowanie „niskiej” przybliżonej wartości konwersji.
mediumConversionValueMapping

object (ConversionValueMapping)

Tylko dane wyjściowe. Mapowanie „średniej” przybliżonej wartości konwersji.
highConversionValueMapping

object (ConversionValueMapping)

Tylko dane wyjściowe. Mapowanie „wysokiej” przybliżonej wartości konwersji.

MutateCustomerSkAdNetworkConversionValueSchemaResult

Wynik mutacji CustomerSkAdNetworkConversionValueSchema.

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

string

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

string

Identyfikator aplikacji w przypadku wartości SkanConversionValue.