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

  • [アーティクル]

Microsoft Advertising に送信するオフライン コンバージョンを定義します。

オフラインコンバージョントラッキングを設定するには、 OfflineConversionGoal を作成します。 OfflineConversionGoal の CountType を [すべて] に設定すると、変換時間が異なる同じ MicrosoftClickId のすべてのオフライン変換が累積的に追加されます。 OfflineConversionGoal の CountType を [一意] に設定した場合、広告のクリック後に発生した最初のコンバージョンのみがカウントされます。 同じ MicrosoftClickId と ConversionTime を使用したオフライン変換の重複は無視されます。 つまり、特定の MicrosoftClickId と ConversionTime の最初のオフライン変換のみがカウントされます。

重要

OfflineConversionGoal が設定されたら、2 時間待ってから、ApplyOfflineConversions 操作を介して Microsoft Advertising の OfflineConversion データを送信します。 Microsoft Advertising レポートでコンバージョン データを表示するには、最大 6 時間かかることがあります。

注:

機能テストのためにサンドボックスにオフライン変換をアップロードすることはできますが、オフライン変換データはサンドボックスのパフォーマンス レポート データには含まれません。

構文

<xs:complexType name="OfflineConversion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="ConversionCurrencyCode" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ConversionTime" type="xs:dateTime" />
    <xs:element minOccurs="0" name="ConversionValue" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionCredit" nillable="true" type="xs:double" />
    <xs:element minOccurs="0" name="ExternalAttributionModel" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="HashedEmailAddress" nillable="true" type="xs:string">
      <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="HashedPhoneNumber" nillable="true" type="xs:string">
      <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="MicrosoftClickId" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

要素

OfflineConversion オブジェクトには、ConversionCurrencyCode、ConversionName、ConversionTime、ConversionValue、ExternalAttributionCredit、ExternalAttributionModel、HashedEmailAddress、HashedPhoneNumber、MicrosoftClickId という要素があります。

要素 説明 データ型
ConversionCurrencyCode オフライン変換の通貨コード。

詳細については、「 通貨」を参照してください。

適用： オプション。 オフライン換算通貨コードを指定しない場合は、目標の ConversionGoalRevenue の CurrencyCode 要素が使用されます。		 string
ConversionName 変換目標名。

この名前は既存のコンバージョン目標名と一致する必要があります。それ以外の場合、オフラインコンバージョン目標データは適用されません。

適用： 必須		 string
ConversionTime オフライン変換が発生した日時。

日付と時刻は過去 90 日以内である必要があります。それ以外の場合、Microsoft Advertising にオフライン変換データを送信しようとすると、操作は失敗します。

アップロードが成功した後にオフラインコンバージョンとして Microsoft Advertising によってカウントされるには、次の追加要件を満たす必要があります。
- 変換の日時は、記録されたクリックの日付と時刻より後に設定する必要があります。
- 日付と時刻は変換ウィンドウ内にある必要があります。 OfflineConversionGoal の ConversionWindowInMinutes プロパティは、コンバージョンが追跡されるクリック後の最大時間 (分) を決定します。

たとえば、4 月 30 日に 3 回のクリックが記録された場合、OfflineConversionGoal の ConversionWindowInMinutes が 30 日 (43200 分) に等しく、7 月 31 日に Microsoft Advertising に次のオフラインコンバージョンを送信した場合、Microsoft Advertising は MicrosoftClickId=2 をオフラインコンバージョンとしてカウントします。
- MicrosoftClickId=1;ConversionTime=2020-04-30T17:02:35.6853793Z
- MicrosoftClickId=2;ConversionTime=2020-05-15T17:02:35.6853793Z
- MicrosoftClickId=3;ConversionTime=2020-06-15T17:02:35.6853793Z

MicrosoftClickId=1 のオフライン変換データは、変換日時が 90 日以上前であるためアップロードされません。また、MicrosoftClickId=3 のオフライン変換データは、変換ウィンドウ (4 月 30 日から 5 月 29 日) に含まれていないためカウントされません。

大事な： 値は協定世界時 (UTC) である必要があります。 これは、Microsoft Advertising Web アプリケーションでオフライン コンバージョンをアップロードするときのタイム ゾーン オプションとは異なります。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。

適用： 必須		 dateTime
ConversionValue オフライン変換値。

適用： オプション。 オフライン変換値を指定しない場合は、目標の ConversionGoalRevenue の Value 要素が使用されます。		 ダブル
ExternalAttributionCredit このフィールドは、外部属性を使用するコンバージョン アクションにのみ設定できます。 これは、各クリックに起因する変換の割合を表します。 値は 0 より大きく、1 以下である必要があります。

このフィールドが外部属性以外の変換アクションで使用されている場合、GoalNotEligibleForExternalAttribution エラーが返されます。

適用： オプション		 ダブル
ExternalAttributionModel このフィールドは、外部属性を使用するコンバージョン アクションにのみ設定できます。 属性モデル名を指定します。

このフィールドが外部属性以外の変換アクションで使用されている場合、GoalNotEligibleForExternalAttribution エラーが返されます。

適用： オプション		 string
HashedEmailAddress 拡張変換で使用する SHA-256 アルゴリズムを使用したハッシュされた電子メール アドレス。 string
HashedPhoneNumber 拡張変換で使用する E.164 標準に従ったハッシュ電話番号。 string
MicrosoftClickId オフライン変換の MSCLKID。

Microsoft のクリック ID 追跡で自動タグ付けが有効になっていることを確認するには、 GetAccountProperties 操作と SetAccountProperties 操作を 使用します。

適用： オプション

注: 拡張変換用にハッシュされたメール アドレスまたは電話番号を指定する場合、MSCLKID は省略可能です。		 string

要件

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

使用ページ

ApplyOfflineConversions