این سند نمای کلی سطح بالایی از API گزارش قیف چند کانالی Google Analytics را ارائه می دهد. برای مرجع دقیق API، راهنمای مرجع را بخوانید.
معرفی
API گزارش قیفهای چند کانالی به شما امکان میدهد اطلاعات قیفهای چند کانالی را برای یک کاربر تأیید شده درخواست کنید. دادهها از دادههای مسیر تبدیل مشتق شدهاند، که تعاملات کاربر با منابع ترافیک مختلف را در چندین جلسه قبل از تبدیل نشان میدهد. این به شما امکان می دهد تا بررسی کنید که چگونه چندین کانال بازاریابی در طول زمان بر تبدیل ها تأثیر می گذارد. برای جزئیات بیشتر در مورد دادههای موجود، درباره قیفهای چند کانالی و همچنین درباره دادههای قیف چند کانالی را بخوانید.
با API گزارش قیف چند کانالی می توانید:
- با استفاده از داده های قیف چند کانالی، گزارش های سفارشی ایجاد کنید. به عنوان مثال، میتوانید از دادههای Top Conversion Paths برای گزارش ویژگیهایی مانند موقعیت نسبی تعاملات در مسیر تبدیل استفاده کنید.
- داده های قیف چند کانالی را با داده های کسب و کار خود ادغام کنید. برای مثال، میتوانید دادههای تبدیل آنلاین را با دادههای فروش آفلاین و دادههای هزینه رسانه مرتبط کنید تا به تصویر کاملتری از ROI بازاریابی برسید.
- نمایش قیف های چند کاناله در محیط های جدید. برای مثال، میتوانید تجسمها و سایر نمایشهایی از دادهها ایجاد کنید که ارزش کانالهای بازاریابی مختلف را در ایجاد تبدیلها به هم منتقل میکنند.
بررسی اجمالی مفهومی
مفاهیم اساسی زیربنای API گزارش قیف چند کانالی عبارتند از:
- نحوه ارتباط گزارش ها با کاربران و بازدیدها (نمایه ها).
- ساختار یک گزارش و نحوه ساخت پرس و جو.
- داده های مسیر تبدیل و مفاهیم اسناد.
- کار با پاسخ API.
گزارش ها، کاربران و بازدیدها (نمایه ها)
برای درخواست داده های گزارش برای یک کاربر، برنامه شما باید کاربر را شناسایی کند و یک نمای (نمایه) برای بازیابی داده ها مشخص کند. یک کاربر با دریافت اعتبار مجوز و ارسال آنها در هر درخواست API شناسایی می شود. یک نما (نمایه) با شناسه View (نمایه) شناسایی می شود. نماها (نمایه ها)، در میان سایر نهادها، بخشی از سلسله مراتب پیکربندی Google Analytics هستند. برنامه شما می تواند از مدیریت API برای عبور از این سلسله مراتب و دریافت شناسه view (نمایه) استفاده کند.
پرس و جو برای ابعاد و متریک
شما API مربوط به داده های گزارش Google Analytics را که شامل ابعاد و معیارها است، پرس و جو می کنید. معیارها اندازه گیری های فردی فعالیت کاربر مانند تعداد و مقادیر تبدیل هستند. ابعاد معیارها را در برخی از معیارهای رایج تجزیه میکنند و میتوانند مقادیر ابتدایی باشند که رویدادهای تعامل فردی را در مسیرهای تبدیل نشان میدهند، یا دنبالههایی باشند که مجموعهای از رویدادهای تعامل کل مسیرهای تبدیل را نشان میدهند.
از راهنمای مرجع ابعاد و معیارها برای کاوش در تمام ابعاد و معیارهای ارائه شده از طریق API استفاده کنید. همچنین، راهنمای مرجع API گزارش قیف چند کانالی را بخوانید تا در مورد نحوه تعیین ابعاد و معیارها در یک پرس و جوی API بیاموزید.
داده های مسیر تبدیل و مفاهیم اسناد
گزارشهای قیف چند کانالی از مسیرهای تبدیل تولید میشوند: دنبالهای از تعاملات (مثلاً کلیکها/ارجاعها از کانالها) که به هر تبدیل و تراکنش منجر میشود. مسیرهای تبدیل از طریق کوکی Google Analytics جمع آوری می شوند که تعاملات توسط همان مرورگر و ماشین را ثبت می کند. دادههای قیف چند کانالی، دادههای تبدیل Google Analytics را با دنبالهای از تعاملات ثبتشده در کوکی ترکیب میکند.
قیفهای چند کانالی، درخواستها را بر اساس مجموعه نمونهای از ۱ میلیون مسیر تبدیل، برمیگردانند. اگر محدوده تاریخ شامل تعداد کل تبدیل 1 میلیون یا کمتر باشد، از گزارش نمونه برداری نمی شود. در غیر این صورت، یک مجموعه نمونه 1 میلیونی برای تولید نتایج استفاده خواهد شد. این در تضاد با عملکرد Core Reporting است که بر اساس جلسات نمونه برداری می کند. برای اطلاعات بیشتر در مورد دادهها و مفاهیم مرتبط، لطفاً درباره دادههای قیف چند کانالی را بخوانید. همچنین ممکن است خواندن مقاله تجزیه و تحلیل مشارکت های کانال که مفاهیم اصلی مانند تبدیل های کمکی را تعریف می کند مفید باشد.
کار با گزارش ها
داده های بازگردانده شده از API را می توان به عنوان یک جدول با سربرگ و لیستی از ردیف ها در نظر گرفت. هر پاسخ API از یک هدر تشکیل شده است که نام و نوع داده هر ستون را توصیف می کند. پاسخ همچنین حاوی لیستی از ردیفها است که در آن هر ردیف فهرستی از سلولها با دادهها به ترتیب سرصفحهها است. برای اطلاعات بیشتر درباره پاسخ API ، راهنمای مرجع گزارش قیف چند کانالی را بخوانید.
هر مقدار سلول یا حاوی یک مقدار اولیه از نوع رشته یا یک مقدار مسیر تبدیل است. این مقدار مسیر تبدیل، آرایهای از اشیاء است که تمام گرههای آن مسیر را نشان میدهد. ما میتوانیم از اطلاعات نوع در سرفصلهای ستون برای تجزیه مقدار هر سلول به نوع مناسب خود استفاده کنیم. بیشتر از این اینجا .
خط مشی سهمیه
پرس و جو داده قیف چند کاناله میلیون ها عملیات را انجام می دهد. برای محافظت از سیستم در برابر دریافت عملیات بیشتر از توان آن، و برای اطمینان از توزیع عادلانه منابع سیستم، لازم است از یک سیستم سهمیه استفاده شود. برای جزئیات بیشتر، راهنمای محدودیت ها و سهمیه ها را بخوانید.
مراحل بعدی
اکنون که متوجه شدید که API چگونه کار می کند، ما مجموعه ای از منابع برای کمک به شما در شروع کار داریم:
- برای یادگیری نحوه کار با API ، راهنمای توسعه دهنده را بخوانید.
- از ابزار تعاملی Google APIs Explorer برای ساخت پرس و جوها و مشاهده پاسخ از طریق API استفاده کنید.
- برای فهرستی از تمام دادههای موجود از طریق API ، راهنمای مرجع ابعاد و معیارها را بررسی کنید.
- صفحه Libraries & Samples را برای فهرستی از تمام کتابخانههای مشتری موجود که میتوان با این API استفاده کرد، بررسی کنید.