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