- نمایندگی JSON
- TransactionAttribute
- StoreAttribute
- ItemAttribute
- UserAttribute
- وفاداری خرید
- EventAttribute
- EventItemAttribute
اطلاعات کاربر دارای شناسه ها و ویژگی های کاربر است.
نمایندگی JSON |
---|
{ "userIdentifiers": [ { object ( |
زمینه های | |
---|---|
userIdentifiers[] | اطلاعات شناسایی کاربر ضروری. |
transactionAttribute | تراکنش ها/ویژگی های اضافی مرتبط با کاربر. هنگام بهروزرسانی دادههای فروش فروشگاه ضروری است. |
userAttribute | ویژگی های اضافی مرتبط با کاربر. هنگام بهروزرسانی ویژگیهای مطابقت مشتری، لازم است. اینها 540 روز انقضا دارند. |
consent | تنظیم رضایت برای کاربر مطابقت مشتری این قسمت را نادیده می گیرد و یک اخطار برمی گرداند. |
TransactionAttribute
ویژگی معامله فروش فروشگاه.
نمایندگی JSON |
---|
{ "storeAttribute": { object ( |
زمینه های | |
---|---|
storeAttribute | ذخیره ویژگی های معامله فقط برای مشتریان موجود در لیست مجاز قابل دسترسی است. |
itemAttribute | ویژگی های مورد معامله |
transactionDateTime | مهر زمانی که تراکنش انجام شد. ضروری. قالب "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 | مبلغ تراکنش بر حسب میکرو ضروری. مقدار تراکنش در میکرو باید بیشتر از 1000 باشد. اگر ویژگی های آیتم ارائه شده باشد، نشان دهنده ارزش کل اقلام است، پس از ضرب قیمت واحد برای هر کالا در مقدار ارائه شده در آیتم ها. |
currencyCode | کد ارز معامله کد سه حرفی ISO 4217 استفاده شده است. ضروری. |
conversionAction | نام منبع عمل تبدیل برای گزارش تبدیل به. ضروری. |
orderId | شناسه سفارش تراکنش فقط برای مشتریان موجود در لیست مجاز قابل دسترسی است. |
customValue | مقدار متغیر سفارشی برای هر تراکنش. فقط برای مشتریان موجود در لیست مجاز قابل دسترسی است. |
StoreAttribute
ذخیره ویژگی های معامله
نمایندگی JSON |
---|
{ "storeCode": string } |
زمینه های | |
---|---|
storeCode | کد فروشگاه از https://support.google.com/business/answer/3370250#storecode |
ItemAttribute
ویژگی های مورد معامله
نمایندگی JSON |
---|
{ "itemId": string, "countryCode": string, "languageCode": string, "quantity": string, "merchantId": string } |
زمینه های | |
---|---|
itemId | شناسه منحصر به فرد یک محصول. می تواند شناسه کالای Merchant Center یا GTIN (شماره کالای تجاری جهانی) باشد. |
countryCode | کد قلمرو مخزن داده محلی مشترک (CLDR) مربوط به فید جایی که موارد شما در آن آپلود می شوند. برای اطلاعات بیشتر به https://developers.google.com/google-ads/api/reference/data/codes-formats#country-codes مراجعه کنید. |
languageCode | کد ISO 639-1 زبان مرتبط با فید که موارد شما در آن آپلود می شوند |
quantity | تعداد اقلام فروخته شده در صورت تنظیم نشدن به طور پیشفرض 1 میشود. |
merchantId | شناسه حساب Merchant Center. |
UserAttribute
ویژگی کاربر، فقط با نوع شغل CUSTOMER_MATCH_WITH_ATTRIBUTES قابل استفاده است.
نمایندگی JSON |
---|
{ "lastPurchaseDateTime": string, "averagePurchaseCount": integer, "averagePurchaseValueMicros": string, "acquisitionDateTime": string, "lifecycleStage": string, "firstPurchaseDateTime": string, "eventAttribute": [ { object ( |
زمینه های | |
---|---|
lastPurchaseDateTime | مهر زمانی آخرین خرید انجام شده توسط کاربر. قالب YYYY-MM-DD HH:MM:SS[+/-HH:MM] است، که در آن [+/-HH:MM] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیشفرض استفاده میکند. |
averagePurchaseCount | تبلیغکننده میانگین تعداد خریدهایی را که کاربر در یک دوره 30 روزه انجام میدهد، تعریف کرده است. |
averagePurchaseValueMicros | تبلیغکننده میانگین ارزش خرید را بر حسب میکرو برای کاربر تعریف کرده است. |
acquisitionDateTime | مهر زمانی زمانی که کاربر به دست آمد. قالب YYYY-MM-DD HH:MM:SS[+/-HH:MM] است، که در آن [+/-HH:MM] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیشفرض استفاده میکند. |
lifecycleStage | اختیاری. تبلیغ کننده مرحله چرخه حیات را برای کاربر تعریف کرده است. مقادیر پذیرفته شده عبارتند از "Lead"، "Active" و "Churned". |
firstPurchaseDateTime | اختیاری. مهر زمانی اولین خرید انجام شده توسط کاربر. قالب YYYY-MM-DD HH:MM:SS[+/-HH:MM] است، که در آن [+/-HH:MM] یک منطقه زمانی اختیاری است که از UTC خارج شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیشفرض استفاده میکند. |
eventAttribute[] | اختیاری. تبلیغ کننده رویدادها و ویژگی های آنها را تعریف می کند. تمام مقادیر در فیلدهای تودرتو الزامی است. در حال حاضر این فیلد در نسخه بتا است. |
lifetimeValueMicros | تبلیغ کننده ارزش طول عمر را برای کاربر تعریف کرده است. |
lifetimeValueBucket | تبلیغ کننده سطل ارزش مادام العمر را برای کاربر تعریف کرده است. محدوده معتبر برای یک سطل ارزش مادام العمر از 1 (کم) تا 10 (بالا) است، به جز برای عملیات حذف که 0 نیز پذیرفته می شود. |
shoppingLoyalty | داده های مربوط به وفاداری خرید خرید از این داده ها برای ارائه تجربه بهتر به کاربران استفاده می کند. فقط برای بازرگانان موجود در لیست مجاز با رضایت کاربر قابل دسترسی است. |
وفاداری خرید
داده های مربوط به وفاداری خرید خرید از این داده ها برای ارائه تجربه بهتر به کاربران استفاده می کند. فقط برای بازرگانان موجود در لیست مجاز قابل دسترسی است.
نمایندگی JSON |
---|
{ "loyaltyTier": string } |
زمینه های | |
---|---|
loyaltyTier | ردیف عضویت این یک رشته آزاد است زیرا هر تاجر ممکن است سیستم وفاداری خود را داشته باشد. به عنوان مثال، می تواند یک عدد از 1 تا 10، یا یک رشته مانند "طلا" یا "نقره"، یا حتی یک رشته خالی "". |
EventAttribute
تبلیغ کننده رویدادها و ویژگی های آنها را تعریف می کند. تمام مقادیر در فیلدهای تودرتو الزامی است.
نمایندگی JSON |
---|
{
"event": string,
"eventDateTime": string,
"itemAttribute": [
{
object ( |
زمینه های | |
---|---|
event | ضروری. رویداد تعریف شده توسط تبلیغ کننده برای استفاده در بازاریابی مجدد. مقادیر پذیرفته شده عبارتند از "بازدید شده"، "سبد خرید"، "خرید شده" و "توصیه شده". |
eventDateTime | ضروری. مهر زمانی که رویداد در آن رخ داده است. قالب YYYY-MM-DD HH:MM:SS[+/-HH:MM] است، که در آن [+/-HH:MM] یک منطقه زمانی اختیاری است که از UTC تنظیم شده است. اگر افست وجود نداشته باشد، API از منطقه زمانی حساب به عنوان پیشفرض استفاده میکند. |
itemAttribute[] | ضروری. ویژگی های آیتم رویداد. |
EventItemAttribute
ویژگیهای مورد رویداد مطابقت مشتری.
نمایندگی JSON |
---|
{ "itemId": string } |
زمینه های | |
---|---|
itemId | اختیاری. شناسه منحصر به فرد یک محصول. میتواند شناسه کالای Merchant Center یا GTIN (شماره کالای جهانی تجارت) باشد. |