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/v15/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,
  "jobId": integer
}
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).
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, API wygeneruje identyfikator zadania z zakresu [2^31, (2^63)-1]. Interfejs API zwróci wartość tego żądania w polu jobId obiektu UploadClickConversionsResponse.

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),
  "consent": {
    object (Consent)
  },
  "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.
consent

object (Consent)

Ustawienie zgody na wykorzystanie danych zdarzenia.
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”.