UserData

بيانات المستخدمين التي تحتفظ بمعرّفات المستخدمين وسماتهم.

تمثيل JSON 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "transactionAttribute": {
    object (TransactionAttribute)
  },
  "userAttribute": {
    object (UserAttribute)
  }
}
الحقول
userIdentifiers[]

object (UserIdentifier)

معلومات تعريف المستخدم مطلوبة.
transactionAttribute

object (TransactionAttribute)

المعاملات/السمات الإضافية المرتبطة بالمستخدم مطلوبة عند تعديل بيانات المبيعات في المتاجر.
userAttribute

object (UserAttribute)

السمات الإضافية المرتبطة بالمستخدم مطلوبة عند تعديل سمات "مطابقة العملاء" وتنتهي صلاحيتها بعد 540 يومًا.

TransactionAttribute

سمة معاملة المبيعات في المتاجر

تمثيل JSON 
{
  "storeAttribute": {
    object (StoreAttribute)
  },
  "itemAttribute": {
    object (ItemAttribute)
  },
  "transactionDateTime": string,
  "transactionAmountMicros": number,
  "currencyCode": string,
  "conversionAction": string,
  "orderId": string,
  "customValue": string
}
الحقول
storeAttribute

object (StoreAttribute)

تخزين سمات المعاملة يمكن للعملاء المدرَجين في القائمة المسموح بها فقط الوصول إليها.
itemAttribute

object (ItemAttribute)

سمات السلع للمعاملة
transactionDateTime

string

الطابع الزمني لوقت حدوث المعاملة مطلوبة. التنسيق هو "YYYY-MM-DD HH:MM:SS[+/-HH:MM]"، حيث يُعدّ [+/-HH:MM] معادلة اختيارية للمنطقة الزمنية من التوقيت العالمي المتفق عليه. في حال عدم توفّر الإزاحة، ستستخدم واجهة برمجة التطبيقات المنطقة الزمنية للحساب كإعداد تلقائي. أمثلة: "2018-03-05 09:15:00" أو "2018-02-01 14:34:30+03:00"
transactionAmountMicros

number

مبلغ المعاملة بالمايكرو. مطلوبة. يجب أن يكون مبلغ المعاملة بالمايكرو أكبر من 1000. إذا تمّ تقديم سمات السلع، فإنّها تمثِّل القيمة الإجمالية للسلع، بعد ضرب سعر الوحدة لكلّ سلعة في الكمية المقدَّمة في ItemAttributes.
currencyCode

string

رمز عملة المعاملة. يُستخدم رمز ISO 4217 المكوَّن من ثلاثة أحرف. مطلوبة.
conversionAction

string

اسم المورد لإجراء الإحالة الناجحة المطلوب الإبلاغ عن الإحالات الناجحة إليه. مطلوبة.
orderId

string

مُعرّف طلب المعاملة. يمكن للعملاء المدرَجين في القائمة المسموح بها فقط الوصول إليها.
customValue

string

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

StoreAttribute

تخزين سمات المعاملة

تمثيل JSON 
{
  "storeCode": string
}
الحقول
storeCode

string

رمز المتجر من https://support.google.com/business/answer/3370250#storecode

ItemAttribute

سمات السلع للمعاملة

تمثيل JSON 
{
  "itemId": string,
  "countryCode": string,
  "languageCode": string,
  "quantity": string,
  "merchantId": string
}
الحقول
itemId

string

معرّف فريد لمنتج معيّن. يمكن أن يكون إما معرّف السلعة في Merchant Center أو رقم GTIN (الرقم التجاري العالمي للسلعة).
countryCode

string

رمز إقليم CLDR الخاص بالبلد المرتبط بالخلاصة التي تمّ تحميل سلعك فيها لمعرفة مزيد من المعلومات، يمكنك الانتقال إلى https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes.
languageCode

string

رمز ISO 639-1 للغة المرتبطة بالخلاصة التي تمّ تحميل سلعك فيها
quantity

string (int64 format)

عدد السلع المُباعة. وتكون القيمة التلقائية 1 إذا لم يتم ضبطها.
merchantId

string (int64 format)

رقم تعريف حساب Merchant Center

UserAttribute

لا يمكن استخدام سمة المستخدم إلا مع نوع الوظيفة CUSTOMER_MATCH_WITH_ATTRIBUTES.

تمثيل JSON 
{
  "lastPurchaseDateTime": string,
  "averagePurchaseCount": integer,
  "averagePurchaseValueMicros": string,
  "acquisitionDateTime": string,
  "lifecycleStage": string,
  "firstPurchaseDateTime": string,
  "eventAttribute": [
    {
      object (EventAttribute)
    }
  ],
  "lifetimeValueMicros": string,
  "lifetimeValueBucket": integer,
  "shoppingLoyalty": {
    object (ShoppingLoyalty)
  }
}
الحقول
lastPurchaseDateTime

