OfflineUserDataJob

Ein Job, der Offline-Nutzerdaten von Ladenbesuchen oder Nutzerlistenmitgliedern enthält, die asynchron verarbeitet werden. Die hochgeladenen Daten sind nicht lesbar und die Verarbeitungsergebnisse des Jobs können nur mit GoogleAdsService.Search/SearchStream gelesen werden.

JSON-Darstellung
{
  "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.
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Offline-Nutzerdatenjobs. Ressourcennamen von Offline-Nutzerdatenjobs haben das folgende Format:

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}

type

enum (OfflineUserDataJobType)

Nicht veränderbar. Art des Jobs.

status

enum (OfflineUserDataJobStatus)

Nur Ausgabe Status des Auftrags.

failureReason

enum (OfflineUserDataJobFailureReason)

Nur Ausgabe Grund für den Verarbeitungsfehler, falls der Status FEHLGESCHLAGEN ist

operationMetadata

object (OfflineUserDataJobMetadata)

Nur Ausgabe Metadaten des Offline-Nutzerdatenjobs, der den Abgleichsratebereich darstellt.

id

string (int64 format)

Nur Ausgabe ID dieses Offline-Nutzerdatenjobs.

externalId

string (int64 format)

Nicht veränderbar. Die vom Nutzer angegebene Job-ID.

Union-Feld metadata. Metadaten des Jobs. Für metadata ist nur einer der folgenden Werte zulässig:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Nicht veränderbar. Metadaten für Datenaktualisierungen für eine CRM-basierte Nutzerliste.

storeSalesMetadata

object (StoreSalesMetadata)

Nicht veränderbar. Metadaten für die Aktualisierung von Daten zu Ladenverkäufen.

OfflineUserDataJobType

Der Typ eines Offlinejobs für Nutzerdaten.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
STORE_SALES_UPLOAD_FIRST_PARTY Selbstbedienungsdaten für Ladenverkäufe (direkter Upload)
STORE_SALES_UPLOAD_THIRD_PARTY Daten zu Ladenverkäufen (direkter Upload) für Drittanbieter.
CUSTOMER_MATCH_USER_LIST Nutzerlistendaten zum Kundenabgleich
CUSTOMER_MATCH_WITH_ATTRIBUTES Kundenabgleich mit Attributdaten

OfflineUserDataJobStatus

Der Status eines Offlinejobs für Nutzerdaten.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
PENDING Der Job wurde erstellt und muss noch hochgeladen werden.
RUNNING Uploads wurden akzeptiert und die Daten werden verarbeitet.
SUCCESS Die hochgeladenen Daten wurden erfolgreich verarbeitet.
FAILED Die hochgeladenen Daten konnten nicht verarbeitet werden.

OfflineUserDataJobFailureReason

Die Fehlerursache eines Offline-Nutzerdatenjobs.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt den in dieser Version unbekannten Wert dar.
INSUFFICIENT_MATCHED_TRANSACTIONS Die übereinstimmenden Transaktionen reichen nicht aus.
INSUFFICIENT_TRANSACTIONS Die hochgeladenen Transaktionen reichen nicht aus.
HIGH_AVERAGE_TRANSACTION_VALUE Der durchschnittliche Transaktionswert ist für Ihr Konto ungewöhnlich hoch. Wenn das beabsichtigt ist, wenden Sie sich an den Support, um eine Ausnahme zu beantragen. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/10018944#transaction_value.
LOW_AVERAGE_TRANSACTION_VALUE Der durchschnittliche Transaktionswert ist für Ihr Konto ungewöhnlich niedrig. Wenn das beabsichtigt ist, wenden Sie sich an den Support, um eine Ausnahme zu beantragen. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/10018944#transaction_value.
NEWLY_OBSERVED_CURRENCY_CODE Ein Währungscode wurde noch nicht in Ihren Uploads verwendet. Wenn das beabsichtigt ist, wenden Sie sich an den Support, um eine Ausnahme zu beantragen. Weitere Informationen finden Sie unter https://support.google.com/google-ads/answer/10018944#Unrecognized_currency.

OfflineUserDataJobMetadata

Metadaten des Offline-Nutzerdatenjobs.

JSON-Darstellung
{
  "matchRateRange": enum (OfflineUserDataJobMatchRateRange)
}
Felder
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

Nur Ausgabe Abgleichsrate der hochgeladenen Nutzerliste für den Kundenabgleich. Beschreibt die geschätzte Abgleichsrate, wenn der Status des Jobs „WIRD AUSGEFÜHRT“ ist, und die endgültige Abgleichsrate, wenn die endgültige Abgleichsrate verfügbar ist, nachdem der Status des Jobs „Erfolgreich/FEHLGESCHLAGEN“ ist.

