API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google
searchads-api-announcements بپیوندید تا در مورد پیشرفتها و نسخههای آینده بهروز باشید.
واکشی ویژگیها و معیارهای دارایی
ویژگی های دارایی
میتوانید فهرستی از داراییها و ویژگیهای آنها را با ارسال یک عبارت Search Ads 360 Query Language به SearchAds360Service دریافت کنید. دارایی ها توسط نهاد asset
نشان داده می شوند که تعدادی از زمینه های خاص دارایی را نشان می دهد.
جستار زیر همه داراییهای موجود در حساب تبلیغکننده را به همراه نام و نوع منبع آنها فهرست میکند.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.type
FROM asset
توجه داشته باشید که ویژگیهای نوع خاصی وجود دارد که میتوانید برای خواندن ویژگیهای خاص داراییهایی مانند SitelinkAsset
یا MobileAppAsset
به جستار بالا اضافه کنید.
برای مثال، درخواست زیر شناسههای برنامه تلفن همراه را برای همه اشیاء MobileAppAsset
در یک حساب با فیلتر کردن مقدار asset.type
برای MobileAppAsset
فهرست میکند.
SELECT
asset.id,
asset.name,
asset.resource_name,
asset.mobile_app_asset.app_store
FROM asset
WHERE asset.type = 'MOBILE_APP'
معیارهای دارایی
معیارهای دارایی از طریق چند منبع در دسترس هستند:
با استفاده از این منابع، معیارهای دارایی را می توان در هر سطح مربوطه جستجو کرد. برای مثال، هنگام جستوجوی منبع ad_group_asset
، میتوان از فیلد ad_group.id
برای بخشبندی نتایج استفاده کرد، بنابراین معیارهایی را برای هر ترکیب منحصربهفرد از ad_group
و asset
بازیابی کرد:
SELECT
ad_group.id,
asset.id,
metrics.clicks,
metrics.impressions
FROM ad_group_asset
WHERE segments.date DURING LAST_MONTH
ORDER BY metrics.impressions DESC
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-24 بهوقت ساعت هماهنگ جهانی."],[[["Retrieve a list of assets and their attributes, including resource name and type, using Search Ads 360 Query Language."],["Access type-specific attributes, such as mobile app IDs, by filtering the `asset.type` value in your query."],["Query asset metrics at the ad group, campaign, or customer level through respective resources like `ad_group_asset`, `campaign_asset`, and `customer_asset`."],["Segment asset metric results by fields like `ad_group.id` to analyze performance for specific combinations of assets and ad groups, campaigns, or customers."]]],["Assets and their attributes can be retrieved by sending a Search Ads 360 Query Language query to the SearchAds360Service, using the `asset` entity. Type-specific attributes can be added to queries. Asset metrics are available through `ad_group_asset`, `campaign_asset`, and `customer_asset` resources, enabling queries at various levels. For example, metrics can be retrieved for each unique combination of `ad_group` and `asset` using `ad_group_asset` resource.\n"]]