Method: customers.uploadConversionAdjustments

Przetwarza podane korekty konwersji.

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta dokonującego przesyłania.

Treść żądania

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

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

object (ConversionAdjustment)

To pole jest wymagane. Dostosowania konwersji, które są przesyłane.
partialFailure

boolean

To pole jest wymagane. Jeśli wartość to prawda, udane operacje będą wykonywane, a nieprawidłowe – będą zwracać błędy. Jeśli ma wartość false (fałsz), wszystkie operacje będą przeprowadzane w ramach jednej transakcji tylko wtedy, gdy będą 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 sprawdzane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: 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. Zwracany, gdy w dostosowaniach wystąpią wszystkie błędy. Jeśli wystąpią błędy poza korektami (na przykład błędy uwierzytelniania), zwracamy 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)

Zwracana w przypadku poprawnie przetworzonych dostosowań konwersji. 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 artykule Omówienie 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 jest ustawiony na ENHANCEMENT, ta wartość jest opcjonalna, ale można ją ustawić razem z parametrem 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 prośbę o wycofanie, wyświetli się komunikat o błędzie. UWAGA: jeśli chcesz przesłać drugą zmianę 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żytkownika służące do ulepszania pierwotnej konwersji. ConversionConversionUploadService akceptuje tylko identyfikatory użytkowników w ulepszeniach. Maksymalna liczba identyfikatorów użytkownika na każde ulepszenie to 5.
orderId

string

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

string

Nazwa zasobu działania powodującego konwersję powiązanego z tym dostosowaniem konwersji. Uwaga: chociaż ta 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 wprowadzenia korekty. Musi być późniejsza niż wartość conversionDateTime. Strefa czasowa musi być określona. Format to „rrrr-mm-dd gg:mm:ss+|-gg:mm”, na przykład „2019-01-01 12:32:45-08:00”.
userAgent

string

Klient użytkownika, który ulepsza pierwotną konwersję. Numer 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ślać tylko w ulepszeniach za pomocą identyfikatorów użytkownika. Powinien on odpowiadać klientowi użytkownika użytemu w żądaniu, z którego pochodziła pierwotna konwersja. Dzięki temu zarówno konwersja, jak i jej ulepszenie zostaną przypisane do tego samego urządzenia lub jako pochodzące z różnych urządzeń.

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, w których miała miejsce pierwotna konwersja związana z tym dostosowaniem. Strefa czasowa musi być określona. Format to „rrrr-mm-dd gg:mm:ss+|-gg:mm”, na przykład „2019-01-01 12:32:45-08:00”.

ConversionAdjustmentType

Różne działania, które mogą podejmować reklamodawcy, aby dostosować konwersje już raportowane. Wycofanie oznacza konwersję. Zmiany wartości konwersji powodują zmianę wartości konwersji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Reprezentuje wartość nieznaną w tej wersji.
RETRACTION Wyklucza konwersję w taki sposób, że zarówno jej łączna wartość, jak i liczba wynosi 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ć, aby zwiększyć liczbę 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, należy zgłosić skorygowaną wartość 70. UWAGA: jeśli chcesz przesłać drugą zmianę 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 wartość nie zostanie podana, użyjemy waluty domyślnej z działania powodującego konwersję, a jeśli ta wartość nie jest określona, używana jest waluta konta. Jest to 3-znakowy kod waluty zgodny z normą ISO 4217, np. USD lub EUR.

ConversionAdjustmentResult

Informacje identyfikujące przetworzono 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 zamówienia 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 wprowadzenia korekty. Format to „rrrr-mm-dd gg:mm:ss+|-gg:mm”, na przykład „2019-01-01 12:32:45-08:00”.