ExpandedTextAdBuilder
[アーティクル] 11/13/2024
4 人の共同作成者
フィードバック
この記事の内容
拡張テキスト広告を定義および作成するためのメソッドが含まれています。 ビルダーの詳細については、「 Builders 」を参照してください。
注:
拡張テキスト広告を、2023 年 2 月 1 日までにレスポンシブ検索広告にアップグレードします 。 この日付を過ぎると、新しいテキスト広告を作成したり、既存の拡張テキスト広告を編集したりできなくなります。 詳細については、「 レスポンシブ検索広告について 」を参照してください。
既存の拡張テキスト広告は引き続き配信され、そのパフォーマンスに関するレポートを表示できます。
拡張テキスト広告は引き続き一時停止、有効化、または削除できます。 そうしないと、拡張テキスト広告を追加または更新しようとすると、エラーが発生 CampaignServiceAdTypeInvalid します。
この変更の詳細については、こちらをご覧ください 。
使用例:
var operation = adGroup.newAd().expandedTextAdBuilder()
.withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
.withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
.withDescription('AD TEXT GOES HERE')
.withFinalUrl('LANDING PAGE URL GOES HERE')
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
メソッド
ビルド
広告を作成し、スクリプトが広告を正常に追加したかどうかを確認するために使用する操作オブジェクトを返します。
広告グループに追加できる広告の数の制限については、「 エンティティ階層の制限 」を参照してください。
戻り値
型
説明
AdOperation
スクリプトが広告を正常に追加したかどうかを確認するために使用される操作オブジェクト。
withCustomParameters(Object customParameters)
広告のカスタム パラメーターを設定します。
カスタム パラメーターは、複数の URL 間で動的な情報を共有する場合に役立ちます。 その使用方法の詳細については、「 カスタム パラメーター 」を参照してください。
引数
名前
型
説明
customParameters
オブジェクト
広告の最終 URL に適用する最大カスタム パラメーターのマップ。 たとえば、 {key1: 'value1', key2: 'value2', key3: 'value3'}key はカスタム パラメーターの名前であり、値はパラメーターの値です。 名前には最大 16 個の 8 バイト文字を含め、値には最大 200 個の 8 バイト文字を含む場合があります。
戻り値
withDescription(string description)
広告の最初の説明を設定します。 このメソッドは、 withDescription1(string description1)を優先して 非推奨になっています。
引数
名前
型
説明
description
string
広告の最初の説明。 コピーの制限と動的テキスト文字列を含める方法については、「 Bing Ads API 」を参照してください。
戻り値
withDescription1(string description1)
広告の最初の説明を設定します。 このメソッドは、 withDescription(string description)と 同じフィールドを設定します。
引数
名前
型
説明
description1
string
広告の最初の説明。 コピーの制限と動的テキスト文字列を含める方法については、「 Bing Ads API 」を参照してください。
戻り値
withDescription2(string description2)
広告の 2 番目の説明を設定します。
引数
名前
型
説明
description2
string
広告の 2 番目の説明。 コピーの制限と動的テキスト文字列を含める方法については、「 Bing Ads API 」を参照してください。
戻り値
withFinalUrl(string finalUrl)
広告のランディング ページ URL を設定します。
引数
名前
型
説明
finalUrl
string
広告のランディング ページ URL。 URL の制限については、「 Bing Ads API 」を参照してください。
戻り値
withHeadlinePart1(string headlinePart1)
広告のタイトルの最初の部分を設定します。
引数
名前
型
説明
headlinePart1
string
広告のタイトルの最初の部分。 Microsoft は、タイトルのパーツ 1、2、3 を使用して広告のタイトルを生成すると、" - " を使用してパーツを連結します。 タイトルパーツにダッシュを指定しないでください。 タイトルの各部分には、少なくとも 1 つの単語を含める必要があります。 タイトルの制限の追加と、タイトルに動的テキスト文字列を含める方法については、「 Bing Ads API 」を参照してください。
戻り値
withHeadlinePart2(string headlinePart2)
広告のタイトルの 2 番目の部分を設定します。
引数
名前
型
説明
headlinePart2
string
広告のタイトルの 2 番目の部分。 Microsoft は、タイトルのパーツ 1、2、3 を使用して広告のタイトルを生成すると、" - " を使用してパーツを連結します。 タイトルパーツにダッシュを指定しないでください。 タイトルの各部分には、少なくとも 1 つの単語を含める必要があります。 タイトルの制限の追加と、タイトルに動的テキスト文字列を含める方法については、「 Bing Ads API 」を参照してください。
戻り値
withHeadlinePart3(string headlinePart3)
広告のタイトルの 3 番目の部分を設定します。
引数
名前
型
説明
headlinePart3
string
広告のタイトルの 3 番目の部分。 Microsoft は、タイトルのパーツ 1、2、3 を使用して広告のタイトルを生成すると、" - " を使用してパーツを連結します。 タイトルパーツにダッシュを指定しないでください。 タイトルの各部分には、少なくとも 1 つの単語を含める必要があります。 タイトルの制限の追加と、タイトルに動的テキスト文字列を含める方法については、「 Bing Ads API 」を参照してください。
戻り値
withMobileFinalUrl(string mobileFinalUrl)
モバイル デバイスの広告の最終 URL を設定します。
最後の URL は、ユーザーが広告をクリックしたときに取得される Web ページを識別します。 モバイル デバイスの最終 URL を指定するには、最初にモバイル以外のデバイスの最終 URL を指定します (「」を参照)。withFinalUrl()
詳細については、「 使用できる追跡パラメーターまたは URL パラメーター」を参照してください。
引数
名前
型
説明
mobileFinalUrl
string
モバイル デバイスの最終的な URL。
戻り値
withPath1(string urlPath1)
広告の表示 URL に追加する最初の省略可能なパスを設定します。
引数
名前
型
説明
mobileFinalUrl
string
広告の表示 URL に追加する最初の省略可能なパス。 Microsoft では、 で withFinalUrl 指定されたドメインを表示 URL として使用します。 最終的な URL のドメインが contoso.com され、パスが 靴 である場合、広告の表示 URL は contoso.com/shoes 。 使用と制限については、「 Path1 」を参照してください。
戻り値
withPath2(string urlPath2)
広告の表示 URL に追加する 2 番目の省略可能なパスを設定します。
引数
名前
型
説明
mobileFinalUrl
string
広告の表示 URL に追加する 2 番目の省略可能なパス。 2 番目のパスを指定するには、最初に最初のパスを指定します (「」を参照)。withPath1 Microsoft では、 で withFinalUrl 指定されたドメインを表示 URL として使用します。 最終的な URL のドメインが contoso.com 、最初のパスが 靴 、2 番目のパスが レディース の場合、広告の表示 URL は contoso.com/shoes/ladies 。 使用と制限については、「 Path2 」を参照してください。
戻り値
withTrackingTemplate(string trackingTemplate)
広告のトラッキング テンプレートを設定します。
トラッキング テンプレートは、キーワードの FinalUrl と共に使用され、広告で使用される宛先 URL を作成します。 詳細については、「 使用できる追跡パラメーターまたは URL パラメーター」を参照してください。
引数
名前
型
説明
trackingTemplate
string
この広告で使用する追跡テンプレート。
戻り値