ConversionGoal データ オブジェクト - キャンペーン管理
変換目標の基本オブジェクトを定義します。
ConversionGoal をインスタンス化しないでください。 次のオブジェクトから派生する 1 つ以上のオブジェクトを作成できます。
- AppInstallGoal
- DurationGoal
- EventGoal
- InStoreTransactionGoal
- OfflineConversionGoal
- PagesViewedPerVisitGoal
- UrlGoal
構文
<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="ConversionWindowInMinutes" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
<xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
<xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" nillable="true" type="xs:boolean">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
<xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
<xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
<xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
<xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
<xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
要素
ConversionGoal オブジェクトには、AttributionModelType、ConversionWindowInMinutes、CountType、ExcludeFromBidding、GoalCategory、Id、IsEnhancedConversionsEnabled、Name、Revenue、Scope、Status、TagId、TrackingStatus、Type、ViewThroughConversionWindowInMinutes という要素があります。
| 要素 | 説明 | データ型 |
|---|---|---|
| AttributionModelType | 変換目標で使用される属性モデル LastTouch または LastClick を決定します。 この要素は既定では返されません。 この要素を取得するには、 GetConversionGoalsByIds および GetConversionGoalsByTagIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に AttributionModelType 値 を 含めます。 この要素は、 AppInstallGoal、 InStoreTransactionGoal、 OfflineConversionGoal には適用されません。 |
AttributionModelType |
| ConversionWindowInMinutes | 変換ウィンドウは、コンバージョンを追跡するクリック後の時間 (分) です。 この値を 43200 分 (30 日) に設定した場合、クリックが追跡されてから 30 日以内に発生するコンバージョン。 過去のコンバージョンは影響を受けません。 サポートされる最小値は 1 分ですが、コンバージョン期間が短いほどアカウント レコードのコンバージョン数が減ります。 サポートされる最大値は 129600 分 (90 日) です。 | int |
| CountType | これにより、選択した変換ウィンドウ内でのコンバージョンの記録方法が決まります。 選択肢は 2 つあり、値を設定しない場合、既定値は All です。 - すべて: 広告のクリック後に発生したすべてのコンバージョンがカウントされます。 これは、販売の一般的な選択肢です。 - 一意: 広告のクリック後に発生したコンバージョンは 1 つだけカウントされます。 これはリードの一般的な選択肢です。 たとえば、リードと売上の 2 つのコンバージョンを追跡します。 リードの場合は [一意] を選択し、売上の 場合は [すべて ] を選択します。 1 回の広告クリックが 2 つのリードと 2 つの売上に変わると、3 つのコンバージョンとしてカウントされます。1 つは一意のリード用、2 つはすべての売上にカウントされます。 この要素は 、AppInstallGoal には適用されません。 |
ConversionGoalCountType |
| ExcludeFromBidding | この変換目標に関連するデータをパフォーマンス レポート列のサブセットから除外するかどうかを指定します。 この要素は、[コンバージョンに含める] 機能が有効になっているお客様にのみ使用できます (GetCustomerPilotFeatures は 574 を返します)。 この要素が true に設定されている場合、それ以外の場合、この変換目標に関連するデータは、、、、 RevenuePerConversion、およびRevenueレポート列からConversions除外されます。 ReturnOnAdSpendCostPerConversionConversionRate また、自動入札戦略を使用する場合、このプロパティを true に設定すると、目標のコンバージョンが自動入札計算に考慮されなくなります。 このプロパティを "true" に設定することは、実質的に Microsoft Advertising Web アプリケーションで [コンバージョンに含める] をオフにした場合と同じです。この要素の値に関係なく、、 AllConversionRate、AllConversionsAllCostPerConversion、AllReturnOnAdSpend、AllRevenuePerConversion、およびAllRevenueレポート列には、すべての変換目標のデータが含まれます。既定では、この要素は false であり、この変換目標に関連するデータはすべてのレポート列に含まれます。 詳細については、「 レポート属性とパフォーマンス統計」と ヘルプ記事 「コンバージョンの目標: "コンバージョン" と "すべてのコンバージョン"」を参照してください。 |
boolean |
| GoalCategory | 変換目標をセグメント化するために使用されるカテゴリ。 ただし、コンバージョン目標を分類することは、ビジネスにとって意味があります。 目標カテゴリはパフォーマンスに影響しません。目標とそのパフォーマンス メトリックをセグメント化するのに役立ちます。 サポートされているカテゴリ値は変換目標の種類によって異なるため、詳細な要件については、対応する参照ページを参照してください。 |
ConversionGoalCategory |
| Id | 変換目標の一意の Microsoft Advertising 識別子。 | long |
| IsEnhancedConversionsEnabled | コンバージョン目標に対して拡張コンバージョンを有効にするかどうかを決定します。 注: 拡張変換目標を作成して設定 isEnhancedConversionsEnabled=trueするには、Microsoft Advertising UI を使用してアカウントのコンバージョン目標を作成し、拡張変換設定を選択し、関連付けられているチェック ボックスをオンにする必要があります。 |
boolean |
| 名前 | 変換目標名。 名前の最大長は 100 で、名前は同じ顧客に属するすべてのコンバージョン目標の中で一意である必要があります。 |
string |
| 収益 | 各コンバージョンがビジネスにどの程度価値を持っているかを決定します。 収益追跡の設定を指定しない場合にコンバージョン目標を追加する場合、各 ConversionGoalRevenue はそれぞれの既定値に設定されます。 コンバージョン目標を更新するときに、 Revenue 要素が nil または空の場合、入れ子になったプロパティは更新されません。 ただし、この要素が nil または空でない場合は、既存の収益プロパティを効果的に置き換えます。 VariableValue オプションは、AppInstallGoal、DurationGoal、または PagesViewedPerVisitGoal では使用できません。 |
ConversionGoalRevenue |
| 範囲 | 目標がすべてのアカウントに適用されるか、必要な CustomerAccountId ヘッダー要素で指定されたアカウントにのみ適用されるかを決定します。 複数の Microsoft Advertising アカウントがある場合は、それらのすべてのアカウントでコンバージョンを追跡できます。 目標を 1 つのアカウントに関連付けた場合、コンバージョンはそのアカウントに対してのみ追跡されます。 使用可能な値は Account と Customer です。 スコープを設定した後は、変更できません。 スコープを変更する場合は、新しい変換目標を作成し、古いコンバージョン目標を一時停止する必要があります。 AppInstallGoal では、Customer スコープのみがサポートされています。 |
EntityScope |
| Status | 変換目標のユーザーが決定できる状態値を定義します。 これらは、ユーザーが設定できる状態の値です。たとえば、その目標のコンバージョンを追跡する必要がなくなった場合は、目標を [一時停止 ] に設定できます。 UET タグが検証されているかどうかなど、システムによって設定できる状態値については、 TrackingStatus 要素を参照してください。 |
ConversionGoalStatus |
| TagId | ユーザーが Web サイトで行うアクションを Microsoft Advertising が収集できるようにするために、Web サイトに追加した UET タグの一意の Microsoft Advertising 識別子。 タグ ID に依存する前に、UET タグを別の顧客と共有することも、他の顧客から共有することもできます。 共有 UET タグと対象ユーザーは、パイロットのお客様のみが使用できます。 顧客階層での対象ユーザーと UET タグの共有の概要については、「 対象ユーザーと UET タグの共有 」テクニカル ガイドを参照してください。 この要素は、 AppInstallGoal、 InStoreTransactionGoal、 OfflineConversionGoal には適用されません。 |
long |
| TrackingStatus | 変換目標のシステムによって決定される状態値を定義します。 これらは、システムによって設定できるステータス値です。たとえば、UET タグがまだ検証されていない場合は、ステータスが TagUnverified に設定されます。 ユーザーが設定できる状態値については、たとえば、その目標のコンバージョンを追跡する必要がなくなった場合に状態を [一時停止 ] に設定する場合は、 Status 要素を参照してください。 AppInstallGoal と OfflineConversionGoal には、NoRecentConversions と RecordingConversions の状態のみが適用されます。 |
ConversionGoalTrackingStatus |
| 型 | 変換目標の種類。 コンバージョン目標の種類の詳細については、「 備考」を参照してください。 | ConversionGoalType |
| ViewThroughConversionWindowInMinutes | ビュースルー変換ウィンドウは、ビュースルー変換を追跡するクリック後の時間 (分単位) です。 この値を 43200 分 (30 日) に設定した場合、クリックが追跡されてから 30 日以内に発生するビュースルーコンバージョン。 過去のコンバージョンは影響を受けません。 サポートされる最小値は 1 分ですが、コンバージョン期間が短いほどアカウント レコードのコンバージョン数が減ります。 サポートされる最大値は 43200 分 (30 日) です。 ビュースルー変換を追跡するには、 IncludeViewThroughConversions アカウント プロパティも true に設定する必要があります。 この要素は既定では返されません。 この要素を取得するには、 GetConversionGoalsByIds および GetConversionGoalsByTagIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に ViewThroughConversionWindowInMinutes 値を 含めます。 この要素は、 AppInstallGoal、 InStoreTransactionGoal、 OfflineConversionGoal には適用されません。 |
int |
注釈
Java および .NET 言語の場合は、インスタンス化する変換目標の種類によって値が決定されるため、 Type 要素を設定しないでください。
SOAP を手動で生成する場合は、次の例に示すようにノードの <ConversionGoal>type 属性を使用して、変換目標の型を指定します。
<ConversionGoals i:nil="false">
<ConversionGoal i:type="UrlGoal">
<ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
<CountType i:nil="false">Unique</CountType>
<Id i:nil="true" />
<Name i:nil="false">My Url Conversion Goal</Name>
<Revenue i:nil="false">
<CurrencyCode i:nil="false">USDollar</CurrencyCode>
<Type i:nil="false">FixedValue</Type>
<Value i:nil="false">10.00</Value>
</Revenue>
<Scope i:nil="false">Customer</Scope>
<Status i:nil="true" />
<TagId i:nil="false"></TagId>
<TrackingStatus i:nil="true" />
<UrlExpression i:nil="false">contoso</UrlExpression>
<UrlOperator i:nil="false">Contains</UrlOperator>
</ConversionGoal>
</ConversionGoals>
要件
サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13
Used By
AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals