- المرجع: الحملة
- CampaignGoal
- CampaignGoalType
- 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 |
تحفيز الزيارات أو الإجراءات على الإنترنت. |
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 |
الطُرق |
|
---|---|
|
يسرد خيارات الاستهداف المعيّنة للحملة على مستوى أنواع الاستهداف المختلفة. |
|
ينشئ حملة جديدة. |
|
يحذف الحملة نهائيًا. |
|
الحصول على حملة |
|
يسرد الحملات في أحد المعلِنين. |
|
تعديل حملة حالية |