次の方法で共有

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

  • [アーティクル]

ストア内トランザクション目標を定義します。

インストア トランザクションを使用すると、小売広告主は広告費用の収益を総合的に把握できます。 特定の Microsoft 広告アカウントとキャンペーンがオフライン購入を促進する方法を確認できます。

注:

店舗内トランザクションの目標は、アルファ パイロットのお客様のみが使用できます。 顧客ごとに作成できる店舗内トランザクションの目標は 1 つだけです。

構文

<xs:complexType name="InStoreTransactionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

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

継承された要素

ConversionGoal から継承された要素

InStoreTransactionGoal オブジェクトは ConversionGoal オブジェクトから派生し、AttributionModelType、ConversionWindowInMinutes、CountType、ExcludeFromBidding、GoalCategory、Id、IsEnhancedConversionsEnabled、Name、Revenue、Scope、Status、TagId、TrackingStatus、Type、ViewThroughConversionWindowInMinutes。 以下の説明は InStoreTransactionGoal に固有であり、 ConversionGoal オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
AttributionModelType 店舗内トランザクションの目標には適用されません。 AttributionModelType
ConversionWindowInMinutes 変換ウィンドウは、コンバージョンを追跡するクリック後の時間 (分) です。 この値を 43200 分 (30 日) に設定した場合、クリックが追跡されてから 30 日以内に発生するコンバージョン。 過去のコンバージョンは影響を受けません。 サポートされる最小値は 1 分ですが、コンバージョン期間が短いほどアカウント レコードのコンバージョン数が減ります。 サポートされる最大値は 129600 分 (90 日) です。

足す： 随意
更新： 随意		 int
CountType これにより、選択した変換ウィンドウ内でのコンバージョンの記録方法が決まります。

選択肢は 2 つあり、値を設定しない場合、既定値は All です。

- すべて: 広告のクリック後に発生したすべてのコンバージョンがカウントされます。 これは、販売の一般的な選択肢です。

- 一意: 広告のクリック後に発生したコンバージョンは 1 つだけカウントされます。 これはリードの一般的な選択肢です。

たとえば、リードと売上の 2 つのコンバージョンを追跡します。 リードの場合は [一意] を選択し、売上の 場合は [すべて ] を選択します。 1 回の広告クリックが 2 つのリードと 2 つの売上に変わると、3 つのコンバージョンとしてカウントされます。1 つは一意のリード用、2 つはすべての売上にカウントされます。

足す： 随意
更新： 随意		 ConversionGoalCountType
ExcludeFromBidding この変換目標に関連するデータをパフォーマンス レポート列のサブセットから除外するかどうかを指定します。

この要素は、[コンバージョンに含める] 機能が有効になっているお客様にのみ使用できます (GetCustomerPilotFeatures は 574 を返します)。

この要素が true に設定されている場合、この変換目標に関連するデータは、 Conversions、 ConversionRate、 CostPerConversion、 ReturnOnAdSpend、 RevenuePerConversion、 Revenue レポート列から除外されます。 また、自動入札戦略を使用する場合、このプロパティを true に設定すると、目標のコンバージョンが自動入札計算に考慮されなくなります。 このプロパティを "true" に設定することは、実質的に Microsoft Advertising Web アプリケーションで [コンバージョンに含める] をオフにした場合と同じです。

この要素の値に関係なく、 AllConversions、 AllConversionRate、 AllCostPerConversion、 AllReturnOnAdSpend、 AllRevenuePerConversion、 AllRevenue のレポート列には、すべての変換目標のデータが含まれます。 既定では、この要素は false であり、この変換目標に関連するデータはすべてのレポート列に含まれます。

詳細については、「 レポート属性とパフォーマンス統計」と ヘルプ記事 「コンバージョンの目標: "コンバージョン" と "すべてのコンバージョン"」を参照してください。

足す： 随意
更新： 随意		 boolean
GoalCategory 変換目標をセグメント化するために使用されるカテゴリ。

ただし、コンバージョン目標を分類することは、ビジネスにとって意味があります。 目標カテゴリはパフォーマンスに影響しません。目標とそのパフォーマンス メトリックをセグメント化するのに役立ちます。

サポートされているカテゴリ値は、コンバージョン目標の種類によって異なります。 店舗内トランザクションの目標は 、購入 カテゴリのみをサポートします。

足す： 随意。 この要素を nil のままにするか空のままにすると、既定のカテゴリが [購入] に設定されます。
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。		 ConversionGoalCategory
身分証明書 変換目標の一意の Microsoft Advertising 識別子。

足す： 読み取り専用
更新： 必須と Read-Only		 long
IsEnhancedConversionsEnabled コンバージョン目標に対して拡張コンバージョンを有効にするかどうかを決定します。

注: 拡張変換目標を作成し、 isEnhancedConversionsEnabled=trueを設定するには、Microsoft Advertising UI を使用してアカウントのコンバージョン目標を作成し、拡張変換設定を選択し、関連付けられているチェック ボックスをオンにする必要があります。		 boolean
名前 変換目標名。

名前の最大長は 100 で、名前は同じ顧客に属するすべてのコンバージョン目標の中で一意である必要があります。

足す： 必須
更新： 随意		 string
収入 各コンバージョンがビジネスにどの程度価値を持っているかを決定します。

収益追跡の設定を指定しない場合にコンバージョン目標を追加する場合、各 ConversionGoalRevenue はそれぞれの既定値に設定されます。

コンバージョン目標を更新するときに、 Revenue 要素が nil または空の場合、入れ子になったプロパティは更新されません。 ただし、この要素が nil または空でない場合は、既存の収益プロパティを効果的に置き換えます。

ストア内トランザクションの目標を追加または更新する場合は 、ConversionGoalRevenue CurrencyCode を指定する必要があります。

足す： 随意
更新： 随意		 ConversionGoalRevenue
範囲 目標がすべてのアカウントに適用されるか、必要な CustomerAccountId ヘッダー要素で指定されたアカウントにのみ適用されるかを決定します。

ストア内トランザクションの目標の場合、 アカウント レベルのスコープはサポートされていません。 この要素は Customer に設定することも、そのままにすることもできます。 指定しない場合、スコープは既定で Customer に設定されます。

足す： 随意
更新： 随意		 EntityScope
Status コンバージョン目標の可能なユーザーが決定する状態の値を定義します。 これらは、ユーザーが設定できる状態の値です。たとえば、その目標のコンバージョンを追跡する必要がなくなった場合は、目標を [一時停止 ] に設定できます。

システムによって設定できる状態値については、 TrackingStatus 要素を参照してください。

足す： 随意
更新： 随意		 ConversionGoalStatus
TagId 店舗内トランザクションの目標には適用されません。 long
TrackingStatus 店舗内トランザクションの目標には適用されません。 ConversionGoalTrackingStatus
種類 変換目標の種類。 この値は、ストア内トランザクションの目標を取得するときの InStoreTransaction です。 変換目標の種類の詳細については、「 ConversionGoal Data Object 解説」を参照してください。

足す： 読み取り専用
更新： 読み取り専用		 ConversionGoalType
ViewThroughConversionWindowInMinutes 店舗内トランザクションの目標には適用されません。 int

要件

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