- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- CallConversion
- CallConversionResult
- Wypróbuj
Przetwarza podane konwersje telefoniczne.
Lista zgłoszonych błędów: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
Żądanie HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
customerId |
To pole jest wymagane. Identyfikator klienta, który przesyła dane. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"conversions": [
{
object ( |
Pola | |
---|---|
conversions[] |
To pole jest wymagane. Konwersje, które są przesyłane. |
partialFailure |
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 |
Jeśli ma wartość true (prawda), żądanie jest weryfikowane, ale nie jest wykonywane. Zwracane są tylko błędy, a nie wyniki. |
Treść odpowiedzi
Odpowiedź na pytanie: ConversionUploadService.UploadCallConversions
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "partialFailureError": { object ( |
Pola | |
---|---|
partialFailureError |
Błędy związane z nieudanymi konwersjami w trybie awarii częściowej. Zwracany, gdy w konwersji 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[] |
Zwrot w przypadku pomyślnie przetworzonych 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. |
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.
CallConversion
Konwersja telefoniczna.
Zapis JSON |
---|
{ "customVariables": [ { object ( |
Pola | |
---|---|
customVariables[] |
Zmienne niestandardowe powiązane z tą konwersją. |
consent |
Ustawienie dotyczące zgody na przetwarzanie danych w przypadku zdarzenia. |
callerId |
Identyfikator rozmówcy, z którego zostało nawiązane połączenie. Identyfikator rozmówcy powinien mieć format E.164 z poprzedzającym znakiem „+”, np. „+16502531234”. |
callStartDateTime |
Data i godzina połączenia. Musisz określić strefę czasową. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”. |
conversionAction |
Nazwa zasobu działania powodującego konwersję powiązanego z tą konwersją. 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ę. |
conversionDateTime |
Data i godzina wystąpienia konwersji. Data musi być późniejsza niż godzina połączenia. Musisz określić strefę czasową. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”. |
conversionValue |
Wartość konwersji dla reklamodawcy. |
currencyCode |
Waluta powiązana z wartością konwersji. 3-znakowy kod waluty zgodny ze standardem ISO 4217. Na przykład: PLN, EUR. |
CallConversionResult
Identyfikacja informacji do pomyślnie przetworzonego przesyłania konwersji CallConversionUpload.
Zapis JSON |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
Pola | |
---|---|
callerId |
Identyfikator rozmówcy, z którego zostało nawiązane połączenie. Identyfikator rozmówcy powinien być w formacie E.164 z poprzedzającym znakiem „+”. |
callStartDateTime |
Data i godzina połączenia. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”. |
conversionAction |
Nazwa zasobu działania powodującego konwersję powiązanego z tą konwersją. |
conversionDateTime |
Data i godzina wystąpienia konwersji. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”. |