OfflineUserDataJob

مهمة تحتوي على بيانات المستخدمين بلا اتصال بالإنترنت الخاصة بزوّار المتجر أو أعضاء قائمة المستخدمين، وستتم معالجتها بشكلٍ غير متزامن. البيانات التي تم تحميلها غير قابلة للقراءة ولا يمكن قراءة نتائج معالجة المهمة فقط باستخدام GoogleAdsService.Search/SearchStream.

تمثيل 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

غير قابل للتغيير. اسم المورد لمهمة بيانات المستخدمين بلا إنترنت. تكون أسماء موارد وظائف بيانات المستخدمين بلا اتصال بالإنترنت على النحو التالي:

customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}

type

enum (OfflineUserDataJobType)

غير قابل للتغيير. نوع الوظيفة

status

enum (OfflineUserDataJobStatus)

النتائج فقط. حالة الوظيفة

failureReason

enum (OfflineUserDataJobFailureReason)

النتائج فقط. سبب تعذُّر المعالجة: إذا كانت الحالة "تعذّرت"

operationMetadata

object (OfflineUserDataJobMetadata)

النتائج فقط. البيانات الوصفية لمهمة بيانات المستخدمين بلا إنترنت التي تعرض نطاق نسبة المطابقة.

id

string (int64 format)

النتائج فقط. رقم تعريف مهمة بيانات المستخدمين بلا إنترنت هذه.

externalId

string (int64 format)

غير قابل للتغيير. معرّف الوظيفة المحدد من قِبل المستخدم

حقل الاتحاد metadata بيانات التعريف للوظيفة. يمكن أن يكون الحقل "metadata" واحدًا فقط مما يلي:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

غير قابل للتغيير. البيانات الوصفية لتعديل البيانات في قائمة المستخدمين المستنِدة إلى إدارة علاقات العملاء

storeSalesMetadata

object (StoreSalesMetadata)

غير قابل للتغيير. البيانات الوصفية لتعديل بيانات المبيعات في المتاجر

OfflineUserDataJobType

نوع مهمة بيانات المستخدِم بلا إنترنت.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
STORE_SALES_UPLOAD_FIRST_PARTY بيانات مبيعات المتجر المباشرة للخدمة الذاتية.
STORE_SALES_UPLOAD_THIRD_PARTY بيانات مبيعات المتجر المباشرة لجهة خارجية.
CUSTOMER_MATCH_USER_LIST بيانات قائمة مستخدمي "مطابقة العملاء".
CUSTOMER_MATCH_WITH_ATTRIBUTES "مطابقة العملاء" مع بيانات السمات.

OfflineUserDataJobStatus

حالة مهمة بيانات مستخدم بلا إنترنت.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
PENDING تم إنشاء الوظيفة بنجاح، وهي في انتظار التحميل.
RUNNING تم قبول عمليات التحميل وتتم معالجة البيانات.
SUCCESS تمت معالجة البيانات التي تم تحميلها بنجاح.
FAILED تعذّرت معالجة البيانات التي تم تحميلها.

OfflineUserDataJobFailureReason

سبب تعذُّر مهمة بيانات مستخدم بلا إنترنت.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN تُستخدَم هذه السمة للقيمة المعروضة فقط. يعرض قيمة غير معروفة في هذا الإصدار.
INSUFFICIENT_MATCHED_TRANSACTIONS المعاملات المتطابقة غير كافية.
INSUFFICIENT_TRANSACTIONS المعاملات المحمَّلة غير كافية.
HIGH_AVERAGE_TRANSACTION_VALUE متوسط قيمة المعاملة مرتفع بشكل غير معتاد لحسابك. إذا كان ذلك مقصودًا، يُرجى التواصل مع فريق الدعم لطلب استثناء. يمكنك الاطّلاع على مزيد من المعلومات على الرابط https://support.google.com/google-ads/answer/10018944#transaction_value
LOW_AVERAGE_TRANSACTION_VALUE متوسط قيمة المعاملة منخفض بشكل غير معتاد لحسابك. إذا كان ذلك مقصودًا، يُرجى التواصل مع فريق الدعم لطلب استثناء. يمكنك الاطّلاع على مزيد من المعلومات على الرابط https://support.google.com/google-ads/answer/10018944#transaction_value
NEWLY_OBSERVED_CURRENCY_CODE هناك رمز عملة لم يسبق لك استخدامه في عمليات التحميل. إذا كان ذلك مقصودًا، يُرجى التواصل مع فريق الدعم لطلب استثناء. يمكنك الاطّلاع على مزيد من المعلومات على الرابط https://support.google.com/google-ads/answer/10018944#Unrecognized_currency.

OfflineUserDataJobMetadata

البيانات الوصفية لمهمة بيانات المستخدمين بلا إنترنت.

تمثيل JSON
{
  "matchRateRange": enum (OfflineUserDataJobMatchRateRange)
}
الحقول
matchRateRange

enum (OfflineUserDataJobMatchRateRange)

