Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Tworzy lub aktualizuje CustomerSkAdNetworkConversionValueSchema.

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

Żądanie HTTP

POST https://googleads.googleapis.com/v16/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,
  "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 zwracanie ostrzeżeń. Ostrzeżenia zwracają komunikaty o błędach i kody błędów bez blokowania wykonania operacji zmiany.

Treść odpowiedzi

Odpowiedź dotycząca pola 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)

Nieblokujące błędy, które podają szczegóły błędu weryfikacji schematu. Zwracany tylko wtedy, gdy allowWarnings = true.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu 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

CustomerSkAdNetworkConversionValueSchema.

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

string

Tylko dane wyjściowe. Nazwa zasobu schematu. Nazwy zasobów CustomerSkAdNetworkConversionValueSchema mają format: 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)
    }
  ],
  "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 upływie którego firma uczestnicząca w programie App Attribution Partner lub reklamodawca przestaje wywoływać parametr updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Tylko dane wyjściowe. Precyzyjne mapowanie wartości konwersji. W przypadku 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 dla poszczególnych wywołań zwrotnych na potrzeby wywołań zwrotnych w wielu oknach konwersji. Dotyczy tylko SkAdNetwork w wersji 4.0 lub nowszej.

FineGrainedConversionValueMappings

Mapowania 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 to 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

Definiuje 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 parametru event_revenue. 3-literowy kod waluty w standardzie ISO 4217, np. „PLN”.
Pole sumy revenue_rate. Zakres lub konkretną wartość przychodów ze zdarzeń. revenue_rate może być 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 być 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 konkretnych 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. W przypadku zakresów przychodów to minimalna wartość w kolumnie currencyCode, dla której zostanie zmieniona ta wartość konwersji. Wartość 0 jest traktowana jako nieskonfigurowana.
maxEventRevenue

number

Tylko dane wyjściowe. W przypadku zakresów przychodów to maksymalna wartość w kolumnie currencyCode, dla której zostanie zmieniona ta wartość konwersji. Wartość 0 jest traktowana jako nieskonfigurowana.

EventOccurrenceRange

Określa 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 wartość minimalna zdefiniowanego zakresu. Wartość 0 jest traktowana jako nieskonfigurowana.
maxEventCount

string (int64 format)

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

PostbackMapping

Mapowania dla 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 zaczynający się od 0, który wskazuje kolejność wywołań zwrotnych. Prawidłowe wartości mieszczą się w zakresie [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Tylko dane wyjściowe. Mapowanie wartości konwersji w przypadku wszystkich przybliżonych wartości konwersji.
Pole sumy lock_window_trigger. Zdarzenie lub wartość konwersji używane do blokowania okna konwersji. lock_window_trigger może być 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 aktywuje blokadę okna konwersji.

CoarseGrainedConversionValueMappings

Mapowania przybliżonych, szczegółowych wartości konwersji.

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

object (ConversionValueMapping)

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

object (ConversionValueMapping)

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

object (ConversionValueMapping)

Tylko dane wyjściowe. Mapowanie pod kątem „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

Zmodyfikowano identyfikator aplikacji SkanConversionValue.