string

الطابع الزمني لآخر عملية شراء أجراها المستخدم التنسيق هو YYYY-MM-DD HH:MM:SS[+/-HH:MM]، حيث يُعدّ [+/-HH:MM] معادلة اختيارية للمنطقة الزمنية من التوقيت العالمي المتفق عليه. في حال عدم توفّر الإزاحة، ستستخدم واجهة برمجة التطبيقات المنطقة الزمنية للحساب كإعداد تلقائي.
averagePurchaseCount

integer

يُحدِّد المعلِن متوسط عدد عمليات الشراء التي أجراها المستخدم خلال فترة 30 يومًا.
averagePurchaseValueMicros

string (int64 format)

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

string

الطابع الزمني عند اكتساب المستخدم. التنسيق هو YYYY-MM-DD HH:MM:SS[+/-HH:MM]، حيث يُعدّ [+/-HH:MM] معادلة اختيارية للمنطقة الزمنية من التوقيت العالمي المتفق عليه. في حال عدم توفّر الإزاحة، ستستخدم واجهة برمجة التطبيقات المنطقة الزمنية للحساب كإعداد تلقائي.
lifecycleStage

string

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

string

اختياريّ. الطابع الزمني لأول عملية شراء أجراها المستخدم. التنسيق هو YYYY-MM-DD HH:MM:SS[+/-HH:MM]، حيث يُعدّ [+/-HH:MM] معادلة اختيارية للمنطقة الزمنية من التوقيت العالمي المتفق عليه. في حال عدم توفّر الإزاحة، ستستخدم واجهة برمجة التطبيقات المنطقة الزمنية للحساب كإعداد تلقائي.
eventAttribute[]

object (EventAttribute)

اختياريّ. من تحديد المعلِن الأحداث وسماتها ويجب إدخال جميع القيم في الحقول المتداخلة. يتوفّر هذا الحقل حاليًا في إصدار تجريبي.
lifetimeValueMicros

string (int64 format)

القيمة الدائمة من تحديد المعلن للمستخدم.
lifetimeValueBucket

integer

مجموعة بيانات القيمة الدائمة من تحديد المعلن للمستخدم. النطاق الصالح لمجموعة بيانات القيمة الدائمة هو من 1 (منخفض) إلى 10 (مرتفعة)، باستثناء عملية الإزالة التي سيتم قبول 0 فيها أيضًا.
shoppingLoyalty

object (ShoppingLoyalty)

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

ShoppingLoyalty

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

تمثيل JSON 
{
  "loyaltyTier": string
}
الحقول
loyaltyTier

string

مستوى الاشتراك الداعم وهي عبارة عن سلسلة حرة، إذ قد يكون لكل تاجر نظام ولاء خاص به. على سبيل المثال، قد يكون رقمًا من 1 إلى 10، أو سلسلة مثل "ذهبي" أو "فضي"، أو حتى سلسلة فارغة "".

EventAttribute

من تحديد المعلِن الأحداث وسماتها ويجب إدخال جميع القيم في الحقول المتداخلة.

تمثيل JSON 
{
  "event": string,
  "eventDateTime": string,
  "itemAttribute": [
    {
      object (EventItemAttribute)
    }
  ]
}
الحقول
event

string

مطلوبة. حدث من تحديد المعلِن لاستخدامه في تجديد النشاط التسويقي. القيم المقبولة هي "تمت المشاهدة" و"سلة التسوق" و"تم الشراء" و "مقترحة".
eventDateTime

string

مطلوبة. الطابع الزمني الذي وقع فيه الحدث التنسيق هو YYYY-MM-DD HH:MM:SS[+/-HH:MM]، حيث يُعدّ [+/-HH:MM] معادلة اختيارية للمنطقة الزمنية من التوقيت العالمي المتفق عليه. في حال عدم توفّر الإزاحة، ستستخدم واجهة برمجة التطبيقات المنطقة الزمنية للحساب كإعداد تلقائي.
itemAttribute[]

object (EventItemAttribute)

مطلوبة. سمات السلع للحدث

EventItemAttribute

سمات عنصر الحدث لمطابقة العملاء.

تمثيل JSON 
{
  "itemId": string
}
الحقول
itemId

string

اختياريّ. معرّف فريد لمنتج معيّن. يمكن أن يكون إما معرّف السلعة في Merchant Center أو رقم GTIN (الرقم التجاري العالمي للسلعة).