تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مواد العرض هي وحدات من البيانات القابلة للمشاركة، مثل الصور والفيديوهات والعناوين والأوصاف، ويتم استخدامها لإنشاء أنواع مختلفة من الإعلانات بأشكال متعدّدة، مثل الإعلانات الصورية وإعلانات YouTube وإعلانات متجر التطبيقات وغيرها.
العناصر
في ما يلي أبسط العناصر في واجهة برمجة التطبيقات:
Asset: وحدة من بيانات الإعلانات القابلة للمشاركة
AssetType: نوع المحتوى الذي تتضمّنه مادة العرض، مثل نص أو صورة
AssetFieldType: كيفية استخدام مادة العرض، مثلاً، يمكن استخدام نوع مادة العرض النصية كنوع حقل مادة عرض عنوان أو وصف
AssetSet: مجموعة من مواد العرض تتمحور حول موضوع معيّن أو منظَّمة حسب الحملة
AssetSetType: فئة مجموعة مواد العرض
هناك عناصر تمثّل الروابط بين مواد العرض ومجموعات مواد العرض والمجموعات الإعلانية والحملات والعملاء:
الروابط المؤدية إلى مواد العرض
CustomerAsset: الرابط بين العميل ومادة العرض
CampaignAsset: الرابط بين الحملة ومادة العرض
AdGroupAsset: الرابط بين مجموعة إعلانية ومادة عرض
AssetSetAsset: الرابط بين مجموعة مواد العرض ومادة العرض
روابط لمجموعات مواد العرض
CustomerAssetSet: الرابط بين العميل ومجموعة مواد العرض
CampaignAssetSet: الرابط بين حملة ومجموعة مواد عرض
AdGroupAssetSet: الرابط بين مجموعة إعلانية ومجموعة مواد عرض
مثال على مواد عرض الحملة
في ما يلي تمثيل مرئي لطريقة ربط بعض العناصر. يبدأ المثال بالحملات في الأعلى، ولكن التسلسل الهرمي نفسه ينطبق أيضًا على العملاء والمجموعات الإعلانية.
مخطّط لمجموعات مواد العرض في الحملة
قبل إنشاء CampaignAssetSet، عليك أولاً إنشاء Campaign وAssetSet يحتوي على مادة عرض واحدة أو أكثر. يمكنك تجميع مواد العرض لإنشاء مستودع لجميع أشكال الإعلانات السارية في حملتك، أو السماح لـ "إعلانات Google" بمزج مواد العرض المتاحة ومطابقتها استنادًا إلى القناة التي يتم عرض الإعلان عليها، مثل YouTube وGmail و"بحث Google" وغيرها.
أنواع مواد العرض المرتبطة بالإعلانات
يمكن ربط بعض أنواع مواد العرض بالإعلانات مباشرةً.
نوع مادة العرض
AssetFieldType
نوع الإعلان
فيديو
YOUTUBE_VIDEO
إعلان على التطبيق إعلان جذب إلى تطبيق إعلان محلي إعلان صوري متجاوب
حِزمة الوسائط
MEDIA_BUNDLE CUSTOM_LAYOUT
إعلان التطبيق إعلان التحميل الصوري
صورة
MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE
إعلان على التطبيق إعلان جذب إلى تطبيق إعلان محلي إعلان صوري متجاوب
إعلان التطبيق إعلان التفاعل مع التطبيق إعلان محلي إعلان صوري متجاوب إعلان متجاوب على شبكة البحث إعلان "الحملة الذكية"
الحث على اتخاذ إجراء
CALL_TO_ACTION
إعلان محلي إعلان صوري متجاوب
أنواع مواد العرض المرتبطة بالعملاء والحملات والمجموعات الإعلانية
يمكن ربط بعض أنواع مواد العرض بالعملاء أو الحملات أو المجموعات الإعلانية من خلال عناصر الربط.
نوع مادة العرض
AssetFieldType
الربط
قابلة للتغيير
رسالة من عميل
BUSINESS_MESSAGE
AdGroupAsset CampaignAsset CustomerAsset
نعم
نص
BUSINESS_NAME
CampaignAsset CustomerAsset
لا
صورة
AD_IMAGE
AdGroupAsset CampaignAsset
لا
صورة
BUSINESS_LOGO
CampaignAsset CustomerAsset
لا
نموذج العميل المحتمل
LEAD_FORM
CampaignAsset
نعم
عرض ترويجي
الترويج
AdGroupAsset CampaignAsset CustomerAsset
نعم
وسيلة شرح
وسيلة شرح
AdGroupAsset CampaignAsset CustomerAsset
نعم
مقتطف من الموقع
STRUCTURED_SNIPPET
AdGroupAsset CampaignAsset CustomerAsset
نعم
رابط أقسام موقع
رابط أقسام الموقع
AdGroupAsset CampaignAsset CustomerAsset
نعم
تطبيق للأجهزة الجوّالة
MOBILE_APP
AdGroupAsset CampaignAsset CustomerAsset
نعم
وسيلة شرح الفندق
HOTEL_CALLOUT
AdGroupAsset CampaignAsset CustomerAsset
نعم
الاتصال
اتصال
AdGroupAsset CampaignAsset CustomerAsset
نعم
السعر
السعر
AdGroupAsset CampaignAsset CustomerAsset
نعم
مواد عرض المواقع الجغرافية
تتم معالجة مواد عرض الموقع الجغرافي بشكل مختلف عن أنواع مواد العرض الأخرى. راجِع مواد عرض خاصة بالموقع الجغرافي لمعرفة التفاصيل.
مواد عرض منشأة تلقائيًا
لا يمكن تعديل مواد العرض المنشأة تلقائيًا. تشير
AssetSource إلى ما إذا كانت مادة العرض قد أنشأها المستخدم أو أنشأها النظام تلقائيًا. لا يمكن ربط الأنواع القابلة للتعديل، مثل رابط أقسام الموقع، بمواد العرض المنشأة تلقائيًا.
أنواع مواد العرض المرتبطة بمجموعات مواد العرض
يمكن ربط أنواع معيّنة من مواد العرض بأنواع محدّدة من مجموعات مواد العرض.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAssets are shareable data units like images and text, used to build various ad types across different platforms.\u003c/p\u003e\n"],["\u003cp\u003eAssets are organized into Asset Sets and linked to Campaigns, Ad Groups, and Customers for streamlined management.\u003c/p\u003e\n"],["\u003cp\u003eSpecific Asset Types can be directly linked to ads or linked through linkage objects for greater flexibility.\u003c/p\u003e\n"],["\u003cp\u003eSome Asset Types are automatically created by the system and cannot be modified, indicated by their AssetSource.\u003c/p\u003e\n"],["\u003cp\u003eCertain Asset Types are designed to be used with specific Asset Set Types for specialized campaign setups.\u003c/p\u003e\n"]]],[],null,["Assets are units of shareable data---such as images, videos, headlines, and\ndescriptions---that are used to construct different types of ads across\nmultiple formats, such as display, YouTube, app store, and others.\n\nObjects\n\nThe most basic objects in the API are the following:\n\n- **`Asset`:** A unit of shareable advertising data\n - **`AssetType`:** The kind of content the asset contains---for example, text or image\n - **`AssetFieldType`:** How the asset is used---for example, a text asset type can be used as a headline or a description asset field type\n- **`AssetSet`** : A collection of assets centered around a theme or organized by campaign\n - **`AssetSetType`**: The class of the asset set\n\nThere are objects that represent links among assets, asset sets, ad groups,\ncampaigns, and customers:\n\n- Linkages to assets\n\n - **`CustomerAsset`:** The link between a customer and an asset\n - **`CampaignAsset`:** The link between a campaign and an asset\n - **`AdGroupAsset`:** The link between an ad group and an asset\n - **`AssetSetAsset`:** The link between an asset set and an asset\n- Linkages to asset sets\n\n - **`CustomerAssetSet`:** The link between a customer and an asset set\n - **`CampaignAssetSet`:** The link between a campaign and an asset set\n - **`AdGroupAssetSet`:** The link between an ad group and an asset set\n\nCampaign assets example\n\nHere's a visual representation of how some of the objects can be linked. The\nexample starts with campaigns at the top, but the same hierarchy also applies to\ncustomers and ad groups.\nDiagram of campaign asset sets\n\nBefore you create a `CampaignAssetSet`, you must first create a\n[`Campaign`](/google-ads/api/docs/campaigns/create-campaigns) and an `AssetSet` containing\none or more assets. You can assemble assets to create an inventory for all\napplicable ad formats in your campaign, or let Google Ads mix and match available\nassets based on which channel the ad is being served: YouTube, Gmail, Search,\nand others.\n| **Key Point:** A `Campaign` can link to one or more `CampaignAssetSet` objects, but each `CampaignAssetSet` can be linked to only one `Campaign`.\n\nAsset types linked to ads\n\nSome asset types can be linked directly to ads.\n\n| Asset type | AssetFieldType | Ad type |\n|----------------|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|\n| Video | YOUTUBE_VIDEO | App ad App engagement ad Local ad Responsive display ad |\n| Media bundle | MEDIA_BUNDLE CUSTOM_LAYOUT | App ad Display upload Ad |\n| Image | MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE | App ad App engagement ad Local ad Responsive display ad |\n| Text | HEADLINE LONG_HEADLINE DESCRIPTION MANDATORY_AD_TEXT CALL_TO_ACTION_SELECTION BUSINESS_NAME | App ad App engagement ad Local ad Responsive display ad Responsive search ad Smart campaign ad |\n| Call to Action | CALL_TO_ACTION | Local ad Responsive display ad |\n\nAsset types linked to customers, campaigns, and ad groups\n\nSome types of assets can be linked to customers, campaigns, or ad groups through\nlinkage objects.\n| **Note:** For `BUSINESS_MESSAGE` assets:\n|\n| - Each customer can have only one active business message asset.\n| - At the campaign and ad group levels, you can assign only one active business message asset for each message provider type.\n\n| Asset type | AssetFieldType | Linkage | Mutable |\n|--------------------|--------------------|------------------------------------------|---------|\n| Business message | BUSINESS_MESSAGE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Text | BUSINESS_NAME | CampaignAsset CustomerAsset | No |\n| Image | AD_IMAGE | AdGroupAsset CampaignAsset | No |\n| Image | BUSINESS_LOGO | CampaignAsset CustomerAsset | No |\n| Lead form | LEAD_FORM | CampaignAsset | Yes |\n| Promotion | PROMOTION | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Callout | CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Structured snippet | STRUCTURED_SNIPPET | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Sitelink | SITELINK | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Mobile app | MOBILE_APP | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Hotel callout | HOTEL_CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Call | CALL | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Price | PRICE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n\nLocation assets\n\nLocation assets are handled differently from other asset types. See [Location\nassets](/google-ads/api/docs/assets/location-assets) for details.\n\nAutomatically created assets\n\nAutomatically created assets cannot be modified. The\n[`AssetSource`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource) indicates whether an\nasset was user-created or was automatically generated by the system. Mutable\ntypes like sitelink can't be linked to automatically created assets.\n\nAsset types linked to asset sets\n\nCertain asset types can be linked to specific types of asset sets.\n\n| AssetType | AssetSetType | Linkage | Mutable |\n|----------------------------|------------------------------|---------------------------------------------------|-----------------------|\n| PAGE_FEED | PAGE_FEED | CampaignAssetSet | Yes |\n| DYNAMIC_EDUCATION | DYNAMIC_EDUCATION | CampaignAssetSet | Yes |\n| DYNAMIC_CUSTOM | DYNAMIC_CUSTOM | CampaignAssetSet | Yes |\n| DYNAMIC_HOTELS_AND_RENTALS | DYNAMIC_HOTELS_AND_RENTALS | CampaignAssetSet | Yes |\n| DYNAMIC_REAL_ESTATE | DYNAMIC_REAL_ESTATE | CampaignAssetSet | Yes |\n| DYNAMIC_LOCAL | DYNAMIC_LOCAL | CampaignAssetSet | Yes |\n| DYNAMIC_FLIGHTS | DYNAMIC_FLIGHTS | CampaignAssetSet | Yes |\n| DYNAMIC_JOBS | DYNAMIC_JOBS | CampaignAssetSet | Yes |\n| DYNAMIC_TRAVEL | DYNAMIC_TRAVEL | CampaignAssetSet | Yes |\n| LOCATION | LOCATION_SYNC | CustomerAssetSet CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | GMB_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | CHAIN_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | STATIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |"]]
