次の方法で共有

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

  • [アーティクル]

カスタム イベント リマーケティング ルールを定義します。

リマーケティング ルールは、リマーケティング リストに追加するユーザーを決定するために使用される条件です。 カスタム イベント ルールの場合は、次の条件付きイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上を含める必要があります。 複数の条件を指定した場合、論理 AND 演算子を使用して条件が結合されます。 つまり、指定したルール条件がすべて満たされている場合にのみ、訪問者がリマーケティング リストに追加されます。

詳細な例については、以下の 「備考 」セクションを参照してください。

構文

<xs:complexType name="CustomEventsRule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RemarketingRule">
      <xs:sequence>
        <xs:element minOccurs="0" name="Action" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Category" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Label" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" type="tns:NumberOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

CustomEventsRule オブジェクトには、Action、ActionOperator、Category、CategoryOperator、Label、LabelOperator、Value、ValueOperator の各要素があります。

要素 説明 データ型
アクション 追跡するユーザー操作の種類。たとえば、'play' や 'pause' などです。

追加または更新操作中にこの要素を指定する場合は、 ActionOperator 要素も必要です。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に ActionOperator と Action を含めなかった場合、既存の ActionOperator と Action の設定はすべて削除されます。		 string
ActionOperator Action 要素の値に適用できる演算子。

追加または更新操作中にこの要素を指定する場合は、 Action 要素も必要です。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に ActionOperator と Action を含めなかった場合、既存の ActionOperator と Action の設定はすべて削除されます。		 StringOperator
カテゴリ 追跡するイベントのカテゴリ。たとえば、'video' です。

追加または更新操作中にこの要素を指定する場合は、 CategoryOperator 要素も必要です。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に CategoryOperator と Category を含めなかった場合、既存の CategoryOperator と Category の設定はすべて削除されます。		 string
CategoryOperator Category 要素の値に適用できる演算子。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に CategoryOperator と Category を含めなかった場合、既存の CategoryOperator と Category の設定はすべて削除されます。		 StringOperator
Label アクションの原因となった要素の名前。 たとえば、'トレーラー' や 'behindthescenes' などです。

追加または更新操作中にこの要素を指定する場合は、 LabelOperator 要素も必要です。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に LabelOperator と Label を含めなかった場合、既存の LabelOperator と Label の設定はすべて削除されます。		 string
LabelOperator Label 要素の値に適用できる演算子。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に LabelOperator と Label を含めなかった場合、既存の LabelOperator と Label の設定はすべて削除されます。		 StringOperator
価値 そのイベントに関連付けられている正の整数値。 たとえば、値はビデオが再生された時間の長さです。

追加または更新操作中にこの要素を指定する場合は、 ValueOperator 要素も必要です。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に ValueOperator と Value を含めなかった場合、既存の ValueOperator と Value の設定はすべて削除されます		 小数
ValueOperator Value 要素の値に適用できる演算子。

足す： 1 つ以上の他のイベントを含める場合は省略可能。次のイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator 、 Value) の 1 つ以上のイベント演算子ペアを含める必要があります。
更新： 1 つ以上の他のイベントを含める場合は省略可能。更新中に ValueOperator と Value を 含めなかった場合、既存の ValueOperator と Value の設定はすべて削除されます。		 NumberOperator

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

継承された要素

リマーケティング ルールから継承された要素

CustomEventsRule オブジェクトは、リマーケティング ルール オブジェクトから派生し、Type という要素を継承します。 以下の説明は CustomEventsRule に固有であり、同じ要素を リマーケティング ルール オブジェクトから継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
種類 リマーケティング ルールの種類。 リマーケティング ルールの種類の詳細については、「 リマーケティング ルール データ オブジェクトの備考」を参照してください。

足す： 読み取り専用
更新： 読み取り専用		 string

解説

CustomEvents ルールの場合は、次の条件付きイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator、Value) の 1 つ以上を含める必要があります。 複数の条件を指定した場合、論理 AND 演算子を使用して条件が結合されます。 つまり、指定したルール条件がすべて満たされている場合にのみ、訪問者がリマーケティング リストに追加されます。

たとえば、次のカスタム イベントが設定されるとします。

<Rule i:type="CustomEventsRule">
  <Type i:nil="true" />
  <Action>play</Action>
  <ActionOperator>Equals</ActionOperator>
  <Category>video</Category>
  <CategoryOperator>Equals</CategoryOperator>
  <Label>trailer</Label>
  <LabelOperator>Equals</LabelOperator>
  <Value>5.00</Value>
  <ValueOperator>Equals</ValueOperator>
</Rule>

上記の定義は、次の論理式に変換されます。

(カテゴリ等しいビデオ) と (Action Equals play) と (Label Equals trailer) と (Value Equals 5)

論理式の評価によって、リマーケティング リストに追加されるユーザーが決まります。

要件

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