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

  • [アーティクル]

アカウント レベルのプロパティ名を文字列値にマップします。

構文

<xs:complexType name="AccountProperty" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Name" type="tns:AccountPropertyName" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

要素

AccountProperty オブジェクトには、Name、Value という要素があります。

要素 説明 データ型
名前 アカウント プロパティの名前。 AccountPropertyName
値 名前付きアカウント プロパティの値。

値は、アカウント プロパティ名によって異なります。 詳細については、以下のセクションの 「アカウント プロパティの値 」を参照してください。		 string

注釈

Account プロパティの値

AdClickParallelTracking

並列追跡が有効かどうかを判断します。

URL トラッキングを使用する場合、ユーザーが広告をクリックすると、通常、ページに到達する前に多数のリダイレクトを通過する必要があります。 これはシーケンシャル 追跡と呼ばれます。

並列追跡では、ユーザーが広告をクリックすると、すぐにランディング ページが表示されます。 同時に、Microsoft Advertising は追跡 URL をバックグラウンドで実行します。 そのため、顧客のユーザー エクスペリエンスが向上し、それでも同じ優れた測定追跡が得られます。

並列追跡を機能させるには、URL の追跡テンプレートに {lpurl} またはそのバリアントのいずれかが必要です。 詳細については、「 並列追跡を使用すると、顧客がランディング ページにすばやく移動する 」と「 どのような追跡または URL パラメーターを使用できますか?」を参照してください。

Name 要素が AdClickParallelTracking に設定されている場合、返される値は true または false のいずれかになります。 値が true の場合、並列追跡が有効になります。

重要

並列追跡は、2020 年 5 月 31 日以降に作成されたすべてのアカウントに必要です。 2021 年 1 月まで、2020 年 6 月 1 日より前に作成されたアカウントの機能を有効または無効にすることができます。つまり、プロパティを true または false に設定します。 2021 年 1 月中旬までに、すべてのアカウントで並列追跡が有効になり、値は true にのみ設定できます。

AllowImageAutoRetrieve

Microsoft Advertising がドメインの画像を使用して Microsoft Audience Network 上の広告を強化できるかどうかを決定します。

重要

オプトインにより、広告主のランディング ページから取得した画像またはクリエイティブ コンテンツは、 広告契約 (セクション 2) のコンテンツ使用ライセンスに基づく広告主によって提供されるコンテンツであり、そのコンテンツを Microsoft が広告と拡張機能の自動作成に使用できることに広告主が同意することに同意するものとします。

注:

誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください。近日公開予定です。

Name 要素が AllowImageAutoRetrieve に設定されている場合は、値を true または false に設定できます。 値が true の場合、イメージの自動取得機能が有効になります。

AutoApplyRecommendations

広告のパフォーマンス向上に役立つ広告のレコメンデーションを Microsoft Advertising が自動的に適用できるかどうかを決定します。

警告

キャンペーン管理 API の AutoApplyRecommendations は、2022 年 11 月 30 日の時点で非推奨になりました。 Ad Insight API で新しい 自動適用管理インターフェイス を使用することを強くお勧めします。

注:

誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください。近日公開予定です。

おすすめ広告を確認する準備ができたら、お知らせします。 広告に関する推奨事項は、[推奨事項] ページにあります。 アクションを実行しない場合、レビュー期間後に自動的に適用されます。

  • マルチメディア広告: 7 日間
  • その他: 14 日

自動適用オプションはいつでも変更できます。 広告の推奨事項を自動適用しない場合でも、推奨事項を手動で適用できます。

Name 要素が AutoApplyRecommendations に設定されている場合、Value には推奨事項の種類の一覧を含めることができます。

Value 要素内では、キーと値のペアの一覧はセミコロン (;)で区切られます。 この例では、広告の自動適用に関する推奨事項はマルチメディア広告では有効になっていますが、レスポンシブ検索広告や拡張テキスト広告では有効になっていません。

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>AutoApplyRecommendations</Name>
      <Value>MultimediaAdsAutoApply=true;ResponsiveSearchAdsAutoApply=false;ExpandedTextAdsAutoApply=false</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

