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] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیش‌فرض استفاده می‌کند. مثال‌ها: "2018-03-05 09:15:00" یا "2018-02-01 14:34:30+03:00"

transactionAmountMicros

number

مبلغ تراکنش بر حسب میکرو ضروری. مقدار تراکنش در میکرو باید بیشتر از 1000 باشد. اگر ویژگی های آیتم ارائه شده باشد، نشان دهنده ارزش کل اقلام است، پس از ضرب قیمت واحد برای هر کالا در مقدار ارائه شده در آیتم ها.

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] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیش‌فرض استفاده می‌کند.

averagePurchaseCount

integer

تبلیغ‌کننده میانگین تعداد خریدهایی را که کاربر در یک دوره 30 روزه انجام می‌دهد، تعریف کرده است.

averagePurchaseValueMicros

string ( int64 format)

تبلیغ‌کننده میانگین ارزش خرید را بر حسب میکرو برای کاربر تعریف کرده است.

acquisitionDateTime

string

مهر زمانی زمانی که کاربر به دست آمد. قالب YYYY-MM-DD HH:MM:SS[+/-HH:MM] است، که در آن [+/-HH:MM] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیش‌فرض استفاده می‌کند.

lifecycleStage

string

اختیاری. تبلیغ کننده مرحله چرخه حیات را برای کاربر تعریف کرده است. مقادیر پذیرفته شده عبارتند از "Lead"، "Active" و "Churned".

firstPurchaseDateTime

string

اختیاری. مهر زمانی اولین خرید انجام شده توسط کاربر. قالب YYYY-MM-DD HH:MM:SS[+/-HH:MM] است، که در آن [+/-HH:MM] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیش‌فرض استفاده می‌کند.

eventAttribute[]

object ( EventAttribute )

اختیاری. تبلیغ کننده رویدادها و ویژگی های آنها را تعریف می کند. تمام مقادیر در فیلدهای تودرتو الزامی است. در حال حاضر این فیلد در نسخه بتا است.

lifetimeValueMicros

string ( int64 format)

تبلیغ کننده ارزش طول عمر را برای کاربر تعریف کرده است.

lifetimeValueBucket

integer

تبلیغ کننده سطل ارزش مادام العمر را برای کاربر تعریف کرده است. محدوده معتبر برای یک سطل ارزش مادام العمر از 1 (کم) تا 10 (بالا) است، به جز برای عملیات حذف که 0 نیز پذیرفته می شود.

shoppingLoyalty

object ( ShoppingLoyalty )

داده های مربوط به وفاداری خرید خرید از این داده ها برای ارائه تجربه بهتر به کاربران استفاده می کند. فقط برای بازرگانان موجود در لیست مجاز با رضایت کاربر قابل دسترسی است.

وفاداری خرید

داده های مربوط به وفاداری خرید خرید از این داده ها برای ارائه تجربه بهتر به کاربران استفاده می کند. فقط برای بازرگانان موجود در لیست مجاز قابل دسترسی است.

نمایندگی 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] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیش‌فرض استفاده می‌کند.

itemAttribute[]

object ( EventItemAttribute )

ضروری. ویژگی های آیتم رویداد.

EventItemAttribute

ویژگی‌های مورد رویداد مطابقت مشتری.

نمایندگی JSON
{
  "itemId": string
}
زمینه های
itemId

string

اختیاری. شناسه منحصر به فرد یک محصول. می تواند شناسه کالای Merchant Center یا GTIN (شماره کالای تجاری جهانی) باشد.