DynamicSearchAd データ オブジェクト - キャンペーン管理

動的検索広告を定義します。

動的検索広告では、ターゲットとする Web サイトのドメインと言語に基づいて、見出しと表示 URL が自動的に生成されます。 Path1、Path2、Text 要素の組み合わせにより、動的検索広告が一意になります。 必要に応じて、 ページ フィードを使用して静的な見出しを指定できます。

注:

この機能は現在、アルバニア (AL)、アンドラ (AD)、アルゼンチン (AR)、アルバ、オーストラリア (AU)、オーストリア (AT)、バハマ (BS)、バングラデシュ(BD)、ベルギー (BE)、ボリビア(BO)、ボスニア・ヘルツェゴビナ (BA)、ブラジル (BR)、ブルネイ(BN)、ブルガリア (BG)、カナダ (CA)、ケイマン諸島(KY)、チリ(CL)、コスタリカ(CR)、クロアチア (HR)、キプロス (CY)、ベルギー(BE)、ボリビア(BO)、ボスニア・ヘルツェゴビナ(BA)、ブラジル(BR)、ブルネイ(BN)、ブルガリア(BG)、カナダ(CA)、チリ(CL)、コスタリカ(CR)、クロアチア(HR)、キプロス(CY)、ベルギー(BE)、ボリビア(BO)、ボスニア・ヘルツェゴビナ(BA)、ブラジル(BR)、ブルネイ(BN)、ブルガリア(BG)、カナダ(CA)、チリ(CL)、コスタリカ(CR)、クロアチア(HR)、キプロス(CY)、ベルギー(BE)、ボリビア(BO)、ボスニア・ヘルツェゴビナ(BA)、ブラジル(BR)、ブルネイ(BN)、ブルガリア(BG)、カナダ(CA)、チリ(CL)、コスタリカ(CR)、クロアチア(CO)、コスタリカ(CR)、キプロス(CY)、ベルギー(BE)、ボリビア(BO)、ボスニアおよびヘルツェゴビナ(BA)、ブラジル(BR)、ブルネイ(BN)、 チェコ共和国 (CZ)、デンマーク (DK)、Dominica(DM)、ドミニカ共和国(DO)、エクアドル(EC)、エルサルバドル(SV)、エストニア (EE)、フィジー (FJ)、フィンランド (FI)、フランス (FR)、フランス領ギアナ(GF)、フランス領ポリネシア (PF)、ドイツ (DE) )、ギリシャ (GR)、グアム (GU)、グアテマラ (GT)、ガイアナ (GY)、ハイチ (HT)、ホンジュラス (HN)、ハンガリー (HU)、アイスランド (IS)、インド (IN)、インドネシア (ID)、アイルランド (IE)、イタリア (IT)、ラトビア (LV)、 リヒテンシュタイン (LI)、リトアニア (LT)、ルクセンブルク (LU)、マレーシア (MY)、モルディブ (MV)、マルタ (MT)、マルティニーク (MQ)、メキシコ (MX)、モナコ (MC)、モンゴル (MN)、モンテネグロ (ME)、モントセラト (MS)、ネパール (NP)、オランダ (NL)、ニューカレドニア (NC)、ニュージーランド (NZ)、北マケドニア共和国 (MK)、ノルウェー (NO)、パナマ (PA)、パラグアイ (PY)、パプア ニューギニア (PG)、ペルー (PE)、フィリピン (PH)、ポーランド (PO)、ポルトガル (PT)、 プエルトリコ、ルーマニア (RO)、サン マリノ (SM)、セルビア (RS)、シンガポール(SG)、スロバキア (SK)、スロベニア (SI)、南アフリカ (ZA)、スペイン (ES)、スリランカ(LK)、スウェーデン (SE)、スイス (SE)、スイス (CH)、タイ(TH)、トルコ (TR)、バチカン市国 (VA)、ベトナム(VN)、米国 英国 (英国)、ウルグアイ(UY)、ベネズエラ(VE)。

