目的
この記事をお読みになった後は、次を理解できるようになります。
- テンプレート エラーのカテゴリ
- エラーの考えられる原因
エラーの原因が他にもある場合があります。このドキュメントでは、最も可能性が高いシナリオについて説明します。
- エラーの解決方法
エラーを解決する方法は他にもあります。正しい解決方法は、テンプレートの実装方法によって異なります。
基本情報
テンプレートを利用すると、手動でキャンペーンを作成する場合と異なり、キャンペーンを大規模に自動で作成、管理するため、テンプレート機能で各フィールドをチェックすることはできません。
テンプレート エラーは、次のことを行います。
- テンプレートの出力と効果を最大化できるよう、フィードや数式などのテンプレート設定を調整する必要がある箇所についての分析情報を提供します。
- テンプレートの評価時にエラーが発生したためにテンプレートで生成または更新できなかったキャンペーン、広告グループ、ターゲティング、クリエイティブの数を表示します。
- テンプレートの設定を繰り返して、より効果的にテンプレートを作成できます。テンプレートの柔軟性により、ユースケースごとにテンプレートの設定で繰り返しが必要になる場合があります。
テキストが短すぎる
ほとんどの場合、このエラーは、このエラーのあるフィールドのテキストが生成されなかったことを示します。ほとんどのテキスト フィールドは 1 つしか受け付けないためです。
発生する可能性のあるエラー
| テンプレート タイプ | エラー |
| キャンペーン | フィールドが短すぎる: キャンペーン名 |
| 広告グループ | フィールドが短すぎる: 広告グループ名 |
| レスポンシブ検索広告（RSA） | フィールドが短すぎる: 不明なフィールド |
| キーワード | キーワードのテキストが無効: キーワードのテキスト |
考えられる原因
テンプレートの数式は、フィードのデータを使用して、フィールドのテキストを生成します。たとえば、キャンペーン名、広告グループ名、広告見出し、説明文です。
- 数式が正常に検証されるには、数式で使用されるフィード列にデータが含まれるか、
if_error(value, error_value)関数でラップされている必要があります。
注:valueでエラーが発生すると、この関数はerror_valueで定義されている代替値を評価して返します。それ以外の場合、value を返します。 - データが欠落している場合、式は失敗するため、部分的に正確な値は作成されません。
if_error()関数を使用すると、リクエストされた列の中にデータがなくても、テンプレートにより引き続き値が生成されます。
例
フィード名: フィード A
フィードデータ:
| ID | Brand | Category |
| 1 | Alpha | Shoes |
| 2 | Beta | |
| 3 | Charlie | Clothes |
数式「“Campaign: “ & f:”Brand” & “ “ & f”Category”」では、「Brand」と「Category」の一意の組み合わせごとに自動的にキャンペーンの作成が試みられます。
期待される出力:
キャンペーン 1 = “Campaign: Alpha Shoes”
キャンペーン 2 = “Campaign: Beta “
キャンペーン 3 = “Campaign: Charlie Clothes”
実際の出力:
キャンペーン 1 = “Campaign: Alpha Shoes”
キャンペーン 2 = “”
キャンペーン 3 = “Campaign: Charlie Clothes”
キャンペーン 2 が空のため、「フィールドが短すぎる: キャンペーン名」というエラーが表示されます。
解決例
フィールドに応じて、次の操作を行います。
- 別の数式または静的テキストの代替値を使用します。
if()関数とlength()関数を組み合わせて、長さの問題があるかどうかを検出し、代替値を提供します。- テキスト関数を使用してフィードデータをトリミングして絞り込み、テキスト フィールドで使用できるように準備します。
- 広告プラットフォームのテキスト フィールド要件を満たすデータのみが含まれるように、フィードデータを変更します。
開始日は現在の日付より後にする
静的に定義された日付を過ぎると、テンプレートはキャンペーンと広告グループを生成できなくなります。
発生する可能性のあるエラー
| テンプレート タイプ | エラー |
| 広告グループ | 広告グループの開始日には、現在の日付より後の日付を設定する必要があります |
| キャンペーン | CAMPAIGN_ERROR_CANNOT_SET_DATE_TO_PAST: 開始日 |
考えられる原因
テンプレートの開始日が特定の日付として定義されていましたが、テンプレートが影響を受けるキャンペーン構造、ターゲティング、またはクリエイティブを生成しようとする前に、その日付が過ぎていました。
例
テンプレートの開始日: 2022 年 10 月 31 日
シナリオ: フィードが 2022 年 11 月 1 日に新しい値で更新され、それによってテンプレートがキャンペーンまたは広告グループを作成しようとします。
出力: テンプレートの開始日（2022 年 10 月 31 日）が過去の日付であるため、新しいキャンペーンと広告グループを作成できません。
解決例
解決が必要な場合は、次のいずれかを行います。
- 開始日を将来の日付に変更します。
- [キャンペーンの作成直後] オプションを使用して、キャンペーンまたは広告グループの作成日を開始日として設定します。
- キャンペーンまたは広告グループの作成日から一定の日数を開始日として定義します（例: 「今日 +1」）。
テキストに無効な文字が含まれている
テンプレートで生成されたテキストに、影響を受けるフィールドで許可されていない文字が含まれていました。通常、エラーが生成されるのは、!、@、#、$、%、-、(、)、および / などの特殊文字が使用されているためです。
発生する可能性のあるエラー
| テンプレート タイプ | エラー |
| キーワード | キーワード テキストに無効な文字が含まれている: キーワード テキスト |
| RSA | STRING_ERROR_ILLEGAL_CHARS: 表示 URL のパス 2 |
| RSA | STRING_ERROR_ILLEGAL_CHARS |
| RSA | STRING_ERROR_ILLEGAL_CHARS: 表示 URL のパス 1 |
考えられる原因
このエラーの考えられる原因は次のとおりです。
- フィードデータに、影響を受けるフィールドで許可されていない文字が含まれています
- テンプレートの式に、影響を受けるフィールドで許可されていない文字を含む静的テキストが含まれています。
例
フィード名: フィード B
フィードデータ:
| ID | Field A |
| 1 | Alpha/Beta |
| 2 | Charlie |
| 3 | Delta |
シナリオ: Field A に、入力するには「/」文字を使用できない数式 f:"Field A" & " / " が使用されています。
期待される出力:
“Alpha/Beta / “
“Charlie /”
“Delta /”
実際の出力:
予想される出力のすべてのインスタンスに、サポートされていない「/」文字が含まれているため、値が生成されません。Field A の値の 1 つである「Alpha/Beta」には「/」文字が含まれ、数式では「/」文字が静的テキストとして追加されます。
解決例
これらのエラーを解決するための一般的なガイドラインは次のとおりです。
- 特殊文字を使用しないようフィードデータを更新します
- 代替値を使用します
- テンプレート機能では、
clean_keyword()やregex_extract()などの関数を使用して特殊文字を削除します。関数の例[TRIM(CLEAN_KEYWORD(PRODUCT_ID, " "))]は、フィードの商品 ID 列データから特殊文字を削除します。たとえば、フィード内の商品 ID が「Bolt (10x)」の場合、「Bolt 10x」が返されます。
広告プラットフォーム ポリシーに関する問題
テンプレートで生成されたテキストが、広告プラットフォーム ポリシーの要件を満たしていません。
発生する可能性のあるエラー
| テンプレート タイプ | エラー |
| キーワード | POLICY_ERROR_POLICY_VIOLATION: キーワード テキスト |
考えられる原因
このエラーの考えられる原因は次のとおりです。
- フィードデータが広告プラットフォームのポリシー要件に準拠していません。
- フィードデータとテンプレート式によって生成された静的テキストの組み合わせにより、広告プラットフォームのポリシー要件に準拠しないテキストが生成されています。
例
フィード名: フィード B
フィードデータ:
| ID | Custom |
| 1 | Alpha |
| 2 | Beta |
| 3 | Charlie |
シナリオ: [Custom] 列の値「Alpha」が、ターゲットの広告プラットフォームのキーワード ポリシーに準拠していません。
キーワード式: f:"Custom"
期待される出力:
キーワード 1 = “Alpha”
キーワード 2 = “Beta”
キーワード 3 = “Charlie”
実際の出力:
キーワード 2 = “Beta”
キーワード 3 = “Charlie”
この例では、「Alpha」が広告プラットフォームのキーワード ポリシーに準拠していないため、「Alpha」を作成できません。テンプレート エラーが表示されます。
解決例
フィード データを修正して、テキスト フィールド データが広告プラットフォームのポリシー要件に準拠するようにします。
広告プラットフォームの上限数を超えている
各広告プラットフォームでは、アカウントあたりのキャンペーン数、キャンペーンあたりの広告グループ数、広告グループあたりの広告数に上限が設けられています。広告プラットフォームが許可しているよりも多くのキャンペーン構造、ターゲット、クリエイティブをテンプレート設定が作成しようとしたときに、広告プラットフォームの制限により検索広告 360 のテンプレート機能でエラーが発生します。
発生する可能性のあるエラー
| テンプレート タイプ | エラー |
| RSA | 広告プラットフォームの上限数を超えている |
考えられる原因
このエラーの考えられる原因は次のとおりです。
- 調整因子、またはテンプレートがキャンペーン構造、ターゲティング、またはクリエイティブを構築するために使用する列のセットにより、広告プラットフォームの上限を超える数の組み合わせが発生しています。
- 特定のキャンペーンの広告グループ、ターゲティング、クリエイティブまたは広告グループのターゲティング、クリエイティブを生成するテンプレートの数が、広告プラットフォームの上限を超えています。
サンプル例
例 1
- シナリオ: 広告グループ テンプレートには、広告グループ名に基づいて直接的または暗黙的に定義された調整因子
f:"Product_ID"があります。特定のキャンペーンでは、広告の商品 ID の数が広告プラットフォームで許可されている上限を超えています。 - 出力: 広告グループ テンプレートは、各キャンペーンで許可されている広告グループの最大数まで作成されます。残りの商品 ID は、テンプレートで上限エラーとして表示されます。
例 2
- シナリオ: 広告グループ テンプレートには、広告グループ名に基づいて直接的または暗黙的に定義された調整因子
f:"Product_ID"があります。広告プラットフォームでは、広告グループあたりの広告数が 3 つに制限されています。次に、ユーザーが広告グループ テンプレート用に 4 つ以上の RSA テンプレートを作成したため、広告グループあたりの RSA の数が広告プラットフォームの上限を超えています。 - 出力: 広告グループ テンプレートは、各キャンペーンで許可されている広告グループの最大数まで作成されます。残りの商品 ID は、テンプレートで上限エラーとして表示されます。
解決例
例 1
- 広告グループ テンプレートの調整因子を変更し、キャンペーンごとに生成される一意の値が少ないフィード列またはフィード列の組み合わせを使用して、生成される広告グループの数を減らします。
- キャンペーン テンプレートの調整因子を変更して生成するキャンペーン数を増やし、各キャンペーンで必要となる広告グループの数を減らします。
例 2
- 広告グループ内で広告を作成するテンプレートの数を減らします。
- 広告グループ テンプレートの調整因子を更新して、広告グループの数を増やし、広告グループごとに必要な広告テンプレートを減らします。
RSA パス 1 フィールドが空です
パス 1 フィールドのテンプレート生成テキストは空でしたが、パス 2 フィールドの値はあります。パス 1 とパス 2 のどちらにも値が必要です。そうでないと、エラーが生成されます。
発生する可能性のあるエラー
| テンプレート タイプ | エラー |
| RSA | FIELD_ERROR_VALUE_MUST_BE_UNSET: 表示 URL のパス 2 |
考えられる原因
このエラーの考えられる原因は次のとおりです。
- テキストが短すぎるため、パス 1 は空になります。
- パス 1 がテンプレートで設定されませんでしたが、パス 2 は設定されています。
例
パス 1 は存在しないため、パス 2 にエラーが発生します。この記事のテキストが短すぎるのセクションをご覧ください。
解決例
パス 1 にエラーがないか確認し、広告テンプレートのパス 1 を更新します。
重複するアセット
各テンプレート生成広告の広告見出しと説明文は重複しないようにしてください。テンプレートの数式が広告見出しと説明文の重複を生成しようとすると、エラーが表示されます。
発生する可能性のあるエラー
| テンプレート タイプ | エラー |
| RSA | ASSET_ERROR_DUPLICATE_ASSET |
考えられる原因
このエラーの考えられる原因は次のとおりです。
- フィードデータが、異なる広告見出しまたは説明文フィールドで参照される複数のフィード列で同じです。
- フィードデータと数式によって生成される静的テキストの組み合わせにより、広告見出しまたは説明文が重複しています。
- 1 つの代替値が複数の見出しまたは説明に使用されています。広告を生成するには代替値が 2 つ以上必要です。
例
フィード名: フィード B
フィードデータ:
| ID | Brand | Category |
| 1 | Alpha | Shooting stars collection |
| 2 | Shoes | Shoes |
| 3 | Charlie | Clothing |
シナリオ: 広告テンプレートに次の 2 つの式があり、同じ結果が返されます。
Headline: f:"Brand"Headline: f:"Category"
予想される出力:
広告 1 = “Alpha. Shooting stars collection.”
広告 2 = “Shoes. Shoes.”
広告 3 = “Charlie. Clothing.”
実際の出力:
広告 1 = “Alpha. Shooting stars collection.”
広告 3 = “Charlie. Clothing.”
2 つの広告見出しに同じ値「Shoes」があると、この広告プラットフォームは許可されていないため、広告 2 を生成できません。
解決例
このエラーを解決するには、次のいずれか 1 つ以上を行います。
- それぞれの広告見出しと説明文に異なる代替値を使用してください。
- 広告見出しと説明文の列の値が重複しないようにフィードデータを変更します。
if()などの論理関数を使用して重複データを防止します。
管理対象外の設定を一括編集で更新する
テンプレートが関連アイテムと矛盾する設定を持つアイテム（広告グループなど）を生成（たとえば、そのテンプレートで生成された広告グループの上限 CPC が、関連する Microsoft ショッピング キャンペーンに必要な最小単価を下回っている場合）し、設定がテンプレートによって管理されていない場合は、一括編集を使用して該当の設定を更新（例: Microsoft ショッピング キャンペーンの最小要件を満たすように上限 CPC を引き上げる）できます。