يمكنك إنشاء "حملات تطبيقات" باستخدام Google Ads API للترويج لتطبيقك على الأجهزة الجوّالة على "شبكة بحث Google" وGoogle Play وYouTube وAdMob و"اقتراحات" و"شبكة Google الإعلانية". يمكنك تحسين الحملات لزيادة عمليات التثبيت أو الإجراءات داخل التطبيق أو قيمة الإحالة الناجحة أو عمليات التسجيل المُسبَق على Android. تتحمّل الحملات المفعَّلة رسوم عرض الإعلانات العادية على "إعلانات Google" بما يصل إلى ميزانيتك.
الإعداد
يحدّد هدف حملتك إعدادات واجهة برمجة التطبيقات، سواء كان التكلفة لكل تثبيت (CPI) أو التكلفة لكل إجراء (CPA) أو عائد الإنفاق الإعلاني (ROAS) أو عمليات التسجيل المُسبَق. ابحث عن هدفك في الجدول التالي قبل إكمال خطوات الإنشاء. للبحث عن عنصر تحكّم في واجهة مستخدم "إعلانات Google"، يُرجى الاطّلاع على ربط إعدادات واجهة مستخدم "إعلانات Google" بحقول واجهة برمجة التطبيقات أو لمحة عن "حملات التطبيقات".
| اختيار الهدف وواجهة مستخدم "إعلانات Google" | تعداد النوع الفرعي والهدف | استراتيجية عروض الأسعار | إعدادات الإحالات الناجحة (conversion_actions) |
|---|---|---|---|
|
زيادة عمليات التثبيت (التكلفة المستهدفة لكل تثبيت): عدد عمليات التثبيت > جميع المستخدمين، مع اختيار تحديد تكلفة مستهدفة لكل تثبيت (اختياري). |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
|
target_cpa
(target_cpa_micros
= التكلفة المستهدَفة لكل تثبيت).
|
اختياري: ما يصل إلى إجراء واحد من
DOWNLOAD
في
conversion_actions.
|
|
زيادة عمليات التثبيت بدون تحديد تكلفة مستهدَفة لكل تثبيت: عدد عمليات التثبيت > جميع المستخدمين، مع إزالة العلامة من المربّع تحديد تكلفة مستهدفة لكل تثبيت (اختياري). |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
|
maximize_conversions
(بدون target_cpa_micros).
|
اختياري: ما يصل إلى إجراء واحد من "DOWNLOAD".
|
|
عمليات التثبيت مع إجراء داخل التطبيق (التكلفة المستهدَفة لكل تثبيت) عدد عمليات التثبيت > المستخدمون المرجّح أن ينفّذوا إجراءً داخل التطبيق، التكلفة المستهدفة لكل تثبيت. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
|
target_cpa (target_cpa_micros = التكلفة المستهدَفة لكل تثبيت).
|
هذا العنصر مطلوب. إجراء واحد داخل التطبيق، بالإضافة إلى إجراء اختياري في "DOWNLOAD".
|
|
الإجراءات داخل التطبيق (سقف التكلفة المحدّد لكل إجراء): الإجراءات داخل التطبيق، تحديد التكلفة المستهدفة لكل إجراء داخل التطبيق (اختياري) (أو سقف التكلفة المحدّد لكل إجراء لجذب المستخدمين). |
APP_CAMPAIGN أو
APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
|
target_cpa (target_cpa_micros = سقف التكلفة المحدد لكل إجراء).
|
هذا العنصر مطلوب. الإجراءات بعد التثبيت اختياري
DOWNLOAD في APP_CAMPAIGN (ما مِن خيار في
التفاعل).
|
|
الإجراءات داخل التطبيق بدون سقف تكلفة محدد لكل إجراء: الإجراءات داخل التطبيق، تمت إزالة العلامة من المربّع تحديد التكلفة المستهدفة لكل إجراء داخل التطبيق (اختياري). |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
|
maximize_conversions (بدون
target_cpa_micros).
|
هذا العنصر مطلوب. الإجراءات التي يتم اتخاذها بعد التثبيت، بالإضافة إلى إجراء DOWNLOAD الاختياري
|
|
قيمة الإجراءات داخل التطبيق (عائد الإنفاق الإعلاني المستهدَف): قيمة الإجراء داخل التطبيق، ضبط عائد إنفاق إعلاني مستهدَف (اختياري) (أو عائد الإنفاق الإعلاني المستهدَف للتفاعل). |
APP_CAMPAIGN أو
APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
|
target_roas
(target_roas
= عائد الإنفاق الإعلاني المستهدَف).
|
هذا العنصر مطلوب. تمثّل هذه السمة إجراءات القيمة (مثل
Firebase أو
GOOGLE_PLAY_IN_APP_PURCHASE).
وهي اختيارية في DOWNLOAD على APP_CAMPAIGN فقط.
|
|
قيمة الإجراءات داخل التطبيق بدون عائد إنفاق إعلاني مستهدَف: قيمة الإجراء داخل التطبيق، تمت إزالة العلامة من المربّع تحديد عائد إنفاق إعلاني مستهدف (اختياري). |
APP_CAMPAIGN.OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
|
maximize_conversion_value
(بدون target_roas).
|
هذا العنصر مطلوب. إجراءات القيمة (مثل Firebase أو
GOOGLE_PLAY_IN_APP_PURCHASE)، بالإضافة إلى إجراء
DOWNLOAD الاختياري.
|
|
التسجيل المُسبَق للتطبيق (Android فقط) التسجيل المُسبَق (التكلفة المستهدفة للتسجيل المُسبَق) |
APP_CAMPAIGN_FOR_PRE_REGISTRATION
(GOOGLE_APP_STORE فقط)OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
|
target_cpa (target_cpa_micros = التكلفة المستهدَفة للتسجيل المُسبَق)
|
اترك selective_optimization بدون ضبط. أضِف
APP_PRE_REGISTRATION
إلى
optimization_goal_types.
|
الخطوات
يمكنك إنشاء جميع الموارد بشكل ذري في طلب واحد من النوع
GoogleAdsService.Mutate باستخدام معرّفات مؤقتة سالبة، أو يمكنك استدعاء
CampaignService.MutateCampaigns.
إعداد الحملة وإنشاؤها
اضبط مورد Campaign:
إنشاء
CampaignBudgetيومية لـcampaign_budgetمع ضبطamount_microsوexplicitly_sharedعلىfalse(القيمة التلقائية هيtrue، وتفشل الميزانيات المشتركة وميزانياتCUSTOM_PERIOD). يُرجى الاطّلاع على مقالة إنشاء ميزانيات الحملات.اضبط
name، واضبطstatusعلىPAUSEDأثناء إرفاق الإعلانات (يتم ضبطه تلقائيًا علىENABLED).اضبط السمة غير القابلة للتغيير
advertising_channel_typeعلىMULTI_CHANNELوالسمة غير القابلة للتغييرadvertising_channel_sub_typeعلىAPP_CAMPAIGNأوAPP_CAMPAIGN_FOR_ENGAGEMENTأوAPP_CAMPAIGN_FOR_PRE_REGISTRATION.اضبط السمة
contains_eu_political_advertisingعلىDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGأوCONTAINS_EU_POLITICAL_ADVERTISING. تتطلّب طلباتMutateCampaignsالمستقلة تقديم هذا الإقرار الخاص بالاتحاد الأوروبي (اختياري في الإصدار 26 والإصدارات الأحدث عند استهداف المواقع الجغرافية خارج الاتحاد الأوروبي فقط بشكل كامل، يُرجى الاطّلاع على الإعلانات السياسية عن الاتحاد الأوروبي).اضبط
app_campaign_settingعلى عنصرAppCampaignSetting(app_storeوapp_idغير قابلَين للتغيير):app_store:AppCampaignAppStore(GOOGLE_APP_STOREأوAPPLE_APP_STORE، يتطلّب التسجيل المُسبَقGOOGLE_APP_STORE).app_id: اسم حزمة Google Play (com.example.app) أو المعرّف الرقمي لمتجر تطبيقات Apple تتطلّب حملات التفاعل حدًا أدنى من عمليات التثبيت، بينما تتطلّب حملات التسجيل المُسبَق تطبيقًا غير منشور في Play Console ومتاحًا للتسجيل المُسبَق (غير مؤهَّل لـAPP_CAMPAIGNحتى يتم إطلاقه).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypeلهدفك (قابلة للتغيير).
اضبط استراتيجية عروض أسعار عادية على
Campaign(لا تتوفّر مواردBiddingStrategyللمحفظة). يؤدي تفعيل هدف اختياري في واجهة المستخدم إلى تبديل كل منbidding_strategy_goal_typeوحقل عروض الأسعارoneof:- التكلفة المستهدفة لكل تثبيت أو التكلفة المستهدفة للإجراء أو التسجيل المُسبَق: اضبط
target_cpaبقيمة موجبةtarget_cpa_microsبالوحدات الصغيرة لعملة الحساب (1500000= 1.50 وحدة، مثل 1.50 دولار أمريكي). - عائد الإنفاق الإعلاني المستهدَف: اضبط
target_roasباستخدامtarget_roasمن0.01إلى1000.0(3.0= عائد إنفاق إعلاني بنسبة %300). - تحقيق الحد الأقصى بدون استهداف (
APP_CAMPAIGNفقط): اضبط الحقل الفارغmaximize_conversionsأوmaximize_conversion_value. لا تضبط السمةmaximize_conversions.target_cpa_micros(تم رفضها فيMULTI_CHANNEL) أوmaximize_conversion_value.target_roas.
- التكلفة المستهدفة لكل تثبيت أو التكلفة المستهدفة للإجراء أو التسجيل المُسبَق: اضبط
ضبط أهداف الإحالات الناجحة أو التسجيل المُسبَق:
-
APP_CAMPAIGNوAPP_CAMPAIGN_FOR_ENGAGEMENT: أضِفConversionActionأسماء موارد مطابقة لـapp_idإلىselective_optimization.conversion_actions(وليسCampaignConversionGoalأوoptimization_goal_setting، راجِع أهداف الإحالات الناجحة للحملة). في APP_CAMPAIGN، يمكنك تضمين إجراء واحد (1) كحدّ أقصى من نوعDOWNLOAD، مثلGOOGLE_PLAY_DOWNLOADأو Firebasefirst_open(مطلوب في واجهة المستخدم، واختياري في واجهة برمجة التطبيقات، ومحظور في حملات التفاعل). APP_CAMPAIGN_FOR_PRE_REGISTRATION: يجب تركselective_optimizationبدون ضبط، وإضافةAPP_PRE_REGISTRATIONإلىoptimization_goal_setting.optimization_goal_types.
-
اختياري: بدءًا من الإصدار 24، اضبط
view_through_conversion_optimization_enabledعلىtrueفي حملات AndroidAPP_CAMPAIGNلتقديم عروض أسعار الإحالات الناجحة بعد رؤية الإعلان فقط (الإعداد التلقائي لواجهة المستخدم هوtrue، والإعداد التلقائي لواجهة برمجة التطبيقات هوfalse).اختياري: اضبط
start_date_time(00:00:00، اليوم أو في وقت لاحق) وend_date_time(23:59:59) في المنطقة الزمنية للحساب (yyyy-MM-dd HH:mm:ss). اتصل بالرقمMutateCampaignsأوGoogleAdsService.Mutate.
اختياري: إضافة استهداف الحملة واستبعاداتها
يمكنك تحسين الاستهداف بعد إنشاء الطلب أو في طلب GoogleAdsService.Mutate نفسه:
- المواقع الجغرافية واللغات: أضِف موارد
CampaignCriterionباستخدامCampaignCriterionService.MutateCampaignCriteria، مثل معيارَيlanguageوlocation(اطّلِع على المعايير). - قوائم الكلمات الرئيسية السلبية: يمكنك ربط
CampaignSharedSetبـNEGATIVE_KEYWORDSSharedSet(يُرجى الاطّلاع على المجموعات المشتركة). - شرائح الجمهور: أضِف معايير
UserListInfoالمطلوبة (APP_CAMPAIGN_FOR_ENGAGEMENT) أو إشاراتAudienceInfoالاختيارية (APP_CAMPAIGN) إلى المجموعات الإعلانية (راجِع إنشاء مجموعة لإعلانات التطبيق وإعلان).
ربط إعدادات واجهة مستخدم "إعلانات Google" بحقول واجهة برمجة التطبيقات
استخدِم هذا الجدول لربط عناصر التحكّم في واجهة مستخدم "إعلانات Google" بحقول Google Ads API (عروض الأسعار والميزانية لحملات تثبيت التطبيقات، أو الميزانية وعروض الأسعار لحملات التفاعل والتسجيل المُسبَق).
| قسم واجهة مستخدم "إعلانات Google" والتصنيف | مورد واجهة برمجة التطبيقات وحقلها | التفاصيل |
|---|---|---|
| تطبيق > اختيار نوع فرعي للحملة (حملات التطبيقات لجذب عمليات التثبيت أو حملات التطبيقات لزيادة التفاعل أو حملات التطبيقات لجذب عمليات التسجيل المُسبَق (تطبيقات Android فقط)). |
Campaign.advertising_channel_type،
Campaign.advertising_channel_sub_type
|
غير قابل للتغيير: MULTI_CHANNEL مع
APP_CAMPAIGN أو APP_CAMPAIGN_FOR_ENGAGEMENT
أو APP_CAMPAIGN_FOR_PRE_REGISTRATION.
|
| إعدادات الحملة > اسم الحملة |
Campaign.name.
|
الاسم المعروض المطلوب في حساب العميل |
| إعدادات الحملة > تطبيق للأجهزة الجوّالة |
Campaign.app_campaign_setting.app_store،
Campaign.app_campaign_setting.app_id
|
غير قابل للتغيير: GOOGLE_APP_STORE (اسم الحزمة، مطلوب للتسجيل المُسبَق) أو APPLE_APP_STORE (رقم التعريف الرقمي).
|
| إعدادات الحملة > المواقع الجغرافية واللغات |
CampaignCriterion
(location,
language).
|
تمت إضافتها باستخدام MutateCampaignCriteria أو GoogleAdsService.Mutate الذرية.
|
| إعدادات الحملة > تحسين الإحالات الناجحة بعد رؤية الإعلان فقط > تفعيل الإحالات الناجحة بعد رؤية الإعلان فقط. |
Campaign.view_through_conversion_optimization_enabled.
|
الإصدار APP_CAMPAIGN من Android فقط (الإصدار 24 والإصدارات الأحدث) القيمة التلقائية هي
true في واجهة المستخدم وfalse في واجهة برمجة التطبيقات.
|
| إعدادات الحملة > الإعلانات السياسية عن الاتحاد الأوروبي (هل تحتوي حملتك على إعلانات سياسية عن الاتحاد الأوروبي؟). |
Campaign.contains_eu_political_advertising.
|
يتم ربط نعم، تتضمّن هذه الحملة إعلانات سياسية عن الاتحاد الأوروبي ولا، لا تتضمّن هذه الحملة إعلانات سياسية عن الاتحاد الأوروبي. |
| إعدادات الحملة > تاريخا البدء والانتهاء |
Campaign.start_date_time،
Campaign.end_date_time
|
طوابع زمنية اختيارية للمنطقة الزمنية للحساب (00:00:00 اليوم أو
بعده، و23:59:59).
|
| عروض الأسعار والميزانية > الميزانية |
CampaignBudget.amount_micros،
Campaign.campaign_budget
|
الوحدات الصغيرة اليومية بعملة الحساب مع ضبط CampaignBudget.explicitly_shared على false
|
|
عروض الأسعار والميزانية > عروض الأسعار >
ما الذي تريد التركيز عليه؟ و
ما نوع المستخدمين الذين تريد استهدافهم؟ تحديد تكلفة مستهدفة لكل تثبيت (اختياري) تحديد التكلفة المستهدفة لكل إجراء داخل التطبيق (اختياري) تحديد عائد إنفاق إعلاني مستهدَف (اختياري) التكلفة المستهدَفة لكل تثبيت والتكلفة المستهدَفة للإجراء وعائد الإنفاق الإعلاني المستهدَف |
Campaign.app_campaign_setting.bidding_strategy_goal_type،
Campaign.target_cpa.target_cpa_micros،
Campaign.target_roas.target_roas،
Campaign.maximize_conversions،
Campaign.maximize_conversion_value.
|
يضبط كلاً من تعداد الهدف وحقل oneof لعروض الأسعار (يُرجى الاطّلاع على
الإعداد). تنطبق الاستراتيجيات غير المستهدفة على APP_CAMPAIGN فقط. على أجهزة iOS،
يكون خيار تحسين قيم الإحالات الناجحة في SKAdNetwork متاحًا في واجهة المستخدم فقط (يمكن قراءة
المخططات باستخدام
CustomerSkAdNetworkConversionValueSchema).
|
|
عروض الأسعار والميزانية > عروض الأسعار >
كيف تريد تتبّع عدد عمليات تثبيت التطبيق؟ ما الإجراء الأكثر أهمية بالنسبة إليك؟ و ما الإجراءات الأكثر أهمية بالنسبة إليك؟ |
Campaign.selective_optimization.conversion_actions.
|
تضيف أداة اختيار التثبيت ما يصل إلى إجراء واحد من النوع DOWNLOAD
(APP_CAMPAIGN فقط). تضيف أدوات اختيار الإجراءات إجراءً واحدًا (مفردًا)
أو إجراءات متعددة (جمع) تتطابق مع app_id.
|
| الميزانية وعروض الأسعار > عروض الأسعار > التسجيل المُسبَق و التكلفة المستهدفة للتسجيل المُسبَق |
Campaign.target_cpa.target_cpa_micros،
Campaign.optimization_goal_setting.optimization_goal_types.
|
يستخدم OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME وAPP_PRE_REGISTRATION (يجب ترك selective_optimization بدون ضبط).
|
مثال على الرمز والخطوات التالية
أرفِق مجموعة إعلانية وملفات أصول مواد إبداعية لكي تتمكّن حملتك من عرض الإعلانات:
- إنشاء مجموعة لإعلانات التطبيق وإعلان للتطبيق: أضِف مورد
AdGroup(مع معاييرUserListInfoالمطلوبة فيAPP_CAMPAIGN_FOR_ENGAGEMENT) وإعلان تطبيق. - مثال على رمز "حملة التطبيقات": يمكنك فحص نموذج
AddAppCampaignالمتعدّد اللغات الذي ينشئ ميزانية وحملة ومعايير ومجموعة إعلانية وإعلانًا. - إعداد تقارير "حملات التطبيقات": يمكنك الاستعلام عن مقاييس الحملات ومواد العرض وعمليات التثبيت وSKAdNetwork باستخدام لغة طلب البحث في "إعلانات Google".