動的検索広告は、 DynamicSearchAdsSetting を持つ検索キャンペーン内でのみ作成できます。 キャンペーンの ExperimentId 要素を設定することはできません。 また、AdGroupType を "SearchDynamic" に設定する必要があります。

注:

動的検索広告のみをサポートするキャンペーンを追加、更新、または取得することはできなくなります。 既存のキャンペーンのキャンペーンの種類が "DynamicSearchAds" から "検索" に更新されました。 広告グループは現在、"動的" 広告グループと見なされますが、構造的な変更はありません。つまり、以前と同じ自動ターゲットと動的検索広告が含まれています。

構文

<xs:complexType name="DynamicSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TextPart2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

DynamicSearchAd オブジェクトには、Path1、Path2、Text、TextPart2 という要素があります。

要素	説明	データ型
Path1	表示 URL のドメイン部分に追加される省略可能なパスの最初の部分。 www.contoso.com などの表示 URL は、 表示 URL のドメインから生成されます。 パス 1 の値を指定した場合は、表示 URL に追加されます。 パス 2 の値も指定している場合は、パス 1 の後の表示 URL にも追加されます。 たとえば、ドメインが contoso.com されている場合、 パス 1 は サブディレクトリ 1 に設定され、 パス 2 は サブディレクトリ 2 に設定されている場合、表示される URL は www.contoso.com/subdirectory1/subdirectory2。 パスの最大入力長は 15 文字です。 二重幅文字を持つ言語 (繁体字中国語など) の場合、パスの最大入力長は 7 文字であることに注意してください。 パスには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。 パスにスラッシュ (/) 文字または改行 (\n) 文字を含めることはできません。 パスにスペースが含まれている場合、広告が表示されるときにアンダースコア (_) に置き換えられます。 追加： オプション 更新： オプション	string
Path2	表示 URL のドメイン部分に追加される省略可能なパスの 2 番目の部分。 表示 URL (例: www.contoso.com ) は、動的検索広告のキャンペーン レベル設定のドメインから生成されます。 パス 1 の値を指定した場合は、表示 URL に追加されます。 パス 2 の値も指定している場合は、パス 1 の後の表示 URL にも追加されます。 たとえば、ドメインが contoso.com されている場合、 パス 1 は サブディレクトリ 1 に設定され、 パス 2 は サブディレクトリ 2 に設定されている場合、表示される URL は www.contoso.com/subdirectory1/subdirectory2。 Path1 も設定されている場合にのみ Path2 を指定できます。 パスの最大入力長は 15 文字です。 二重幅文字を持つ言語 (繁体字中国語など) の場合、パスの最大入力長は 7 文字であることに注意してください。 パスには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。 パスにスラッシュ (/) 文字または改行 (\n) 文字を含めることはできません。 パスにスペースが含まれている場合、広告が表示されるときにアンダースコア (_) に置き換えられます。 追加： オプション 更新： オプション	string
テキスト	広告の説明の最初の部分。 テキストには、少なくとも 1 つの単語が含まれている必要があります。 コピーの最大入力長は 90 文字です。 繁体字中国語を使用する広告グループの場合、コピーの最大入力長は 45 文字であることに注意してください。 テキストには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。 テキストに改行 (\n) 文字を含めることはできません。 追加： 必須 更新： オプション	string
TextPart2	広告の説明の 2 番目の部分。 テキストには、少なくとも 1 つの単語が含まれている必要があります。 コピーの最大入力長は 90 文字です。 繁体字中国語を使用する広告グループの場合、コピーの最大入力長は 45 文字であることに注意してください。 テキストには 、IF 関数と カウントダウン 関数を含めることができます。 無置換のすべてのカウントダウン パラメーターの全長に関係なく、最終的に表示されるカウントダウンでは、使用可能な合計文字のうち常に 8 文字が使用されます。 詳細については、「 カウントダウン カスタマイザー」を参照してください。 テキストに改行 (\n) 文字を含めることはできません。 追加： オプション 更新： オプション	string

