Uwaga: przeglądasz dokumentację interfejsu REST interfejsu API. Większość oficjalnych bibliotek klienta używa gRPC. Więcej informacji znajdziesz we wprowadzeniu do REST.

Ta strona została przetłumaczona przez Cloud Translation API.

OfflineUserDataJob

Zapis JSON
OfflineUserDataJobType
OfflineUserDataJobStatus
OfflineUserDataJobFailureReason
OfflineUserDataJobMetadata
- Zapis JSON
OfflineUserDataJobMatchRateRange
StoreSalesMetadata
- Zapis JSON
StoreSalesThirdPartyMetadata (Metadane firmy zewnętrznej w sklepie)
- Zapis JSON

Zadanie zawierające dane offline użytkowników odwiedzających sklep lub członków listy użytkowników, które będą przetwarzane asynchronicznie. Przesłane dane nie są czytelne, a wyniki przetwarzania zadania można odczytać tylko za pomocą usługi GoogleAdsService.Search/SearchStream.

Zapis JSON

Zapis JSON
{ "resourceName": string, "type": enum (`OfflineUserDataJobType`), "status": enum (`OfflineUserDataJobStatus`), "failureReason": enum (`OfflineUserDataJobFailureReason`), "operationMetadata": { object (`OfflineUserDataJobMetadata`) }, "id": string, "externalId": string, // Union field `metadata` can be only one of the following: "customerMatchUserListMetadata": { object (`CustomerMatchUserListMetadata`) }, "storeSalesMetadata": { object (`StoreSalesMetadata`) } // End of list of possible types for union field `metadata`. }

{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}

Pola
`resourceName`	`string` Niezmienne. Nazwa zasobu zadania dotyczącego danych użytkownika offline. Nazwy zasobów zadań dotyczących danych użytkowników offline mają postać: `customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}`
`type`	`enum (OfflineUserDataJobType)` Niezmienne. Typ zlecenia.
`status`	`enum (OfflineUserDataJobStatus)` Tylko dane wyjściowe. Stan zadania.
`failureReason`	`enum (OfflineUserDataJobFailureReason)` Tylko dane wyjściowe. Przyczyna niepowodzenia przetwarzania, jeśli stan to BŁĄD.
`operationMetadata`	`object (OfflineUserDataJobMetadata)` Tylko dane wyjściowe. Metadane zadania dotyczącego danych użytkownika offline przedstawiającego zakres współczynnika dopasowania.
`id`	`string (int64 format)` Tylko dane wyjściowe. Identyfikator tego zadania dotyczącego danych użytkownika offline.
`externalId`	`string (int64 format)` Niezmienne. Identyfikator zadania określony przez użytkownika.
Pole sumy `metadata`. Metadane zadania. `metadata` może mieć tylko jedną z tych wartości:
`customerMatchUserListMetadata`	`object (CustomerMatchUserListMetadata)` Niezmienne. Metadane aktualizacji danych na liście użytkowników w systemie CRM.
`storeSalesMetadata`	`object (StoreSalesMetadata)` Niezmienne. Metadane związane z aktualizacją danych o sprzedaży w sklepie.

OfflineUserDataJobType

Typ zadania dotyczącego danych użytkownika offline.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`STORE_SALES_UPLOAD_FIRST_PARTY`	Dane dotyczące sprzedaży bezpośredniej w sklepie do użytku samoobsługowego.
`STORE_SALES_UPLOAD_THIRD_PARTY`	Dane sprzedaży bezpośredniej w sklepie dla firm zewnętrznych.
`CUSTOMER_MATCH_USER_LIST`	Dane listy użytkowników kierowania na listę klientów.
`CUSTOMER_MATCH_WITH_ATTRIBUTES`	Kierowanie na listę klientów na podstawie danych atrybutów.

OfflineUserDataJobStatus

Stan zadania offline dotyczącego danych użytkownika.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`PENDING`	Zadanie zostało utworzone i oczekuje na przesłanie.
`RUNNING`	Przesłane pliki zostały zaakceptowane, a dane są przetwarzane.
`SUCCESS`	Przesłane dane zostały przetworzone.
`FAILED`	Nie udało się przetworzyć przesłanych danych.

OfflineUserDataJobFailureReason

Przyczyna niepowodzenia zadania offline dot. danych użytkownika.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
`INSUFFICIENT_MATCHED_TRANSACTIONS`	Dopasowane transakcje są niewystarczające.
`INSUFFICIENT_TRANSACTIONS`	Przesłane transakcje są niewystarczające.
`HIGH_AVERAGE_TRANSACTION_VALUE`	Średnia wartość transakcji na Twoim koncie jest wyjątkowo wysoka. Jeśli było to zamierzone, skontaktuj się z zespołem pomocy, aby poprosić o zrobienie wyjątku. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/10018944#transaction_value.
`LOW_AVERAGE_TRANSACTION_VALUE`	Średnia wartość transakcji na Twoim koncie jest wyjątkowo niska. Jeśli było to zamierzone, skontaktuj się z zespołem pomocy, aby poprosić o zrobienie wyjątku. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/10018944#transaction_value.
`NEWLY_OBSERVED_CURRENCY_CODE`	Jest w nim kod waluty, który nie był wcześniej używany w przesyłanych filmach. Jeśli było to zamierzone, skontaktuj się z zespołem pomocy, aby poprosić o zrobienie wyjątku. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/10018944#Unrecognized_currency

OfflineUserDataJobMetadata

Metadane zadania dotyczącego danych użytkowników offline.

Zapis JSON
{ "matchRateRange": enum (`OfflineUserDataJobMatchRateRange`) }

Pola

matchRateRange

enum (OfflineUserDataJobMatchRateRange)

Tylko dane wyjściowe. Współczynnik dopasowania przesłanej listy użytkowników z kierowania na listę klientów. Opisuje szacowany współczynnik dopasowania, gdy stan zadania to „URUCHOMIONE”, oraz końcowy współczynnik dopasowania, gdy ostateczny współczynnik dopasowania jest dostępny, gdy stan zadania to „UDAŁO SIĘ/NIE UDAŁO SIĘ” ZROBIĆ.

OfflineUserDataJobMatchRateRange

Zakres współczynnika dopasowania zadania dotyczącego danych użytkowników offline.

Wartości w polu enum
`UNSPECIFIED`	Nie określono.
`UNKNOWN`	Wartość domyślna zakresu współczynnika dopasowania.
`MATCH_RANGE_LESS_THAN_20`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 0% do 19%.
`MATCH_RANGE_20_TO_30`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 20% do 30%.
`MATCH_RANGE_31_TO_40`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 31% do 40%.
`MATCH_RANGE_41_TO_50`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 41% do 50%.
`MATCH_RANGE_51_TO_60`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 51% do 60%.
`MATCH_RANGE_61_TO_70`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 61% do 70%.
`MATCH_RANGE_71_TO_80`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 71% do 80%.
`MATCH_RANGE_81_TO_90`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi od 81% do 90%.
`MATCH_RANGE_91_TO_100`	Zakres współczynnika dopasowania dla przesyłanych danych offline wynosi co najmniej 91%.

StoreSalesMetadata

Metadane na potrzeby sprzedaży bezpośredniej w sklepie.

Zapis JSON
{ "thirdPartyMetadata": { object (`StoreSalesThirdPartyMetadata`) }, "loyaltyFraction": number, "transactionUploadFraction": number, "customKey": string }

Pola
`thirdPartyMetadata`	`object (StoreSalesThirdPartyMetadata)` Metadane dotyczące pliku danych o sprzedaży w sklepie innej firmy.
`loyaltyFraction`	`number` Jest to odsetek wszystkich transakcji, które można zidentyfikować (np. powiązanych z dowolną formą informacji o kliencie). To pole jest wymagane. Musi to być liczba między 0 a 1 (0 nie wchodzi w zakres).
`transactionUploadFraction`	`number` Jest to stosunek liczby przesyłanych transakcji sprzedaży do łącznej liczby transakcji sprzedaży, które można powiązać z klientem. To pole jest wymagane. Musi to być liczba między 0 a 1 (0 nie wchodzi w zakres). Jeśli przesyłasz np.połowę transakcji sprzedaży, które można powiązać z klientem, będzie to 0,5.
`customKey`	`string` Nazwa klucza zmiennej niestandardowej związanej ze sprzedażą w sklepie. Wstępnie zdefiniowany klucz, który można zastosować do transakcji, a potem używać do niestandardowego podziału na segmenty w raportach. Dostępne tylko dla klientów z listy dozwolonych.

StoreSalesThirdPartyMetadata

Metadane dotyczące zewnętrznej sprzedaży w sklepie. Ta usługa jest dostępna tylko dla klientów z listy dozwolonych. Aby uzyskać szczegółowe informacje o konfiguracji przesyłania, skontaktuj się z przedstawicielem Google Business Development.

Zapis JSON
{ "advertiserUploadDateTime": string, "validTransactionFraction": number, "partnerMatchFraction": number, "partnerUploadFraction": number, "bridgeMapVersionId": string, "partnerId": string }

Pola
`advertiserUploadDateTime`	`string` Czas, w którym reklamodawca przesłał dane do partnera. To pole jest wymagane. Format to „RRRR-MM-DD GG:MM:SS”. Przykłady: „2018-03-05 09:15:00” lub „2018-02-01 14:34:30”.
`validTransactionFraction`	`number` Odsetek prawidłowych transakcji. Nieprawidłowe transakcje mogą zawierać nieprawidłowe formaty lub wartości. To pole jest wymagane. Musi to być liczba między 0 a 1 (0 nie wchodzi w zakres).
`partnerMatchFraction`	`number` Odsetek prawidłowych transakcji pasujących do identyfikatora użytkownika przypisanego przez firmę zewnętrzną po stronie partnera. To pole jest wymagane. Musi to być liczba między 0 a 1 (0 nie wchodzi w zakres).
`partnerUploadFraction`	`number` Odsetek prawidłowych transakcji przesłanych przez partnera do Google. To pole jest wymagane. Musi to być liczba między 0 a 1 (0 nie wchodzi w zakres).
`bridgeMapVersionId`	`string` Wersja identyfikatorów partnerów, które mają być używane do przesyłania. To pole jest wymagane.
`partnerId`	`string (int64 format)` Identyfikator partnera zewnętrznego aktualizującego plik danych o transakcjach.