- المرجع: الحملة
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- الطُرق
المرجع: الحملة
حملة واحدة
تمثيل JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم مورد الحملة. |
advertiserId |
النتائج فقط. المعرّف الفريد للمعلن الذي تنتمي إليه الحملة. |
campaignId |
النتائج فقط. المعرّف الفريد للحملة. تم تعيينه من قِبل النظام. |
displayName |
مطلوبة. الاسم المعروض للحملة يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 240 بايت. |
entityStatus |
مطلوبة. تتحكّم في ما إذا كان يمكن لطلبات الإدراج ضمن هذه الحملة إنفاق ميزانياتها وتقديم عروض أسعار للمستودع أم لا.
|
updateTime |
النتائج فقط. الطابع الزمني لآخر تعديل على الحملة. تم تعيينه من قِبل النظام. طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
campaignGoal |
مطلوبة. هدف الحملة. |
campaignFlight |
مطلوبة. الإنفاق المخطّط له ومدته للحملة |
frequencyCap |
مطلوبة. إعداد تحديد عدد مرات الظهور للحملة. |
campaignBudgets[] |
قائمة الميزانيات المتاحة لهذه الحملة. وفي حال عدم ضبط هذا الحقل، ستستخدم الحملة ميزانية غير محدودة. |
CampaignGoal
الإعدادات التي تتحكّم في هدف الحملة
تمثيل JSON |
---|
{ "campaignGoalType": enum ( |
الحقول | |
---|---|
campaignGoalType |
مطلوبة. نوع هدف الحملة. |
performanceGoal |
مطلوبة. هدف الأداء للحملة. القيم المقبولة لـ
|
CampaignGoalType
الأنواع المحتملة من أهداف الحملة.
عمليات التعداد | |
---|---|
CAMPAIGN_GOAL_TYPE_UNSPECIFIED |
قيمة الهدف غير محددة أو غير معروفة في هذا الإصدار. |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
زيادة عمليات تثبيت التطبيق أو التفاعلات المطوَّلة: |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
زيادة الوعي بعلامة تجارية أو منتج |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
زيادة المبيعات خارج المتجر أو في المتجر |
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION |
تحفيز الزيارات أو الإجراءات على الإنترنت. |
PerformanceGoal
الإعدادات التي تتحكّم في هدف الأداء لحملة معيّنة
تمثيل JSON |
---|
{ "performanceGoalType": enum ( |
الحقول | |
---|---|
performanceGoalType |
مطلوبة. نوع هدف الأداء. |
حقل الاتحاد performance_goal_value مطلوبة. قيمة هدف الأداء المقابلة لـ performance_goal_type محدد. يمكن أن تكون السمة "performance_goal_value " واحدة فقط مما يلي: |
|
performanceGoalAmountMicros |
مبلغ الهدف بالمايكرو من عملة المعلِن. يسري ذلك إذا كانت السمة
على سبيل المثال، 1500000 يمثل 1.5 وحدة قياسية من العملة. |
performanceGoalPercentageMicros |
تمثيل عشري لنسبة الهدف بالمايكرو. يسري ذلك إذا كانت السمة
على سبيل المثال، 70000 تمثل 7٪ (الكسر العشري 0.07). |
performanceGoalString |
سلسلة مؤشر الأداء الرئيسي (KPI) يمكن أن تكون فارغة يجب أن يكون بالترميز UTF-8 بطول لا يزيد عن 100 حرف. يسري هذا العرض الترويجي عند ضبط |
PerformanceGoalType
الأنواع المحتملة من أهداف الأداء.
عمليات التعداد | |
---|---|
PERFORMANCE_GOAL_TYPE_UNSPECIFIED |
نوع هدف الأداء غير محدد أو غير معروف في هذا الإصدار. |
PERFORMANCE_GOAL_TYPE_CPM |
يتم تحديد هدف الأداء بالتكلفة لكل ألف ظهور. |
PERFORMANCE_GOAL_TYPE_CPC |
يتم تحديد هدف الأداء بتكلفة النقرة. |
PERFORMANCE_GOAL_TYPE_CPA |
يتم تحديد هدف الأداء بتكلفة الإجراء (CPA). |
PERFORMANCE_GOAL_TYPE_CTR |
يتم تحديد هدف الأداء بالنسبة المئوية إلى نسبة النقر إلى الظهور. |
PERFORMANCE_GOAL_TYPE_VIEWABILITY |
يتم ضبط هدف الأداء على النسبة المئوية لإمكانية العرض. |
PERFORMANCE_GOAL_TYPE_CPIAVC |
يتم تحديد هدف الأداء على أنّه CPIAVC (تكلفة مرة ظهور مسموعة ومرئية عند الانتهاء). |
PERFORMANCE_GOAL_TYPE_CPE |
يتم تحديد هدف الأداء بتكلفة المشاركة (CPE). |
PERFORMANCE_GOAL_TYPE_CLICK_CVR |
يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل الإحالات الناجحة الناتجة عن النقر (الإحالات الناجحة لكل نقرة). |
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR |
يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل الإحالات الناجحة لمرات الظهور (الإحالات الناجحة لكل مرة ظهور). |
PERFORMANCE_GOAL_TYPE_VCPM |
يتم ضبط هدف الأداء بالتكلفة لكل ألف ظهور قابل للعرض. |
PERFORMANCE_GOAL_TYPE_VTR |
يتم تحديد هدف الأداء بالنسبة المئوية لنسبة المشاهدة على YouTube (عدد المشاهدات على YouTube لكل مرة ظهور). |
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE |
يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل إكمال الصوت (عدد مرات الاستماع إلى المقطع الصوتي الكامل لكل مرة ظهور). |
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE |
يتم تحديد هدف الأداء بالنسبة المئوية لمعدّل إكمال الفيديو (عدد مرات مشاهدة الفيديو الكاملة لكل مرة ظهور). |
PERFORMANCE_GOAL_TYPE_OTHER |
تم ضبط هدف الأداء على "غير ذلك". |
CampaignFlight
الإعدادات التي تتتبّع الإنفاق والمدة المخطّطَين للحملة
تمثيل JSON |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
الحقول | |
---|---|
plannedSpendAmountMicros |
المبلغ المتوقع إنفاقه في الحملة مقابل المبلغ بالمايكرو. يجب أن تكون أكبر من أو تساوي 0. على سبيل المثال، 500000000 تمثل 500 وحدة قياسية من العملة. |
plannedDates |
مطلوبة. التواريخ التي من المتوقع أن تعمل فيها الحملة. ويتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي.
|
CampaignBudget
الإعدادات التي تتحكّم في كيفية تخصيص ميزانية الحملة.
تمثيل JSON |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
الحقول | |
---|---|
budgetId |
المعرّف الفريد لميزانية الحملة. تم تعيينه من قِبل النظام. لا تضبط لميزانيات جديدة. يجب تضمينه عند تعديل الميزانيات أو إضافتها إلى |
displayName |
مطلوبة. الاسم المعروض للميزانية. يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 240 بايت. |
budgetUnit |
مطلوبة. غير قابل للتغيير. تحدِّد هذه السياسة ما إذا كانت الميزانية تُقاس بالعملة أو بمرّات الظهور. |
budgetAmountMicros |
مطلوبة. المبلغ الإجمالي الذي يمكن تخصيص ميزانية لشرائح طلبات الإدراج المرتبطة. المبلغ بالمايكرو. يجب أن يكون أكبر من 0. على سبيل المثال، 500000000 تمثل 500 وحدة قياسية من العملة. |
dateRange |
مطلوبة. النطاق الزمني لميزانية الحملة. قد تحتوي شرائح الميزانية المرتبطة على نطاق زمني مختلف. ويتم حلها وفقًا للمنطقة الزمنية للمعلِن الرئيسي. يجب أن يكون كل من |
externalBudgetSource |
مطلوبة. المصدر الخارجي للميزانية. |
externalBudgetId |
غير قابل للتغيير. رقم التعريف الذي يحدد هذه الميزانية للمصدر الخارجي. في حال ضبط هذا الحقل وضبط مستوى تفاصيل الفاتورة للملف الشخصي للفوترة المقابل على "طلب الشراء على مستوى الميزانية"، ستتضمّن جميع مرّات الظهور الناتجة من هذه الميزانية هذا المعرّف في الفاتورة. ويجب أن يكون فريدًا ضمن الحملة. |
invoiceGroupingId |
غير قابل للتغيير. المعرّف المستخدَم لتجميع الميزانيات لتضمين الفاتورة نفسها إذا تم ضبط هذا الحقل وتم ضبط مستوى الفاتورة للملف الشخصي للفوترة المقابل على "معرِّف تجميع فواتير الميزانية"، سيتم تجميع كل |
prismaConfig |
بيانات وصفية إضافية تستخدمها أداة Mediaocean Prisma مطلوبة لميزانيات Mediaocean. لا يسري هذا العرض إلا على |
ExternalBudgetSource
مصدر خارجي لشريحة ميزانية حملة.
عمليات التعداد | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
قيمة مصدر الميزانية الخارجية غير محدّدة أو غير معروفة في هذا الإصدار. |
EXTERNAL_BUDGET_SOURCE_NONE |
الميزانية ليس لها مصدر خارجي. |
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN |
مصدر الميزانية هو Mediaocean. |
PrismaConfig
الإعدادات الخاصة بأداة Mediaocean Prisma.
تمثيل JSON |
---|
{ "prismaType": enum ( |
الحقول | |
---|---|
prismaType |
مطلوبة. نوع Prisma |
prismaCpeCode |
مطلوبة. رموز العملاء والمنتج والتقديرات ذات الصلة من أداة Mediaocean Prisma |
supplier |
مطلوبة. خصّص الكيان هذه الميزانية (DSP والموقع الإلكتروني وما إلى ذلك). |
PrismaType
الأنواع المحتملة لميزانية Prisma.
عمليات التعداد | |
---|---|
PRISMA_TYPE_UNSPECIFIED |
لم يتم تحديد النوع أو غير معروف في هذا الإصدار. |
PRISMA_TYPE_DISPLAY |
نوع العرض |
PRISMA_TYPE_SEARCH |
نوع البحث. |
PRISMA_TYPE_VIDEO |
نوع الفيديو |
PRISMA_TYPE_AUDIO |
نوع الصوت |
PRISMA_TYPE_SOCIAL |
النوع الاجتماعي. |
PRISMA_TYPE_FEE |
نوع الرسوم |
PrismaCpeCode
يتيح "مركز دفعات Google" البحث والفلترة في حقول المكوّنات لهذا الرمز.
تمثيل JSON |
---|
{ "prismaClientCode": string, "prismaProductCode": string, "prismaEstimateCode": string } |
الحقول | |
---|---|
prismaClientCode |
رمز عميل Prisma |
prismaProductCode |
رمز منتج Prisma |
prismaEstimateCode |
رمز تقدير Prisma |
الطُرق |
|
---|---|
|
ينشئ حملة جديدة. |
|
يحذف الحملة نهائيًا. |
|
الحصول على حملة |
|
يسرد الحملات في أحد المعلِنين. |
|
يسرد خيارات الاستهداف المعيّنة للحملة على مستوى أنواع الاستهداف المختلفة. |
|
تعديل حملة حالية |