DynamicSearchAd オブジェクトには継承された要素があります。

継承された要素

Ad から継承された要素

DynamicSearchAd オブジェクトは Ad オブジェクトから派生し、AdFormatPreference、DevicePreference、EditorialStatus、FinalAppUrls、FinalMobileUrls、FinalUrls、FinalUrlSuffix、ForwardCompatibilityMap、Id、Status、TrackingUrlTemplate、Type、UrlCustomParameters の各要素を継承します。 以下の説明は DynamicSearchAd に固有であり、 Ad オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素	説明	データ型
AdFormatPreference	この広告タイプではサポートされていません。	string
DevicePreference	この広告タイプではサポートされていません。	long
EditorialStatus	広告の編集レビューの状態。これは、広告がレビュー待ちであるか、承認されているか、不承認であるかを示します。 追加： 読み 取り 専用 更新： 読み 取り 専用	AdEditorialStatus
FinalAppUrls	この広告タイプではサポートされていません。	AppUrl 配列
FinalMobileUrls	この広告タイプではサポートされていません。	string 配列
FinalUrls	この広告タイプではサポートされていません。	string 配列
FinalUrlSuffix	最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。 追加： オプション 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。	string
ForwardCompatibilityMap	現在の API バージョンで新しい要素が追加されたときに変更が中断されないように、前方互換性のためのキー文字列と値文字列の一覧。 現在、動的検索広告では、サポートされている前方互換性マップ のキーと値のペアはありません。	KeyValuePairOfstring 配列
Id	広告の一意の Microsoft Advertising 識別子。 追加： 読み 取り 専用 更新： 必須と Read-Only	long
Status	広告の状態。 広告の状態を [アクティブ] または [一時停止] に設定できます。 追加： オプション 更新： オプション	AdStatus
TrackingUrlTemplate	すべてのランディング ページ URL の既定として使用する追跡テンプレート。 追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、Microsoft Advertising のヘルプ記事「 どのような追跡または URL パラメーターを使用できますか?」を参照してください。 - 低レベルのエンティティに対して定義された追跡テンプレート (広告など) は、キャンペーンなど、上位レベルのエンティティに対して設定されたものをオーバーライドします。 詳細については、「 エンティティの制限」を参照してください。 - 追跡テンプレートの長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。 - 追跡テンプレートは、 http://、 https://、 {lpurl}、または {unescapedlpurl} のいずれかで始まる整形式の URL である必要があります。 - Microsoft Advertising では、カスタム パラメーターが存在するかどうかを検証しません。 追跡テンプレートでカスタム パラメーターを使用し、それらが存在しない場合、ランディング ページ URL には、代替なしでカスタム パラメーターのキーと値のプレースホルダーが含まれます。 たとえば、トラッキング テンプレートがでありhttps://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}、キャンペーン、広告グループ、条件、キーワード (keyword)、または広告レベルで {_season} または {_promocode} が定義されていない場合、ランディング ページの URL は同じになります。 追加： オプション 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 この要素を空の文字列 ("") に設定すると、前の設定が削除されます。	string
種類	広告の種類。 動的検索広告を取得する場合、この値は DynamicSearch です。 広告の種類の詳細については、「 Ad Data Object 解説」を参照してください。 追加： 読み 取り 専用 更新： 読み 取り 専用	AdType
UrlCustomParameters	URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。 Microsoft Advertising では、 CustomParameters オブジェクトに含める最初の 8 個の CustomParameter オブジェクトを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。 各 CustomParameter には、Key 要素と Value 要素が含まれています。 追加： オプション 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 既存のカスタム パラメーターを保持するには、 UrlCustomParameters 要素を null または空に設定します。 すべてのカスタム パラメーターを削除するには、CustomParameters オブジェクトの Parameters 要素を null または空に設定します。 カスタム パラメーターのサブセットを削除するには、CustomParameters オブジェクトの Parameters 要素に保持するカスタム パラメーターを指定します。	CustomParameters

要件

サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13