Method: customers.uploadConversionAdjustments

Przetwarza podane dostosowania konwersji.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Żądanie HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadConversionAdjustments

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta, który przesyła dane.

Treść żądania

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

Zapis JSON 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
Pola
conversionAdjustments[]

object (ConversionAdjustment)

To pole jest wymagane. Przesłane dostosowania konwersji.
partialFailure

boolean

To pole jest wymagane. Jeśli ma wartość true (prawda), udane operacje będą wykonywane, a nieprawidłowe – zwrócą błędy. Jeśli ma wartość false (fałsz), wszystkie operacje są wykonywane w ramach jednej transakcji i tylko wtedy, gdy są prawidłowe. To pole zawsze powinno mieć wartość Prawda. Więcej informacji o częściowych błędach znajdziesz na stronie https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
validateOnly

boolean

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

integer

Opcjonalnie. Opcjonalne dane wejściowe ustawienia identyfikatora zadania. Musi być liczbą nieujemną, mniejszą niż 2^31, jeśli została podana. Jeśli to pole nie zostanie podane, interfejs API wygeneruje identyfikator zadania z zakresu [2^31, (2^63)-1]. Interfejs API zwróci wartość tego żądania w polu jobId UploadConversionAdjustmentsResponse.

Treść odpowiedzi

Odpowiedź na pytanie: ConversionAdjustmentUploadService.UploadConversionAdjustments.

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

Zapis JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
Pola
partialFailureError

object (Status)

Błędy związane z nieudanymi korektami konwersji w trybie częściowej awarii. Zwracana, gdy w dostosowaniach wystąpią wszystkie błędy. Jeśli jakiekolwiek błędy wystąpią poza korektami (np. błędy uwierzytelniania), zwrócimy błąd na poziomie RPC. Więcej informacji o częściowych błędach znajdziesz na stronie https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
results[]

object (ConversionAdjustmentResult)

Zwracany w przypadku pomyślnie przetworzonych dostosowań konwersji. Pole Proto będzie puste w przypadku wierszy, w których wystąpił błąd. Gdy sprawdzanie poprawności ma wartość true (prawda), wyniki nie są zwracane.
jobId

string (int64 format)

Identyfikator zadania dla przesyłanej partii.

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.

ConversionAdjustment

Korekta konwersji.

Zapis JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Pola
gclidDateTimePair

object (GclidDateTimePair)

W przypadku dostosowań jednoznacznie identyfikuje konwersję, która została zgłoszona bez określonego identyfikatora zamówienia. Jeśli parametr „AdjustType” ma wartość ENHANCEMENT, ta wartość jest opcjonalna, ale można ją ustawić oprócz parametru orderId.
adjustmentType

enum (ConversionAdjustmentType)

Typ korekty.
restatementValue

object (RestatementValue)

Informacje potrzebne do zmiany wartości konwersji. Wymagane w przypadku zmian wartości. Nie należy podawać w przypadku wycofania. Jeśli podasz informację o wycofaniu, wyświetli się komunikat o błędzie. UWAGA: jeśli chcesz przesłać drugą zmianę wartości z inną poprawioną wartością, musisz podać w niej nowy czas wystąpienia korekty. W przeciwnym razie zostanie potraktowana jako duplikat poprzedniej zmiany i zignorowana.
userIdentifiers[]

object (UserIdentifier)

Identyfikatory użytkowników, które ulepszają pierwotną konwersję. Usługa ConversionConversionUploadService akceptuje w ulepszeniach tylko identyfikatory użytkowników. Maksymalna liczba identyfikatorów użytkowników w przypadku każdego ulepszenia to 5.
orderId

string

Identyfikator konwersji do dostosowania. Jeśli konwersja została zarejestrowana z określonym identyfikatorem zamówienia, należy użyć tego identyfikatora jako identyfikatora zamówienia. W przypadku ulepszeń wymagany jest identyfikator zamówienia.
conversionAction

