پس از تنظیم برنامه مشتری خود همانطور که در My First App توضیح داده شده است، می توانید از Search Ads 360 API برای درخواست و دانلود گزارش ها استفاده کنید. شما می توانید یکی از انواع درخواست های زیر را ارائه دهید:
- همزمان
فقط به یک درخواست نیاز دارد و گزارش را در یک پاسخ با فرمت JSON برمی گرداند. درخواست های همزمان:
- فقط می‌تواند گزارش‌های حساب‌های آگهی‌دهنده و موتور را بازگرداند
- مشتری خود را مسدود کنید تا زمانی که Search Ads 360 گزارش را ایجاد کند
اگر گزارش‌های حساب موتور یا تبلیغ‌کننده بزرگ را درخواست می‌کنید، ما رویکرد ناهمزمان را توصیه می‌کنیم.
- نامتقارن
از شما می خواهد که یک درخواست اولیه ارسال کنید که داده های مورد نظر شما را در گزارش مشخص می کند. سپس درخواست‌های اضافی را برای نظرسنجی Search Ads 360 ارسال می‌کنید. وقتی Search Ads 360 تولید گزارش را به پایان می‌رساند، درخواست‌هایی برای دانلود گزارش به‌عنوان یک یا چند فایل ارسال می‌کنید. درخواست های ناهمزمان:
- می تواند هر نوع گزارشی را برگرداند
- گزارش های بسیار بزرگ را به چندین فایل تقسیم می کند
- گزارش ها را به صورت CSV یا TSV قالب بندی می کند
مدل داده: سطرها و ستون ها
Search Ads 360 داده ها را در یک گزارش در ردیف ها و ستون ها سازماندهی می کند. نوع گزارشی که درخواست می کنید ردیف هایی را که برگردانده می شوند تعیین می کند. به عنوان مثال، اگر درخواست شما گزارش کلمه کلیدی باشد، هر ردیف حاوی اطلاعاتی در مورد یک کلمه کلیدی خواهد بود. برای فهرستی از انواع گزارش به مرجع انواع گزارش مراجعه کنید. شما با نامگذاری هر ستون در درخواست گزارش خود مشخص می کنید کدام ستون ها را در گزارش می خواهید. برای فهرست ستون هایی که می توان برای هر نوع گزارش برگرداند، به مرجع انواع گزارش مراجعه کنید.
رفتارهای ستونی
رفتار یک ستون به نوع داده ای که ستون حاوی آن است بستگی دارد (مرجع انواع گزارش رفتار هر ستون را نشان می دهد):
ستون های مشخصه یک ستون ویژگی حاوی داده‌هایی است که یک موجودیت را در یک کمپین پیکربندی یا شناسایی می‌کند، مانند نام کمپین یا پیشنهاد کلمه کلیدی. Search Ads 360 API همیشه مقدار فعلی یک ستون مشخصه را بدون توجه به تاریخ یا محدوده تاریخی مشخص شده در یک درخواست برمی‌گرداند. به عنوان مثال، اگر دیروز پیشنهاد یک کلمه کلیدی را از 2.00 به 1.50 تغییر دهید و سپس گزارشی را برای داده های ماه گذشته درخواست کنید، این گزارش مقدار 1.50 را برای پیشنهاد کلمه کلیدی برمی گرداند.
ستون های متریک یک ستون متریک حاوی داده‌هایی درباره عملکرد کمپین شما است، مانند تعداد کلیک‌های روی یک تبلیغ، تعداد بازدیدهایی که توسط یک برچسب Floodlight ثبت شده است، یا درآمد. مگر اینکه محدوده زمانی یک روز را مشخص کنید ، API یک مقدار کل را برای ستون‌های متریک برمی‌گرداند. به عنوان مثال، اگر گزارشی را برای داده های ماه گذشته درخواست کنید، API کل تعداد کلیک های ماه گذشته را برمی گرداند.
ستون های بخش . یک ستون بخش داده ها را به ردیف های جداگانه تقسیم می کند. به عنوان مثال،
dateیک ستون بخش است که می توانید برای بسیاری از انواع گزارش ها مشخص کنید. اگر ستونdateدر گزارش کلمه کلیدی با محدوده تاریخ 01-01-2013 تا 07-01-2013 مشخص کنید، API هفت ردیف را برای هر کلمه کلیدی برمی گرداند که هر کدام مربوط به یک روز است و معیارهای آن روز را نمایش می دهد. به گزارش های تقسیم شده مراجعه کنید.
ارزها
درخواست گزارش شما برای مشخص کردن واحد پولی داده‌های پولی (هم ویژگی‌هایی مانند dailyBudget و هم معیارهایی مانند cost ) لازم است. می توانید یکی از موارد زیر را مشخص کنید:
- واحد پول آژانس، اگر گزارش به حساب آژانس، تبلیغ‌کننده یا موتور اختصاص داده شده باشد.
- واحد پول آگهی‌دهنده، اگر گزارش به حساب تبلیغ‌کننده یا موتور اختصاص داده شده باشد.
- واحد پول حساب موتور، در صورتی که گزارش در محدوده یک حساب موتور باشد.
- دلار آمریکا
از ویژگی Reports.request.statisticsCurrency request برای تعیین ارز استفاده کنید.
خود گزارش واحد پول را در ویژگی Reports.statisticsCurrencyCode نشان می دهد.
منطقه زمانی
معیارهای Search Ads 360 در تاریخ‌های بدون منطقه زمانی ذخیره می‌شوند. این تاریخ‌ها با منطقه زمانی حساب موتور برای معیارهای موتور (مانند کلیک‌ها، نمایش‌ها و بازدیدها) و منطقه زمانی شبکه مدیریت کمپین برای معیارهای تبدیل (مانند اقدامات، تراکنش‌ها و درآمد) مطابقت دارند. وقتی هر سنجه در یک گزارش از همان منطقه زمانی می آید، آن منطقه زمانی در درخواست بازگردانده می شود. در غیر این صورت، هیچ منطقه زمانی برگردانده نخواهد شد. درخواست‌های شما می‌توانند Reports.request.verifySingleTimeZone : true تا ناموفق که معیارهای بیش از یک منطقه زمانی را ارائه می‌دهند.
اگر همه معیارهای موجود در یک گزارش از یک منطقه زمانی باشند، آن منطقه زمانی در Reports.statisticsTimeZoneReports برگردانده می‌شود.