AdParameter

مَعلمة إعلان تُستخدَم لتعديل القيم الرقمية (مثل الأسعار أو مستويات المستودع الإعلاني) في أي سطر نصّي للإعلان (بما في ذلك عناوين URL). يمكن أن يكون هناك اثنان من معلمات الإعلان كحد أقصى لكل معيار من معايير المجموعة الإعلانية. (أحدهما يحتوي على parameterIndex = 1 والآخر يحتوي على parameterIndex = 2.) في الإعلان، تتم الإشارة إلى المَعلمات من خلال عنصر نائب للنموذج "{param#:value}". على سبيل المثال، "{param1:$17}"

تمثيل JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "parameterIndex": string,
  "insertionText": string
}
الحقول
resourceName

string

غير قابل للتغيير. اسم مورد معلمة الإعلان. تكون أسماء موارد مَعلمات الإعلانات على النحو التالي:

customers/{customerId}/adParameters/{adGroupId}~{criterionId}~{parameterIndex}

adGroupCriterion

string

غير قابل للتغيير. معيار المجموعة الإعلانية الذي تنتمي إليه مَعلمة الإعلان هذه.

parameterIndex

string (int64 format)

غير قابل للتغيير. الفهرس الفريد لمعلمة الإعلان هذه. يجب أن تكون القيمة إما 1 أو 2.

insertionText

string

قيمة رقمية لإدراجها في نص الإعلان. تسري القيود التالية: - يمكن استخدام الفاصلة أو النقطة كفاصلة، مع إضافة نقطة أو فاصلة اختيارية (على التوالي) للقيم الكسرية. على سبيل المثال، القيمة 1,000,000.00 و2.000.000,10 صالحة. - يمكن إضافتها قبلها أو إلحاقها برمز العملة على سبيل المثال، يكون مبلغ 99.99 دولارًا أمريكيًا (أو ما يعادله بالعملة المحلية) صالحًا. - يمكن إضافتها قبلها أو إلحاقها برمز عملة على سبيل المثال، 99.99 ريال سعودي و200 يورو صالحان. - يمكن استخدام "%". على سبيل المثال، القيمتان 1.0% و1,0% صالحان. - يمكن استخدام علامة زائد أو ناقص. على سبيل المثال، القيمتان -10.99 و 25+ صالحان. - يمكن استخدام "/" بين رقمين. على سبيل المثال، 4/1 و0.95/0.45 صالحة.