اجزای الزامی «جستجو»

برای ایجاد پویش «جستجو» جدید از ابتدا، باید حداقل موارد زیر را ایجاد کنید:

• بودجه
• خود پویش
• یک گروه آگهی
• «کلیدواژه‌ها»
• آگهی گروه آگهی حاوی آگهی

پویش و بودجه برای ایجاد انواع پویش‌ها مفید هستند، درحالی‌که برخی تنظیمات در آگهی‌های گروه آگهی به‌طور خاص برای ایجاد پویش‌های «شبکه جستجو» مفید خواهند بود. برای دیدن نحوه ایجاد دارایی‌ها بااستفاده از دستورگان، به راهنمای دارایی‌های جستجو مراجعه کنید.

مطمئن شوید که با راهبرد جهش آشنا هستید، زیرا این راهنما فقط اشیای جاوا اسکریپت را برای استفاده در جهش‌ها ارائه می‌دهد.

بودجه

بودجه نباید هم‌رسانی شود و باید نامی یکتا در حسابتان داشته باشد. از CampaignBudgetOperation برای ایجاد بودجه‌تان استفاده کنید.

const budgetOperation = {
  "campaignBudgetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/campaignBudgets/${getNextTempId()}`,
      "name": "Search campaign budget",
      "amountMicros": "10000000",
      "deliveryMethod": "STANDARD",
      "explicitlyShared": false
    }
  }
}
operations.push(budgetOperation);

پویش

پویش باید به بودجه‌ای ارجاع دهد، بنابراین به نام دقیق منبع بودجه‌ای که در مرحله قبل ایجاد کرده‌اید نیاز دارید تا آن شیء بودجه خاص را شناسایی و استفاده کنید. از CampaignOperation استفاده کنید. در این مثال، AiMaxSetting را نیز برای فعال کردن «بیشینه‌سازی هوشواره‌ای» ویژه «جستجو» و NetworkSettings تنظیم می‌کنیم.

const campaignOperation = {
  "campaignOperation": {
    "create": {
      "resourceName": `customers/${customerId}/campaigns/${getNextTempId()}`,
      "name": "Search campaign",
      "status": "PAUSED",
      "advertisingChannelType": "SEARCH",
      "campaignBudget": budgetOperation.campaignBudgetOperation.create.resourceName,
      "biddingStrategyType": "MANUAL_CPC",
      "startDate": "20240314",
      "endDate": "20250313",
      "manualCpc": {
        "enhancedCpcEnabled": true
      },
      "aiMaxSetting": {
        "enableAiMax": true
      },
      "networkSettings": {
        "targetGoogleSearch": true,
        "targetSearchNetwork": true
      },
      "containsEuPoliticalAdvertising": "DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING"
    }
  }
}
operations.push(campaignOperation);

گروه آگهی

گروه آگهی باید به پویشی که قبلاً ایجاد شده است ارجاع دهد، بنابراین به نام دقیق منبعی که در مرحله قبلی تنظیم کرده‌اید نیاز دارید تا پویشی را که قبلاً در این درخواست ایجاد شده است شناسایی کنید. همچنین به یک شناسه موقت برای خود گروه آگهی نیاز خواهید داشت که بهتر است به‌عنوان یک متغیر جدید ذخیره شود تا بتوان از آن هنگام ایجاد کلیدواژه‌ها و آگهی‌های گروه آگهی استفاده کرد. از AdGroupOperation استفاده کنید.

const adGroupId = getNextTempId();
const adGroupOperation = {
  "adGroupOperation": {
    "create": {
      "resourceName": `customers/${customerId}/adGroups/${adGroupId}`,
      "name": "Search ad group",
      "status": "PAUSED",
      "campaign": campaignOperation.campaignOperation.create.resourceName,
      "type": "SEARCH_STANDARD"
    }
  }
}
operations.push(adGroupOperation);

کلیدواژه‌ها

کلیدواژه‌ها برای راه‌اندازی آگهی‌هایتان در نتایج جستجو لازم است. آن‌ها بااستفاده از AdGroupCriterionOperation به‌عنوان معیار به گروه آگهی اضافه می‌شوند. باید به گروه آگهی ایجادشده در مرحله قبلی ارجاع دهید.

const keywordOperation = {
  "adGroupCriterionOperation": {
    "create": {
      "adGroup": adGroupOperation.adGroupOperation.create.resourceName,
      "status": "ENABLED",
      "keyword": {
        "text": "flowers",
        "matchType": "BROAD"
      }
    }
  }
}
operations.push(keywordOperation);

آگهی گروه آگهی با آگهی

این مرحله یک آگهی گروه آگهی ایجاد می‌کند که یک گروه آگهی را با یک آگهی پیوند می‌دهد. آگهی گروه آگهی باید به گروه آگهی ارجاع دهد، بنابراین به نام دقیق منبعی که در مرحله قبلی تنظیم کرده‌اید نیاز خواهید داشت. می‌توانید در همان عملیات آگهی ایجاد کنید، و از دارایی‌های نوشتاری که قبلاً ایجاد شده‌اند استفاده کنید یا آن‌ها را نیز در همان عملیات ایجاد کنید. نمونه نشان‌داده‌شده در اینجا «آگهی جستجوی واکنش‌گرا» را بااستفاده از ResponsiveSearchAdInfo ایجاد می‌کند. برای این کار، دارایی‌های نوشتاری برای عنوان‌ها و شرح‌ها باید ایجاد شده باشند، همان‌طور که در راهنمای دارایی‌ها نشان داده شده است.

برای ایجاد آگهی گروه آگهی، از AdGroupAdOperation استفاده کنید.

const adGroupAdOperation = {
  "adGroupAdOperation": {
    "create": {
      "resourceName": `customers/${customerId}/adGroupAds/${adGroupId}~${getNextTempId()}`,
      "adGroup": adGroupOperation.adGroupOperation.create.resourceName,
      "status": "PAUSED",
      "ad": {
        "name": "Search RSA ad",
        "finalUrls": [
          "http://www.example.com"
        ],
        "responsiveSearchAd": {
          "headlines": [
            {
              "text": textAsset.assetOperation.create.resourceName
            },
            {
              "text": "Headline 2"
            },
            {
              "text": "Headline 3"
            }
          ],
          "descriptions": [
            {
              "text": "Description 1"
            },
            {
              "text": "Description 2"
            }
          ]
        }
      }
    }
  }
}
operations.push(adGroupAdOperation);