UserData

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

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

object (UserIdentifier)

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

object (TransactionAttribute)

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

object (UserAttribute)

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

object (Consent)

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

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

مبلغ المعاملة بالمايكرو مطلوبة. يجب أن يكون مبلغ المعاملة بالمايكرو أكبر من 1,000. إذا تم توفير "سمات السلع"، تمثِّل القيمة الإجمالية للسلع، بعد ضرب سعر الوحدة لكل سلعة في الكمية المقدَّمة في 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 (الرقم التجاري العالمي للسلعة).