راهنمای توسعه دهنده واردات داده

Google Analytics Management API دسترسی برنامه‌ریزی شده به ویژگی Data Import Google Analytics را امکان‌پذیر می‌سازد.

معرفی

مدیریت API به شما امکان آپلود، فهرست، حذف و دریافت فایل های آپلود شده و همچنین مجموعه داده ها را می دهد. برای یک نمای کلی در سطح بالا از مزایای ویژگی واردات داده، مقاله مرکز راهنمایی درباره واردات داده را ببینید.

دو منبع در مدیریت API که واردات داده را فعال می کنند عبارتند از:

• منبع منبع داده سفارشی ، به نام مجموعه داده در رابط وب، که به عنوان یک محفظه برای فایل های آپلود شده شما عمل می کند. مجموعه ای از منابع داده سفارشی نشان دهنده تمام مجموعه داده های مرتبط با ویژگی Google Analytics است.
• منبع آپلود که یک فایل آپلود شده را نشان می دهد. مجموعه ای از منابع آپلود نشان دهنده تمام فایل هایی است که شما در یک مجموعه داده آپلود کرده اید.

موارد استفاده

ویژگی واردات داده دارای سه دسته سطح بالا است که هر کدام موارد استفاده خاص خود را دارند. سازمان به شرح زیر است:

• وارد کردن داده را بزنید
  • داده های بازپرداخت
• واردات داده های گسترده
  • داده های کاربر
  • داده های کمپین
  • داده های جغرافیایی
  • داده های محتوا
  • اطلاعات محصول
• خلاصه واردات داده
  • داده های هزینه

وارد کردن داده را بزنید

داده های بازپرداخت

تراکنش های تجارت الکترونیکی که به طور کامل یا جزئی بازپرداخت شده اند را می توان در Google Analytics آپلود کرد. این کار تطبیق خودکار داده‌های گزارش‌های تجارت الکترونیک Google Analytics را با بازپرداخت‌های پردازش شده آسان می‌کند.

برای یادگیری نحوه وارد کردن داده‌های بازپرداخت به Google Analytics به مثال واردات بازپرداخت داده مراجعه کنید.

واردات گسترده داده

داده های کاربر

می‌توانید داده‌های کاربر غیرقابل شناسایی شخصی را از ابزارهای CRM خارجی آپلود کنید و مخاطبان بازاریابی مجدد Google Ads را برای ارزشمندترین بخش‌های کاربری خود ایجاد کنید.

برای یادگیری نحوه وارد کردن داده‌های کاربر به Google Analytics برای ایجاد مخاطبین بازاریابی مجدد Google Ads، ببینید:

• وارد کردن داده‌های کاربر برای ایجاد مخاطبین بازاریابی مجدد Google Ads .

داده های کمپین

می توانید داده های کمپین را به Google Analytics وارد کنید تا تجزیه و تحلیل عملکرد کمپین خود را برای کسب و کار خود سفارشی کنید.

برای یادگیری نحوه وارد کردن داده‌های کمپین به Google Analytics، وارد کردن داده‌های کمپین با استفاده از مدیریت API را ببینید.

داده های جغرافیایی

می‌توانید نگاشت شناسه‌های جغرافیایی را به مناطق وارد کنید و به گزارش‌های مربوط به داده‌های Google Analytics بر اساس منطقه سفارشی اجازه دهید. به عنوان مثال، در ایالات متحده، شما ممکن است در گروه ایالت های شرقی، مرکزی و غربی فعالیت کنید. در اروپا، می‌توانید در گروه‌های شمال، مرکزی و جنوبی کشورها فعالیت کنید. هنگام وارد کردن داده ها، می توانید از ga:regionId ، ga:cityId ، ga:countryIsoCode ، یا ga:subContinentCode به عنوان کلید استفاده کنید. شناسه شهرها و شناسه‌های کشور را می‌توانید در جدول هدف‌گیری جغرافیایی پیدا کنید. کد ISO کشور و کد زیر قاره به ترتیب در جدول ISO-3166-1 alpha-2 و UN M.49 فهرست شده اند.

برای اطلاعات بیشتر در مورد وارد کردن داده های جغرافیایی، به مثال وارد کردن داده های جغرافیایی مراجعه کنید.

داده های محتوا

می‌توانید ابرداده‌های مرتبط با محتوا، مانند نویسنده و موضوع، را بارگذاری کنید تا از Google Analytics برای تجزیه و تحلیل عمیق مقالات منتشر شده در یک وب‌سایت استفاده کنید.

برای یادگیری نحوه وارد کردن داده‌های محتوا به Google Analytics، به مثال وارد کردن داده‌های محتوا مراجعه کنید.

داده های محصول

وارد کردن داده‌های محصول به Google Analytics میزان داده‌های تجارت الکترونیکی را که باید همراه با بازدیدها ارسال کنید، مانند بازدید از صفحه و رویدادها، ساده و کاهش می‌دهد. یک شناسه محصول یا SKU را می‌توان با داده‌های محصول وارداتی‌تان همراه کرد تا ابعاد و معیارهای محصول را در گزارش‌هایتان پر کنید.

برای یادگیری نحوه وارد کردن داده‌های محصول خود به Google Analytics، وارد کردن داده‌های محصول با استفاده از مدیریت API را ببینید.

