Method: customers.uploadCallConversions

Przetwarza określone konwersje telefoniczne.

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

Żądanie HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions

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

object (CallConversion)

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.

Treść odpowiedzi

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

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

Zapis JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
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 (CallConversionResult)

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.

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.

CallConversion

Konwersja telefoniczna.

Zapis JSON 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Pola
customVariables[]

object (CustomVariable)

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

object (Consent)

Ustawienie zgody na wykorzystanie danych zdarzenia.
callerId

string

Identyfikator rozmówcy, z którego zostało wykonane to połączenie. Identyfikator rozmówcy powinien mieć format E.164 z poprzedzającym znakiem „+”, np. „+16502531234”.
callStartDateTime

string

Data i godzina połączenia. 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”.
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 przypadać po czasie połączenia. 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.

CallConversionResult

Identyfikacja informacji dla pomyślnie przetworzonych przesyłania konwersji telefonicznych.

Zapis JSON 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Pola
callerId

string

Identyfikator rozmówcy, z którego zostało wykonane to połączenie. Identyfikator rozmówcy powinien być w formacie E.164 z poprzedzającym znakiem „+”.
callStartDateTime

string

Data i godzina połączenia. Format to „rrrr-mm-dd gg:mm:ss+|-gg:mm”, na przykład „2019-01-01 12:32:45-08:00”.
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”.