Method: customers.uploadClickConversions

Przetwarza określone konwersje po kliknięciu.

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

Żądanie HTTP

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

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 
{
  "conversions": [
    {
      object (ClickConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "debugEnabled": boolean
}
Pola
conversions[]

object (ClickConversion)

To pole jest wymagane. Konwersje, 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.
debugEnabled

boolean

Jeśli ma wartość true (prawda), API będzie przeprowadzać wszystkie kontrole przesyłania i zwracać ewentualne błędy. Jeśli zasada ma wartość false (fałsz), przeprowadzana jest tylko podstawowa weryfikacja danych wejściowych, pomija kolejne testy przesyłania i zwraca powodzenie, nawet jeśli dla określonego parametru userIdentifiers nie znaleziono żadnego kliknięcia.

To ustawienie wpływa tylko na konwersje rozszerzone w przypadku przesyłania danych o potencjalnych klientach, które korzystają z metody userIdentifiers zamiast GCLID, GBRAID lub WBRAID. Podczas przesyłania konwersji rozszerzonych dotyczących potencjalnych klientów należy przesyłać do interfejsu API wszystkie zdarzenia konwersji, w tym te, które nie pochodzą z kampanii Google Ads. Jeśli to pole ma wartość true, przesłanie zdarzenia, które nie pochodzi z kampanii Google Ads, spowoduje błąd CLICK_NOT_FOUND. Te błędy są zjawiskiem normalnym w przypadku takich zdarzeń, dlatego ustaw w tym polu wartość false, aby mieć pewność, że przesyłane pliki są prawidłowo sformatowane, ale ignorować błędy (CLICK_NOT_FOUND) pochodzące ze wszystkich konwersji, które nie pochodzą z kampanii Google Ads. Pozwoli Ci to skupić się tylko na błędach, które możesz naprawić.

Wartość domyślna to false (fałsz).

Treść odpowiedzi

Wiadomość z odpowiedzią na temat: ConversionUploadService.UploadClickConversions.

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

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

object (Status)

Błędy dotyczące niepowodzeń konwersji w trybie częściowej awarii. Zwracany, gdy w konwersjach wystąpią wszystkie błędy. Jeśli jakiekolwiek błędy wystąpią poza konwersjami (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 (ClickConversionResult)

Zwracana w przypadku poprawnie przetworzonych 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.

ClickConversion

Konwersja po kliknięciu.

Zapis JSON 
{
  "gbraid": string,
  "wbraid": string,
  "externalAttributionData": {
    object (ExternalAttributionData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "cartData": {
    object (CartData)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "conversionEnvironment": enum (ConversionEnvironment),
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string,
  "orderId": string
}
Pola
gbraid

string

Identyfikator kliknięcia w przypadku kliknięć powiązanych z konwersjami w aplikacji i pochodzących z urządzeń z iOS od systemu iOS 14.
wbraid

string

Identyfikator kliknięcia w przypadku kliknięć powiązanych z konwersjami w witrynie i pochodzących z urządzeń z iOS od systemu iOS 14.
externalAttributionData

object (ExternalAttributionData)

Dodatkowe dane o konwersjach przypisanych zewnętrznie. To pole jest wymagane w przypadku konwersji z działaniem powodującym konwersję przypisanym zewnętrznie, ale nie powinno być ustawione inaczej.
customVariables[]

object (CustomVariable)

Zmienne niestandardowe powiązane z tą konwersją.
cartData

object (CartData)

Dane koszyka powiązane z tą konwersją.
userIdentifiers[]

object (UserIdentifier)

Identyfikatory użytkownika powiązane z tą konwersją. W przypadku przesyłania konwersji obsługiwane są tylko wartości hashedEmail i hashedPhoneNumber. Maksymalna liczba identyfikatorów użytkownika na każdą konwersję wynosi 5.
conversionEnvironment

enum (ConversionEnvironment)

Środowisko, w którym zarejestrowano tę konwersję, np. aplikacja lub internet.
gclid

string

Identyfikator kliknięcia Google (gclid) powiązany z tą konwersją.
conversionAction

string

Nazwa zasobu działania powodującego konwersję powiązanego z tą konwersją. 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ę.
conversionDateTime

string

Data i godzina wystąpienia konwersji. Musi być późniejsza niż czas kliknięcia. 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”.
conversionValue

number

Wartość konwersji dla reklamodawcy.
currencyCode

string

Waluta powiązana z wartością konwersji. Jest to 3-znakowy kod waluty zgodny z normą ISO 4217. Na przykład: PLN, EUR.
orderId

string

Identyfikator zamówienia powiązany z konwersją. Identyfikatora zamówienia można użyć tylko dla jednej konwersji na działanie powodujące konwersję.

ExternalAttributionData

Zawiera dodatkowe informacje o konwersjach przypisanych zewnętrznie.

Zapis JSON 
{
  "externalAttributionCredit": number,
  "externalAttributionModel": string
}
Pola
externalAttributionCredit

number

Odzwierciedla odsetek konwersji przypisanych do kliknięcia Google Ads.
externalAttributionModel

string

Określa nazwę modelu atrybucji.

CartData

Zawiera dodatkowe informacje o danych koszyka.

Zapis JSON 
{
  "merchantId": string,
  "feedCountryCode": string,
  "feedLanguageCode": string,
  "localTransactionCost": number,
  "items": [
    {
      object (Item)
    }
  ]
}
Pola
merchantId

string (int64 format)

Identyfikator w Merchant Center, na które przesyłane są produkty.
feedCountryCode

string

Kod kraju powiązany z plikiem danych, w którym przesyłane są produkty.
feedLanguageCode

string

Kod języka powiązany z plikiem danych, w którym przesyłane są produkty.
localTransactionCost

number

Suma wszystkich rabatów na poziomie transakcji, takich jak bezpłatna dostawa i rabaty na kupon na cały koszyk. Kod waluty jest taki sam jak w wiadomości ClickConversion.
items[]

object (Item)

Dane kupionych produktów.

Element

Zawiera dane na temat kupionych produktów.

Zapis JSON 
{
  "productId": string,
  "quantity": integer,
  "unitPrice": number
}
Pola
productId

string

Identyfikator zakupu produktu. Musi być taka sama jak identyfikator produktu w Merchant Center.
quantity

integer

Liczba sprzedanych przedmiotów.
unitPrice

number

Cena jednostkowa bez podatku, dostawy i wszelkich rabatów na poziomie transakcji. Kod waluty jest taki sam jak w wiadomości ClickConversion.

ConversionEnvironment

Środowisko konwersji przesłanej konwersji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
APP Konwersja została zarejestrowana w aplikacji.
WEB Konwersja została zarejestrowana w witrynie.

ClickConversionResult

Identyfikacja informacji o pomyślnie przetworzonej konwersji ClickConversion.

Zapis JSON 
{
  "gbraid": string,
  "wbraid": string,
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Pola
gbraid

string

Identyfikator kliknięcia w przypadku kliknięć powiązanych z konwersjami w aplikacji i pochodzących z urządzeń z iOS od systemu iOS 14.
wbraid

string

Identyfikator kliknięcia w przypadku kliknięć powiązanych z konwersjami w witrynie i pochodzących z urządzeń z iOS od systemu iOS 14.
userIdentifiers[]

object (UserIdentifier)

Identyfikatory użytkownika powiązane z tą konwersją. W przypadku przesyłania konwersji obsługiwane są tylko wartości hashedEmail i hashedPhoneNumber. Maksymalna liczba identyfikatorów użytkownika na każdą konwersję wynosi 5.
gclid

string

Identyfikator kliknięcia Google (gclid) powiązany z tą konwersją.
conversionAction

string

Nazwa zasobu działania powodującego konwersję powiązanego z tą konwersją.
conversionDateTime

string

Data i godzina wystąpienia konwersji. Format to „rrrr-mm-dd gg:mm:ss+|-gg:mm”, na przykład „2019-01-01 12:32:45-08:00”.