- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- CallConversion
- CallConversionResult
- Wypróbuj
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 |
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 ( |
Pola | |
---|---|
conversions[] |
To pole jest wymagane. Konwersje, które są przesyłane. |
partialFailure |
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 |
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 ( |
Pola | |
---|---|
partialFailureError |
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[] |
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 ( |
Pola | |
---|---|
customVariables[] |
Zmienne niestandardowe powiązane z tą konwersją. |
consent |
Ustawienie zgody na wykorzystanie danych zdarzenia. |
callerId |
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 |
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 |
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 |
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 |
Wartość konwersji dla reklamodawcy. |
currencyCode |
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 |
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 |
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 |
Nazwa zasobu działania powodującego konwersję powiązanego z tą konwersją. |
conversionDateTime |
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”. |