KeywordBuilder

[アーティクル]
11/13/2024

キーワードを定義および作成するためのメソッドが含まれています。ビルダーの詳細については、「 Builders」を参照してください。

注:

検索広告のすべての広義一致修飾子キーワードが、フレーズ一致ではなく広義一致キーワードとして機能するようになりました。キーワードの一致の種類について詳しくは、こちらをご覧ください。

使用例:

    var operation = adGroup.newKeywordBuilder()
        .withText("KEYWORD TEXT GOES HERE")
        .withCpc(0.5)
        .withFinalUrl("http://www.contoso.com")
        .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`);
        }
    }

メソッド

メソッド名	戻り値の型	説明
ビルド	KeywordOperation	キーワードを作成し、キーワードが正常に追加されたかどうかを確認するために使用される操作オブジェクトを返します。
withCpc(double cpc)	KeywordBuilder	キーワードの上限クリック単価を設定します。
withCustomParameters(Object customParameters)	KeywordBuilder	キーワードのカスタムパラメーターを設定します。
withFinalUrl(string finalUrl)	KeywordBuilder	キーワードの最終 URL を設定します。
withMobileFinalUrl(string mobileFinalUrl)	KeywordBuilder	モバイルデバイスのキーワードの最終 URL を設定します。
withText(string text)	KeywordBuilder	キーワードのテキストを設定します。
withTrackingTemplate(string trackingTemplate)	KeywordBuilder	キーワードの追跡テンプレートを設定します。

ビルド

キーワードを作成し、キーワードが正常に追加されたかどうかを確認するために使用される操作オブジェクトを返します。

戻り値

型	説明
KeywordOperation	キーワードが正常に追加されたかどうかを確認するために使用される操作オブジェクト。

withCpc(double cpc)

キーワードの上限クリック単価を設定します。

キーワードがユーザーの検索語句と一致するときに使用する入札金額を指定します。広告グループの入札戦略がMANUAL_CPCに設定されている場合にのみ適用されます。

広告グループレベルで指定された入札金額を使用するには、このメソッドを呼び出さないでください。

入札金額の詳細については、「 Bid and BidScheme」を参照してください。

引数

名前	型	説明
クリック単価	double	キーワードに適用する上限クリック単価。アカウントの通貨によって、最小入札値と最大入札額が決まります。詳細については、「入札通貨と予算通貨」を参照してください。

戻り値

型	説明
KeywordBuilder	クリック単価が適用されたキーワードビルダー。

withCustomParameters(Object customParameters)

キーワードのカスタムパラメーターを設定します。

カスタムパラメーターは、複数の URL 間で動的な情報を共有する場合に役立ちます。その使用方法の詳細については、「カスタムパラメーター」を参照してください。

引数

名前	型	説明
customParameters	オブジェクト	キーワードの最終的な URL に適用するカスタムパラメーターまでのマップ。たとえば、 `{key1: 'value1', key2: 'value2', key3: 'value3'}`key はカスタムパラメーターの名前であり、値はパラメーターの値です。名前には最大 16 個の 8 バイト文字を含め、値には最大 200 個の 8 バイト文字を含む場合があります。

戻り値

型	説明
KeywordBuilder	カスタムパラメーターが適用されたキーワードビルダー。

withFinalUrl(string finalUrl)

キーワードの最終 URL を設定します。

最後の URL は、ユーザーが広告をクリックしたときに取得される Web ページを識別します。指定しない場合、エンティティは親エンティティから最終的な URL を継承します。たとえば、キーワードエンティティは広告の最終 URL を継承します。キーワードの最終 URL を指定して、広告の最終 URL をオーバーライドします。

詳細については、「使用できる追跡パラメーターまたは URL パラメーター」を参照してください。

引数

名前	型	説明
finalUrl	string	ユーザーが広告をクリックしたときに取得される Web ページを識別する最終的な URL。

戻り値

型	説明
KeywordBuilder	最終的な URL が適用されたキーワードビルダー。

withMobileFinalUrl(string mobileFinalUrl)

モバイルデバイスのキーワードの最終 URL を設定します。

最後の URL は、ユーザーが広告をクリックしたときに取得される Web ページを識別します。指定しない場合、エンティティは親エンティティから最終的な URL を継承します。たとえば、キーワードエンティティは広告の最終 URL を継承します。広告の最終 URL をオーバーライドする場合は、キーワードの最終 URL を指定します。

詳細については、「使用できる追跡パラメーターまたは URL パラメーター」を参照してください。

モバイルデバイスの最終 URL を指定するには、最初にモバイル以外のデバイスの最終 URL を指定します (「」を参照)。withFinalUrl()

引数

名前	型	説明
mobileFinalUrl	string	モバイルデバイスの最終的な URL。

戻り値

型	説明
KeywordBuilder	モバイルの最終 URL が適用されたキーワードビルダー。

withText(string text)

キーワードのテキストを設定します。

キーワードの一致の種類を指定するには、次の構文を使用します。

一致範囲を広く指定する場合は、一致型構文を使用しません (例: keywordBuilder.withText("books"))。
広い一致修飾子の場合は、プラス記号 (+) を付けてテキストの前に追加します (例: keywordBuilder.withText("+books"))。注: 新しい広範一致修飾子 (BMM) キーワードを作成しようとすると、キーワードが保存され、フレーズ一致キーワードとして機能します。既存の BMM キーワードは、フレーズ一致動作の下で引き続き配信されます。キーワードの一致の種類について詳しくは、こちらをご覧ください。
語句の一致の場合は、テキストの周囲に引用符を配置します (例: keywordBuilder.withText("\"books\""))。
完全に一致する場合は、テキストの周りに角かっこを配置します (例: keywordBuilder.withText("[hardcover books]"))。

引数

名前	型	説明
text	string	キーワードのテキスト。キーワードのテキストが必要です。テキストには、最大 100 文字を含める場合があります。広告グループの言語値のロケールでテキストを指定します。

戻り値

型	説明
KeywordBuilder	キーワードテキストが適用されたキーワードビルダー。

withTrackingTemplate(string trackingTemplate)

キーワードの追跡テンプレートを設定します。

トラッキングテンプレートは、キーワードの FinalUrl と共に使用され、広告で使用される宛先 URL を作成します。詳細については、「使用できる追跡パラメーターまたは URL パラメーター」を参照してください。

引数

名前	型	説明
trackingTemplate	string	このキーワードで使用する追跡テンプレート。

戻り値

型	説明
KeywordBuilder	追跡テンプレートが適用されたキーワードビルダー。

次の方法で共有