وارد کردن داده های خلاصه

داده های هزینه

می‌توانید داده‌های هزینه‌ای را برای کمپین‌های پولی غیر Google آپلود کنید و از پلتفرم Google Analytics برای انجام تحلیل بازگشت سرمایه و مقایسه عملکرد کمپین برای همه سرمایه‌گذاری‌های تبلیغاتی و بازاریابی آنلاین استفاده کنید.

برای یادگیری نحوه وارد کردن داده‌های هزینه به Google Analytics ، وارد کردن داده‌های هزینه با استفاده از مدیریت API را ببینید.

مفاهیم

وضعیت پردازش

پس از آپلود فایل، وضعیت آپلود در PENDING است تا زمانی که آپلود تأیید و پردازش نشود. اگر پردازش موفقیت آمیز باشد، وضعیت به COMPLETED تغییر خواهد کرد.

اگر در حین پردازش خطایی رخ داده باشد و بارگذاری موفقیت آمیز نباشد، وضعیت آپلود FAILED خواهد بود. لیستی از خطاها ارائه خواهد شد تا به شما در شناسایی مشکل(های) فایل کمک کند. در زیر نمونه ای از پاسخ برای آپلودی است که اعتبار سنجی ناموفق است:

{
  id: "YU4DersR_ORzyzXC_AoWw",
  kind: "analytics#upload",
  accountId: "12345",
  customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
  status: "FAILED",
  errors:
  [
    "Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
    "Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
    "Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
    "Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
  ]
}

توجه : می‌توانید به صورت دوره‌ای از مدیریت API درخواست کنید تا آپلودها را فهرست کنید و قسمت status را بررسی کنید.

جمع بندی داده های هزینه در مقابل بازنویسی

هنگام ایجاد یک منبع داده سفارشی / مجموعه داده برای داده‌های هزینه، می‌توانید نحوه رسیدگی به مواردی را که فایل آپلود شده حاوی ردیفی از داده‌ها با یک کلید (یعنی تاریخ، منبع، رسانه) است که با ردیف موجود مطابقت دارد، مشخص کنید. گزینه ها عبارتند از:

• جمع (پیش‌فرض) - داده‌های جدید به داده‌های مشابه قبلی اضافه می‌شوند و معیارها با هم جمع می‌شوند.
• رونویسی - داده های جدید هر گونه داده مشابه قبلی را بازنویسی می کند.

برای اینکه بفهمید کدام نوع برای یک مجموعه داده تنظیم شده است، از روش فهرست منبع داده سفارشی استفاده کنید تا بررسی کنید که آیا ویژگی importBehavior روی OVERWRITE یا SUMMATION تنظیم شده است.

جمع‌بندی سطح ردیف داده‌های هزینه در مقابل بازنویسی

شما همچنین می توانید با گنجاندن ستون ga:importBehavior در هدر، رفتار مجموعه داده را برای هر فایلی که آپلود می کنید، لغو کنید. بر اساس ردیف در هر ردیف، می‌توانید مقدار ga:importBehavior روی SUMMATION یا OVERWRITE تنظیم کنید.

برای مثال، فایل زیر تمام داده‌های هزینه قبلی را برای Facebook/cpc و Yahoo/cpc بازنویسی می‌کند، اما ردیف Bing/cpc به هر داده هزینه موجود برای آن تاریخ خاص و ترکیب منبع/رسانه اضافه می‌شود.

ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE

قالب و محدودیت ها

برای اینکه داده ها در Google Analytics آپلود شوند، باید در یک فایل CSV با فرمت مناسب باشند. این بخش محدودیت‌هایی را توضیح می‌دهد که باید قبل از اینکه برای بارگذاری در همه انواع داده‌های وارد شده معتبر در نظر گرفته شود، رعایت شود.

اگر هر یک از محدودیت های زیر نقض شود یا اگر خطای تجزیه وجود داشته باشد، درخواست آپلود با پیام های خطا ناموفق خواهد بود. API حداکثر 10 خطا را در یک پاسخ گزارش می کند تا به کاربران کمک کند تعداد آپلودهای نامعتبر را کاهش دهند.

محدودیت های فایل

• رمزگذاری: UTF-8
• محدودیت حجم فایل: 1 گیگابایت

محدودیت های سرصفحه

• سطر اول به عنوان سرفصل ستون در نظر گرفته می شود و الزامی است. باید ابعاد و معیارهای آن ستون خاص را مشخص کند.

محدودیت های ردیف

• محدودیت ردیف 1 مگابایت وجود دارد.

قالب بندی سلولی

• سلول ها می توانند حداکثر 2048 کاراکتر داشته باشند.
• فضاهای پیشرو و انتهایی برای یک سلول خالی خواهد شد.
• برای مشخص کردن کاما در یک سلول، مقدار سلول باید داخل گیومه های دوبل باشد. به عنوان مثال، source1,"medium,ether",group1,100 - مقدار سلول دوم متوسط، اتر است.
• برای مشخص کردن دو گیومه در یک سلول، علاوه بر شروع و پایان دو گیومه، با یک نقل قول مضاعف دیگر از دو کوتیشن فرار کنید. به عنوان مثال، source1,"medium""ether",group1,100 - مقدار سلول دوم medium"ether ​​است.