- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- Wypróbuj
Przetwarza podane dostosowania konwersji.
Lista zgłoszonych błędów: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
Żądanie HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadConversionAdjustments
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 |
---|
{
"conversionAdjustments": [
{
object ( |
Pola | |
---|---|
conversionAdjustments[] |
To pole jest wymagane. Przesłane dostosowania konwersji. |
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. |
jobId |
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, interfejs API wygeneruje identyfikator zadania z zakresu [2^31, (2^63)-1]. Interfejs API zwróci wartość tego żądania w polu |
Treść odpowiedzi
Odpowiedź na pytanie: ConversionAdjustmentUploadService.UploadConversionAdjustments
.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "partialFailureError": { object ( |
Pola | |
---|---|
partialFailureError |
Błędy związane z nieudanymi korektami konwersji w trybie częściowej awarii. Zwracana, gdy w dostosowaniach wystąpią wszystkie błędy. Jeśli jakiekolwiek błędy wystąpią poza korektami (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[] |
Zwracany w przypadku pomyślnie przetworzonych dostosowań 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. |
jobId |
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 omówieniu protokołu OAuth 2.0.
ConversionAdjustment
Korekta konwersji.
Zapis JSON |
---|
{ "gclidDateTimePair": { object ( |
Pola | |
---|---|
gclidDateTimePair |
W przypadku dostosowań jednoznacznie identyfikuje konwersję, która została zgłoszona bez określonego identyfikatora zamówienia. Jeśli parametr „AdjustType” ma wartość ENHANCEMENT, ta wartość jest opcjonalna, ale można ją ustawić oprócz parametru orderId. |
adjustmentType |
Typ korekty. |
restatementValue |
Informacje potrzebne do zmiany wartości konwersji. Wymagane w przypadku zmian wartości. Nie należy podawać w przypadku wycofania. Jeśli podasz informację o wycofaniu, wyświetli się komunikat o błędzie. UWAGA: jeśli chcesz przesłać drugą zmianę wartości z inną poprawioną wartością, musisz podać w niej nowy czas wystąpienia korekty. W przeciwnym razie zostanie potraktowana jako duplikat poprzedniej zmiany i zignorowana. |
userIdentifiers[] |
Identyfikatory użytkowników, które ulepszają pierwotną konwersję. Usługa ConversionConversionUploadService akceptuje w ulepszeniach tylko identyfikatory użytkowników. Maksymalna liczba identyfikatorów użytkowników w przypadku każdego ulepszenia to 5. |
orderId |
Identyfikator konwersji do dostosowania. Jeśli konwersja została zarejestrowana z określonym identyfikatorem zamówienia, należy użyć tego identyfikatora jako identyfikatora zamówienia. W przypadku ulepszeń wymagany jest identyfikator zamówienia. |
conversionAction |
Nazwa zasobu działania powodującego konwersję powiązanego z tym dostosowaniem konwersji. 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ę. |
adjustmentDateTime |
Data i godzina korekty. Data musi być późniejsza niż data conversionDateTime. Musisz określić strefę czasową. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”. |
userAgent |
Klient użytkownika, który ma na celu ulepszenie pierwotnej konwersji. Kod ten można znaleźć w nagłówku żądania HTTP użytkownika, gdy dokona on konwersji na Twojej stronie internetowej. Przykład: „Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)” klienta użytkownika można określić tylko w rozszerzeniach za pomocą identyfikatorów użytkownika. Powinien on odpowiadać klientowi użytkownika, z którego pochodzi żądanie, z którego została wysłana pierwotna konwersja. Dzięki temu zarówno konwersja, jak i jej ulepszenie zostaną przypisane do tego samego urządzenia lub do konwersji na różnych urządzeniach. |
GclidDateTimePair
Jednoznacznie identyfikuje konwersję, która została zgłoszona bez określonego identyfikatora zamówienia.
Zapis JSON |
---|
{ "gclid": string, "conversionDateTime": string } |
Pola | |
---|---|
gclid |
Identyfikator kliknięcia Google (gclid) powiązany z pierwotną konwersją dla tego dostosowania. |
conversionDateTime |
Data i godzina wystąpienia pierwotnej konwersji związanej z tym dostosowaniem. Musisz określić strefę czasową. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”. |
ConversionAdjustmentType
Różne działania, jakie mogą podjąć reklamodawcy, aby dostosować konwersje, które już zgłaszali. Wycofanie oznacza konwersję. Zmiany wartości konwersji zmieniają wartość konwersji.
Wartości w polu enum | |
---|---|
UNSPECIFIED |
Nie określono. |
UNKNOWN |
Reprezentuje wartość nieznaną w tej wersji. |
RETRACTION |
Zwraca ujemną wartość konwersji do zera, przez co jej łączna wartość i liczba równa się zero. |
RESTATEMENT |
Zmienia wartość konwersji. |
ENHANCEMENT |
Uzupełnia istniejącą konwersję o podane identyfikatory użytkownika i klienta użytkownika, których Google może użyć do zwiększenia liczby konwersji. |
RestatementValue
Zawiera informacje potrzebne do zmiany wartości konwersji.
Zapis JSON |
---|
{ "adjustedValue": number, "currencyCode": string } |
Pola | |
---|---|
adjustedValue |
Przekształcona wartość konwersji. To jest wartość konwersji po zmianie wartości konwersji. Aby np. zmienić wartość konwersji ze 100 na 70, w raportach należy podać skorygowaną wartość 70. UWAGA: jeśli chcesz przesłać drugą zmianę wartości z inną poprawioną wartością, musisz podać w niej nowy czas wystąpienia korekty. W przeciwnym razie zostanie potraktowana jako duplikat poprzedniej zmiany i zignorowana. |
currencyCode |
Waluta zmienionej wartości. Jeśli nie zostanie podana, używana będzie waluta domyślna z działania powodującego konwersję. Jeśli nie jest ustawiona, użyjemy waluty konta. To 3-znakowy kod waluty zgodny z normą ISO 4217, np. PLN lub EUR. |
ConversionAdjustmentResult
Informacje identyfikujące pomyślnie przetworzone dostosowanie konwersji.
Zapis JSON |
---|
{ "gclidDateTimePair": { object ( |
Pola | |
---|---|
gclidDateTimePair |
Identyfikator kliknięcia Google oraz data i godzina konwersji. |
orderId |
Identyfikator konwersji do dostosowania. |
adjustmentType |
Typ korekty. |
conversionAction |
Nazwa zasobu działania powodującego konwersję powiązanego z tym dostosowaniem konwersji. |
adjustmentDateTime |
Data i godzina korekty. Format to „rrrr-mm-dd hh:mm:ss+|-gg:mm”, np. „2019-01-01 12:32:45-08:00”. |