النتائج فقط. نسبة المطابقة لتحميل قائمة مستخدمي "مطابقة العملاء". يصِف نسبة المطابقة المقدَّرة عندما تكون حالة الوظيفة "قيد التشغيل" ونسبة المطابقة النهائية عند توفُّر نسبة المطابقة النهائية بعد أن تكون حالة الوظيفة "ناجح/تعذّرت".

OfflineUserDataJobMatchRateRange

نطاق نسبة المطابقة لمهمة بيانات مستخدِمين بلا إنترنت.

عمليات التعداد
UNSPECIFIED عدم تحديد صيغة مخاطبة
UNKNOWN القيمة التلقائية لنطاق نسبة المطابقة
MATCH_RANGE_LESS_THAN_20 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين 0% و19%.
MATCH_RANGE_20_TO_30 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين% 20 و%30.
MATCH_RANGE_31_TO_40 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين 31% و40%.
MATCH_RANGE_41_TO_50 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين% 41 و%50.
MATCH_RANGE_51_TO_60 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين 51% و60%.
MATCH_RANGE_61_TO_70 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين 61% و70%.
MATCH_RANGE_71_TO_80 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين% 71 و%80.
MATCH_RANGE_81_TO_90 يتراوح نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت بين% 81 و%90.
MATCH_RANGE_91_TO_100 نطاق نسبة المطابقة لجهة تحميل البيانات المتوفّرة بلا إنترنت أكبر من أو يساوي 91%.

StoreSalesMetadata

البيانات الوصفية لميزة "المبيعات المباشرة في المتجر".

تمثيل JSON
{
  "thirdPartyMetadata": {
    object (StoreSalesThirdPartyMetadata)
  },
  "loyaltyFraction": number,
  "transactionUploadFraction": number,
  "customKey": string
}
الحقول
thirdPartyMetadata

object (StoreSalesThirdPartyMetadata)

البيانات الوصفية لعملية تحميل بيانات مبيعات المتجر التابعة لجهة خارجية

loyaltyFraction

number

هذا هو الجزء من كل المعاملات التي يمكن تحديدها (على سبيل المثال، المرتبطة بأي شكل من أشكال معلومات العملاء). مطلوبة. يجب أن يكون هذا الكسر بين 0 و1 (باستثناء 0).

transactionUploadFraction

number

هذه هي نسبة المبيعات التي يتم تحميلها مقارنةً بالمبيعات الإجمالية التي يمكن ربطها بأحد العملاء. مطلوبة. يجب أن يكون هذا الكسر بين 0 و1 (باستثناء 0). على سبيل المثال، في حال تحميل نصف المبيعات التي يمكنك ربطها بأحد العملاء، ستكون القيمة 0.5.

customKey

string

اسم مفتاح المتغيّر المخصَّص للمبيعات في المتاجر مفتاح محدّد مسبقًا يمكن تطبيقه على المعاملة ثم يُستخدم لاحقًا للتصنيف المخصّص في إعداد التقارير. لا يمكن الوصول إليها إلا للعملاء المدرَجين في القائمة المسموح بها.

StoreSalesThirdPartyMetadata

البيانات الوصفية لمبيعات المتجر التابعة لجهة خارجية هذا المنتج مخصّص فقط للعملاء المدرَجين في القائمة المسموح بها. تواصَل مع ممثل تطوير الأعمال في Google الذي تتعامل معه للحصول على تفاصيل عن إعدادات التحميل.

تمثيل JSON
{
  "advertiserUploadDateTime": string,
  "validTransactionFraction": number,
  "partnerMatchFraction": number,
  "partnerUploadFraction": number,
  "bridgeMapVersionId": string,
  "partnerId": string
}
الحقول
advertiserUploadDateTime

string

الوقت الذي حمَّل فيه المعلِن البيانات إلى الشريك. مطلوبة. التنسيق هو "YYYY-MM-DD HH:MM:SS". أمثلة: "2018-03-05 09:15:00" أو " 2018-02-01 14:34:30"

validTransactionFraction

number

جزء المعاملات الصالحة. قد تشمل المعاملات غير الصالحة تنسيقات أو قيمًا غير صالحة. مطلوبة. يجب أن يكون هذا الكسر بين 0 و1 (باستثناء 0).

partnerMatchFraction

number

الجزء من المعاملات الصالحة التي تتم مطابقتها مع رقم تعريف مستخدم تابع لجهة خارجية من جهة الشريك. مطلوبة. يجب أن يكون هذا الكسر بين 0 و1 (باستثناء 0).

partnerUploadFraction

number

الجزء من المعاملات الصالحة التي يحمّلها الشريك إلى Google. مطلوبة. يجب أن يكون هذا الكسر بين 0 و1 (باستثناء 0).

bridgeMapVersionId

string

نسخة من معرّفات الشركاء التي سيتم استخدامها لعمليات التحميل مطلوبة.

partnerId

string (int64 format)

رقم تعريف الشريك الخارجي الذي يعدّل خلاصة المعاملات