既定のキーと値のペアは次のとおりです。

  • MultimediaAdsAutoApply=true;
  • ResponsiveSearchAdsAutoApply=false;
  • ExpandedTextAdsAutoApply=false;

キーの値が true に設定されている場合、推奨事項の種類に対して自動適用機能が有効になります。

更新するキーと値のペアのみを設定できます。 更新プログラムに値が設定されていない場合、この設定は変更されません。

BusinessAttributes

広告のパフォーマンス向上に役立つ重要なビジネス価値を強調できます。

ビジネス属性は省略可能であり、ビジネスに適用される 1 つ以上の属性を選択できます。

Name 要素が BusinessAttributes に設定されている場合、Value には属性型のリストを含めることができます。

Value 要素内では、ビジネス属性の一覧はセミコロン (;)で区切られます。 使用できる値は次のとおりです。アルコールフリー、アレルギーフレンドリ、AsianOwned、BlackOwned、CarbonNegative、CarbonNeutral、残酷なFree、 糖尿病フレンドリー、エコフレンドリー、FamilyFriendly、FamilyOwned、GlutenFree、Halal、HearingAssistance、Kosher、LatinOwned、LocalBusiness、LGBTQIFriendly、LGBTQIOwned、MinorityOwned、MobilityAssistance、NoContactDelivery、Nonprofit、PetFriendly、SmallBusiness、SupportACure、SupportDiseaseResearch、Sustainable、ビーガン、ベジタリアン、VisualAssistance、TouchlessPickup、ユニセックス、WebAccessibility、WheelchairAccessible、WomenOwned。

この例では、アルコールフリー、ファミリー所有、ビーガンが選択されたビジネス属性です。

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>BusinessAttributes</Name>
      <Value>AlcoholFree;FamilyOwned;Vegan</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

属性が value プロパティに表示される場合は、その属性が選択されます。属性が value プロパティに表示されない場合は、選択されません。

アカウントのビジネス属性を削除するには、 Name を BusinessAttributes に設定し、 値 を "" (空の文字列) に設定します。

更新するビジネス属性のみを設定できます。 更新プログラムに値が設定されていない場合、この設定は変更されません。

FinalUrlSuffix

Name 要素が FinalUrlSuffix に設定されている場合、値はアカウントの最終 URL サフィックスを表します。

最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。

アカウントの最終 URL サフィックスを削除するには 、名前 を FinalUrlSuffix に、 値 を "" (空の文字列) に設定します。

IncludeViewThroughConversions

アカウントにキャンペーンのビュースルー コンバージョンを含めるかどうかを指定します。

ビュースルーコンバージョンとは、ユーザーが広告をクリックしなかった場合でも、広告を見た後に行うコンバージョンです。

Name 要素が IncludeViewThroughConversions に設定されている場合は、値を true または false に設定できます。 値が true の場合、ビュースルー変換が含まれます。 既定では、機能パイロットに参加している場合 (GetCustomerPilotFeatures は 616 を返します)、このプロパティは true に設定されます。つまり、パフォーマンス レポートの "All" 変換列の値にはビュースルー変換が含まれます。 ビュースルー変換を含めない場合は、無効にすることもできます。

注:

ビュースルー変換には UETTag が必要であるため、このプロパティは AppInstallGoal、 InStoreTransactionGoal、 OfflineConversionGoal には適用されません。

MSCLKIDAutoTaggingEnabled

MSCLKID クエリ文字列パラメーターの自動タグ付けが有効かどうかを判断します。 MSCLKID は、広告クリックごとに一意の 32 文字の GUID です。

