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)

رقم تعريف الشريك التابع لطرف ثالث الذي يعدّل خلاصة المعاملات.