string

Nazwa zasobu działania powodującego konwersję powiązanego z tym dostosowaniem konwersji. Uwaga: mimo że nazwa zasobu składa się z identyfikatora klienta i identyfikatora działania powodującego konwersję, weryfikacja zignoruje identyfikator klienta i użyje identyfikatora działania powodującego konwersję jako jedynego identyfikatora działania powodującego konwersję.
adjustmentDateTime

string

Data i godzina korekty. Data musi być późniejsza niż data conversionDateTime. Musisz określić strefę czasową. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”.
userAgent

string

Klient użytkownika, który ma na celu ulepszenie pierwotnej konwersji. Kod ten można znaleźć w nagłówku żądania HTTP użytkownika, gdy dokona on konwersji na Twojej stronie internetowej. Przykład: „Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)” klienta użytkownika można określić tylko w rozszerzeniach za pomocą identyfikatorów użytkownika. Powinien on odpowiadać klientowi użytkownika, z którego pochodzi żądanie, z którego została wysłana pierwotna konwersja. Dzięki temu zarówno konwersja, jak i jej ulepszenie zostaną przypisane do tego samego urządzenia lub do konwersji na różnych urządzeniach.

GclidDateTimePair

Jednoznacznie identyfikuje konwersję, która została zgłoszona bez określonego identyfikatora zamówienia.

Zapis JSON 
{
  "gclid": string,
  "conversionDateTime": string
}
Pola
gclid

string

Identyfikator kliknięcia Google (gclid) powiązany z pierwotną konwersją dla tego dostosowania.
conversionDateTime

string

Data i godzina wystąpienia pierwotnej konwersji związanej z tym dostosowaniem. Musisz określić strefę czasową. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”.

ConversionAdjustmentType

Różne działania, jakie mogą podjąć reklamodawcy, aby dostosować konwersje, które już zgłaszali. Wycofanie oznacza konwersję. Zmiany wartości konwersji zmieniają wartość konwersji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Reprezentuje wartość nieznaną w tej wersji.
RETRACTION Zwraca ujemną wartość konwersji do zera, przez co jej łączna wartość i liczba równa się zero.
RESTATEMENT Zmienia wartość konwersji.
ENHANCEMENT Uzupełnia istniejącą konwersję o podane identyfikatory użytkownika i klienta użytkownika, których Google może użyć do zwiększenia liczby konwersji.

RestatementValue

Zawiera informacje potrzebne do zmiany wartości konwersji.

Zapis JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
Pola
adjustedValue

number

Przekształcona wartość konwersji. To jest wartość konwersji po zmianie wartości konwersji. Aby np. zmienić wartość konwersji ze 100 na 70, w raportach należy podać skorygowaną wartość 70. UWAGA: jeśli chcesz przesłać drugą zmianę wartości z inną poprawioną wartością, musisz podać w niej nowy czas wystąpienia korekty. W przeciwnym razie zostanie potraktowana jako duplikat poprzedniej zmiany i zignorowana.
currencyCode

string

Waluta zmienionej wartości. Jeśli nie zostanie podana, używana będzie waluta domyślna z działania powodującego konwersję. Jeśli nie jest ustawiona, użyjemy waluty konta. To 3-znakowy kod waluty zgodny z normą ISO 4217, np. PLN lub EUR.

ConversionAdjustmentResult

Informacje identyfikujące pomyślnie przetworzone dostosowanie konwersji.

Zapis JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Pola
gclidDateTimePair

object (GclidDateTimePair)

Identyfikator kliknięcia Google oraz data i godzina konwersji.
orderId

string

Identyfikator konwersji do dostosowania.
adjustmentType

enum (ConversionAdjustmentType)

Typ korekty.
conversionAction

string

Nazwa zasobu działania powodującego konwersję powiązanego z tym dostosowaniem konwersji.
adjustmentDateTime

string

Data i godzina korekty. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”.