Name 要素が MSCLKIDAutoTaggingEnabled に設定されている場合、値は true または false のいずれかに設定できます。 値が true の場合、MSCLKID 自動タグ付け機能が有効になります。 オフラインコンバージョン目標を使用してリードを追跡するために、MSCLKID の自動タグ付けを有効にすることもできます。 MSCLKID の自動タグ付けが有効になっている場合、ユーザーが広告をクリックすると、MSCLKID がランディング ページ URL に自動的に追加されます。 たとえば、 www.contoso.com/?msclkid={msclkid} です。 クリック ID は広告クリックごとに一意であり、同じユーザーから同じ広告を複数回クリックすると、複数のクリック ID が生成されます。

重要

MSCLKIDAutoTaggingEnabled 値は、新しいアカウントの作成時に既定で true に設定されます。 オフの場合は、手動でオンにすることができます。 Microsoft Advertising Web アプリケーションまたはキャンペーン管理 API を使用して新しい DurationGoal、EventGoal、OfflineConversionGoal、PagesViewedPerVisitGoal、UrlGoal を追加または更新するたびに、対応する AccountProperty の MSCLKIDAutoTaggingEnabled 値が自動的に true に設定されます。 目標のスコープが顧客レベルに設定されている場合、 顧客 の下にあるすべての既存のアカウントの AccountProperty が設定されます。

ProfileExpansionEnabled

アカウント全体で LinkedIn プロファイル のターゲット設定を展開して、現在のターゲットと同様の追加の顧客にリーチするかどうかを決定します。

プロファイルターゲティングの拡張を有効にすると、Microsoft Advertising は、現在ターゲットに設定しているユーザーと同様に、追加の顧客に広告を表示できます。 たとえば、特定の LinkedIn 対象ユーザー セグメントをターゲットにした場合、確認済みの LinkedIn アカウントを持たないが、そのセグメントの LinkedIn ユーザーと同じ特性を共有するユーザー Bingも対象になります。

Name 要素が ProfileExpansionEnabled に設定されている場合、値を true または false に設定できます。 値が true の場合、LinkedIn プロファイルのターゲット拡張機能が有効になります。

TrackingUrlTemplate

Name 要素が TrackingUrlTemplate に設定されている場合、値はアカウント内のすべての URL の既定値として使用するアカウントの追跡テンプレートを表します。 TrackingUrlTemplate キーの値は、次に説明するように任意の有効な文字列に設定できます。

  • 下位レベルのエンティティに対して定義された追跡テンプレート (例: キーワード (keyword)、キャンペーンなど、上位レベルのエンティティの設定をオーバーライドします。 詳細については、「 エンティティの制限」を参照してください。

  • 追跡テンプレートの長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。

  • 追跡テンプレートは、 http://、 https://、 {lpurl}、または {unescapedlpurl} のいずれかで始まる適切な形式の URL である必要があります。

  • {lpurl}、{lpurl+2}、{lpurl+3}、{unescapedlpurl}、{escapedlpurl} の少なくとも 1 つのランディング ページ URL パラメーターを含める必要があります。 さらに、Microsoft Advertising でサポートされている任意の動的パラメーターを使用できます。 サポートされているパラメーターの一覧については、Microsoft Advertising ヘルプ記事「追跡テンプレートを設定する」の「使用可能なパラメーター」セクションを参照してください。

  • Microsoft Advertising では、カスタム パラメーターが存在するかどうかを検証しません。 追跡テンプレートでカスタム パラメーターを使用し、それらが存在しない場合、最終的な URL には、代替なしでカスタム パラメーターのキーと値のプレースホルダーが含まれます。 たとえば、トラッキング テンプレートが たとえば https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}で、{_season} または {_promocode} がキャンペーン、広告グループ、キーワード (keyword)、または広告レベルで定義されていない場合、最終的な URL は同じになります。

アカウントの追跡テンプレートを削除するには 、[名前] を TrackingUrlTemplate に、 値 を "" (空の文字列) に設定します。

要件

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

使用ページ

GetAccountProperties
SetAccountProperties