OfflineUserDataJobMatchRateRange

Der Bereich der Abgleichsrate eines Offline-Nutzerdatenjobs.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Standardwert für Abgleichsratebereich.
MATCH_RANGE_LESS_THAN_20 Der Bereich der Abgleichsrate für ein Element für den Offline-Daten-Upload liegt zwischen 0% und 19%.
MATCH_RANGE_20_TO_30 Der Bereich der Abgleichsrate für ein Element für den Offline-Daten-Upload liegt zwischen 20% und 30%.
MATCH_RANGE_31_TO_40 Der Bereich der Übereinstimmungsrate für Offline-Daten-Upload-Elemente liegt zwischen 31% und 40%.
MATCH_RANGE_41_TO_50 Der Bereich der Abgleichsrate für Offline-Daten-Upload-Elemente liegt zwischen 41% und 50%.
MATCH_RANGE_51_TO_60 Der Bereich der Abgleichsrate für ein Element für den Offline-Daten-Upload liegt zwischen 51% und 60%.
MATCH_RANGE_61_TO_70 Der Bereich der Abgleichsrate für ein Element für den Offline-Daten-Upload liegt zwischen 61% und 70%.
MATCH_RANGE_71_TO_80 Der Bereich der Übereinstimmungsrate für Offline-Daten-Upload-Elemente liegt zwischen 71% und 80%.
MATCH_RANGE_81_TO_90 Der Bereich der Abgleichsrate für ein Element für den Offline-Daten-Upload liegt zwischen 81% und 90%.
MATCH_RANGE_91_TO_100 Der Bereich der Abgleichsrate für ein Element für den Offline-Daten-Upload beträgt mindestens 91%.

StoreSalesMetadata

Metadaten für Ladenverkäufe (direkter Upload).

JSON-Darstellung
{
  "thirdPartyMetadata": {
    object (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
Felder
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

Metadaten für einen Drittanbieter-Upload von Ladenverkäufen.

loyaltyFraction

number

Dies ist der Anteil aller Transaktionen, die identifizierbar sind (z. B. in Verbindung mit Kundendaten jeglicher Art). Erforderlich. Der Wert muss zwischen 0 und 1 liegen, darf aber nicht 0 sein.

transactionUploadFraction

number

Dies ist das Verhältnis der hochgeladenen Verkäufe zu den Gesamtverkäufen, die einem Kunden zugeordnet werden können. Erforderlich. Der Wert muss zwischen 0 und 1 liegen, darf aber nicht 0 sein. Wenn Sie beispielsweise die Hälfte der Verkäufe hochladen, die Sie einem Kunden zuordnen können, beträgt dieser Wert 0,5.

customKey

string

Name des Schlüssels der benutzerdefinierten Variablen für Ladenverkäufe. Ein vordefinierter Schlüssel, der auf die Transaktion und später für die benutzerdefinierte Segmentierung in Berichten angewendet werden kann. Nur für Kunden auf der Zulassungsliste zugänglich.

StoreSalesThirdPartyMetadata

Metadaten für Ladenverkäufe eines Drittanbieters. Dieses Produkt ist nur für Kunden auf der Zulassungsliste. Weitere Informationen zur Uploadkonfiguration erhalten Sie von Ihrem Google-Ansprechpartner für Geschäftsentwicklung.

JSON-Darstellung
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
Felder
advertiserUploadDateTime

string

Zeitpunkt, zu dem der Werbetreibende die Daten an den Partner hochgeladen hat. Erforderlich. Das Format ist JJJJ-MM-TT HH:MM:SS. Beispiele: „2018-03-05 09:15:00“ oder „2018-02-01 14:34:30“

validTransactionFraction

number

Der Anteil der gültigen Transaktionen. Ungültige Transaktionen können ungültige Formate oder Werte enthalten. Erforderlich. Der Wert muss zwischen 0 und 1 liegen, darf aber nicht 0 sein.

partnerMatchFraction

number

Der Anteil gültiger Transaktionen, die einer von einem Dritten zugewiesenen Nutzer-ID auf Partnerseite zugeordnet wurden. Erforderlich. Der Wert muss zwischen 0 und 1 liegen, darf aber nicht 0 sein.

partnerUploadFraction

number

Der Anteil gültiger Transaktionen, die vom Partner zu Google hochgeladen wurden. Erforderlich. Der Wert muss zwischen 0 und 1 liegen, darf aber nicht 0 sein.

bridgeMapVersionId

string

Version der Partner-IDs, die für Uploads verwendet werden sollen. Erforderlich.

partnerId

string (int64 format)

ID des Drittanbieterpartners, der den Transaktionsfeed aktualisiert