Ad Params
コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。
パラメータを使用して広告グループのテキスト広告を作成
function setupAdParamsInAdGroup(adGroupName) { // If you have multiple adGroups with the same name, this snippet will // pick an arbitrary matching ad group each time. In such cases, just // filter on the campaign name as well: // // AdsApp.adGroups() // .withCondition('ad_group.name = "INSERT_ADGROUP_NAME_HERE"') // .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"') const adGroupIterator = AdsApp.adGroups() .withCondition(`ad_group.name = "${adGroupName}"`) .get(); if (!adGroupIterator.hasNext()) { throw new Error(`No ad group with name "${adGroupName} found`); } const adGroup = adGroupIterator.next(); adGroup.newAd().expandedTextAdBuilder() .withHeadlinePart1('Holiday sale') .withHeadlinePart2( 'Starts in {param1: a few} days {param2: and} hours!') .withDescription('Everything must go!') .withFinalUrl('http://www.example.com/holidaysales') .build(); const keywordIterator = adGroup.keywords().get(); if (!keywordIterator.hasNext()) { console.log(`No keywords found in ad group ${adGroupName}.`); } else { const keyword = keywordIterator.next(); // Setup Ad to show as 'Doors open in 5 days, 7 hours!' when searched // using this keyword. If the ad is triggered using a keyword // without ad param, the ad shows as // 'Doors open in a few days, and hours!' keyword.setAdParam(1, 5); keyword.setAdParam(2, 7); } }
キーワードの広告パラメータを取得
function getAdParamsForKeyword(adGroupName) { // If you have multiple adGroups with the same name, this snippet will // pick an arbitrary matching ad group each time. In such cases, just // filter on the campaign name as well: // // AdsApp.adGroups() // .withCondition('ad_group.name = "INSERT_ADGROUP_NAME_HERE"') // .withCondition('campaign.name = "INSERT_CAMPAIGN_NAME_HERE"') const adGroupIterator = AdsApp.adGroups() .withCondition(`ad_group.name = "${adGroupName}"`) .get(); if (!adGroupIterator.hasNext()) { throw new Error(`No ad group with name "${adGroupName} found`); } const adGroup = adGroupIterator.next(); const keywordIterator = adGroup.keywords() .withCondition('ad_group_criterion.keyword.text = "Holiday sales"') .get(); if (!keywordIterator.hasNext()) { console.log(`No keywords found in ad group ${adGroupName}.`); } else { const keyword = keywordIterator.next(); const adParamIterator = keyword.adParams().get(); for (const adParam of adParamIterator) { logAdParam(adParam); } } } function logAdParam(adParam) { console.log('Keyword : ' + adParam.getKeyword().getText()); console.log('MatchType : ' + adParam.getKeyword().getMatchType()); console.log('Index : ' + adParam.getIndex()); console.log('Insertion Text : ' + adParam.getInsertionText()); }
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-21 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-08-21 UTC。"],[[["\u003cp\u003eThe provided code snippets demonstrate how to create and manage ad parameters within Google Ads, allowing for dynamic text insertion in ads based on specific keywords.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esetupAdParamsInAdGroup\u003c/code\u003e creates a new expanded text ad with placeholders (\u003ccode\u003e{param1}\u003c/code\u003e, \u003ccode\u003e{param2}\u003c/code\u003e) and sets corresponding ad parameters for a keyword, enabling customized ad copy when that keyword triggers the ad.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetAdParamsForKeyword\u003c/code\u003e retrieves and logs the ad parameters associated with a specific keyword within a given ad group, showcasing how to access and utilize these parameters for analysis or reporting.\u003c/p\u003e\n"]]],[],null,["Create text ad with ad parameters for an ad group \n\n```gdscript\nfunction setupAdParamsInAdGroup(adGroupName) {\n // If you have multiple adGroups with the same name, this snippet will\n // pick an arbitrary matching ad group each time. In such cases, just\n // filter on the campaign name as well:\n //\n // AdsApp.adGroups()\n // .withCondition('ad_group.name = \"INSERT_ADGROUP_NAME_HERE\"')\n // .withCondition('campaign.name = \"INSERT_CAMPAIGN_NAME_HERE\"')\n const adGroupIterator = AdsApp.adGroups()\n .withCondition(`ad_group.name = \"${adGroupName}\"`)\n .get();\n if (!adGroupIterator.hasNext()) {\n throw new Error(`No ad group with name \"${adGroupName} found`);\n }\n const adGroup = adGroupIterator.next();\n\n adGroup.newAd().expandedTextAdBuilder()\n .withHeadlinePart1('Holiday sale')\n .withHeadlinePart2(\n 'Starts in {param1: a few} days {param2: and} hours!')\n .withDescription('Everything must go!')\n .withFinalUrl('http://www.example.com/holidaysales')\n .build();\n\n const keywordIterator = adGroup.keywords().get();\n if (!keywordIterator.hasNext()) {\n console.log(`No keywords found in ad group ${adGroupName}.`);\n } else {\n const keyword = keywordIterator.next();\n // Setup Ad to show as 'Doors open in 5 days, 7 hours!' when searched\n // using this keyword. If the ad is triggered using a keyword\n // without ad param, the ad shows as\n // 'Doors open in a few days, and hours!'\n keyword.setAdParam(1, 5);\n keyword.setAdParam(2, 7);\n }\n}\n```\n\nGet ad parameters for a keyword \n\n```gdscript\nfunction getAdParamsForKeyword(adGroupName) {\n // If you have multiple adGroups with the same name, this snippet will\n // pick an arbitrary matching ad group each time. In such cases, just\n // filter on the campaign name as well:\n //\n // AdsApp.adGroups()\n // .withCondition('ad_group.name = \"INSERT_ADGROUP_NAME_HERE\"')\n // .withCondition('campaign.name = \"INSERT_CAMPAIGN_NAME_HERE\"')\n const adGroupIterator = AdsApp.adGroups()\n .withCondition(`ad_group.name = \"${adGroupName}\"`)\n .get();\n if (!adGroupIterator.hasNext()) {\n throw new Error(`No ad group with name \"${adGroupName} found`);\n }\n const adGroup = adGroupIterator.next();\n const keywordIterator = adGroup.keywords()\n .withCondition('ad_group_criterion.keyword.text = \"Holiday sales\"')\n .get();\n if (!keywordIterator.hasNext()) {\n console.log(`No keywords found in ad group ${adGroupName}.`);\n } else {\n const keyword = keywordIterator.next();\n const adParamIterator = keyword.adParams().get();\n for (const adParam of adParamIterator) {\n logAdParam(adParam);\n }\n }\n}\n\nfunction logAdParam(adParam) {\n console.log('Keyword : ' + adParam.getKeyword().getText());\n console.log('MatchType : ' + adParam.getKeyword().getMatchType());\n console.log('Index : ' + adParam.getIndex());\n console.log('Insertion Text : ' + adParam.getInsertionText());\n}\n```"]]