رابط برنامهنویسی کاربردی داده گوگل آنالیتیکس نسخه ۱، گزارشهایی را برای ویژگیهای گوگل آنالیتیکس تولید میکند. درخواستهای API ملزم به مشخص کردن یک شناسه عددی برای ویژگی گوگل آنالیتیکس هستند. مستندات و کد نمونه رابط برنامهنویسی کاربردی داده به این شناسه با عنوان GA_PROPERTY_ID اشاره دارند.
کاربرد
تمام متدهای Data API نیاز دارند که شناسه ویژگی Google Analytics در مسیر درخواست URL به شکل properties/GA_PROPERTY_ID مشخص شود، مانند:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
اگر از یکی از کتابخانههای کلاینت Data API استفاده میکنید، نیازی به دستکاری دستی مسیر URL درخواست نیست. اکثر کلاینتهای API یک پارامتر property ارائه میدهند که رشتهای به شکل properties/GA_PROPERTY_ID را دریافت میکند. برای مثالهایی از استفاده از کتابخانههای کلاینت، به راهنمای شروع سریع مراجعه کنید.
شناسه ملک من چیست؟
اگر گزارشهای تحلیلی را در هر یک از محصولات زیر پیکربندی کردهاید، میتوانید از API داده استفاده کنید:
گوگل آنالیتیکس
گوگل آنالیتیکس چندین نوع ویژگی (Property) دارد. برای استفاده از Data API، یک ویژگی باید جزو ویژگیهای گوگل آنالیتیکس باشد، برخلاف Universal Analytics. Universal Analytics نسخه قدیمیتر گوگل آنالیتیکس است و توسط Data API پشتیبانی نمیشود.
برای تعیین شناسه ویژگی گوگل آنالیتیکس:
- برای دسترسی به گوگل آنالیتیکس به آدرس https://analytics.google.com/ مراجعه کنید.
- مدیر را انتخاب کنید.
- ملک را انتخاب کنید.
- تنظیمات ویژگی را انتخاب کنید.
اگر تنظیمات ویژگی، یک «شناسه ویژگی» عددی مانند «۱۲۳...» را نشان میدهد، این شناسه عددی ویژگی گوگل آنالیتیکس شماست.
فایربیس
اگر گوگل آنالیتیکس را به فایربیس لینک کرده باشید، دادههای تحلیلی پروژه خود را در فایربیس مشاهده خواهید کرد. برای کسب اطلاعات بیشتر در مورد لینک دادن، به لینک کردن گوگل آنالیتیکس به فایربیس مراجعه کنید.
برای تعیین ویژگی Google Analytics برای یک پروژه Firebase:
- از کنسول فایربیس به آدرس https://console.firebase.google.com/ دیدن کنید.
- پروژه خود را انتخاب کنید.
- تنظیمات پروژه را انتخاب کنید.
- ادغامها را انتخاب کنید.
- ادغام گوگل آنالیتیکس خود را انتخاب کنید.
صفحه ادغام گوگل آنالیتیکس یک «شناسه ویژگی» عددی مانند «123...» را نشان میدهد. این شناسه عددی ویژگی گوگل آنالیتیکس شماست.
ادموب
اگر از AdMob استفاده میکنید، برنامه شما باید برای استفاده از Google Analytics به Firebase متصل باشد. برای دسترسی به معیارهای کاربر در AdMob و استفاده از API داده Google Analytics، باید موارد زیر را داشته باشید:
- برنامه AdMob خود را به یک پروژه Firebase پیوند دادید .
- کیت توسعه نرمافزار (SDK) گوگل آنالیتیکس برای فایربیس را در برنامه خود ادغام کنید.
- معیارهای کاربر برای برنامه شما در AdMob فعال شد .
این مراحل برای جمعآوری معیارهای کاربر برای AdMob و بررسی و کار با این دادهها با استفاده از Google Analytics و Data API ضروری است.
برای یافتن شناسه ویژگی گوگل آنالیتیکس مرتبط با برنامه AdMob خود:
- وارد حساب کاربری ادموب شوید.
- برنامه خود را از لیست برنامهها انتخاب کنید.
- در نوار کناری، تنظیمات برنامه را انتخاب کنید.
- در بخش Firebase ، باید جزئیاتی در مورد پروژه Firebase لینک شده را مشاهده کنید. برای رفتن به کنسول Firebase، روی لینک یا دکمه مربوطه کلیک کنید.
- مسیر جایگزین: گاهی اوقات، ممکن است لینکی به داشبورد Firebase در صفحه نمای کلی برنامه موجود باشد.
- در کنسول Firebase، شما در حال مشاهده پروژه لینک شده به برنامه AdMob خود هستید. دستورالعملهای ذکر شده در بخش Firebase را برای یافتن شناسه ویژگی دنبال کنید:
- تنظیمات پروژه (آیکون چرخدنده کنار نمای کلی پروژه) را انتخاب کنید.
- به برگه ادغامها بروید.
- برای مشاهده شناسه ملک، گزینه ادغام با گوگل آنالیتیکس را انتخاب کنید.