コンバージョン リソースには、ユーザーが Floodlight コンバージョンを一括作成、変更、取得するためのメソッドが用意されています。
このリソースのメソッドの一覧は、このページの最後に掲載されています。
リソース表記
コンバージョンのリスト。
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": long, "advertiserId": long, "engineAccountId": long, "campaignId": long, "customerId": string, "adGroupId": long, "criterionId": long, "adId": long, "clickId": string, "dsConversionId": long, "conversionId": string, "state": string, "type": string, "revenueMicros": long, "currencyCode": string, "quantityMillis": long, "segmentationType": string, "segmentationId": long, "segmentationName": string, "conversionTimestamp": unsigned long, "conversionModifiedTimestamp": unsigned long, "floodlightOrderId": string, "customMetric": [ { "name": string, "value": double } ], "customDimension": [ { "name": string, "value": string } ], "countMillis": long, "attributionModel": string, "productGroupId": long, "inventoryAccountId": long, "productId": string, "productCountry": string, "productLanguage": string, "channel": string, "storeId": string, "deviceType": string, "adUserDataConsent": string } ] }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
conversion[] |
list |
リクエストされているコンバージョン。 | |
conversion[].adGroupId |
long |
DS 広告グループ ID。 | |
conversion[].adId |
long |
DS の広告 ID。 | |
conversion[].adUserDataConsent |
string |
設定でコアサービス(CPS)の設定に同意することを表明します。デフォルト値はありません。使用できる値は次のとおりです。GRANTED: 「許可」の同意ステータスを指定します。GTE 設定から CPS 設定を読み取ります。DENIED: 希望する同意ステータスは拒否です。CPS リストは空です。 | |
conversion[].advertiserId |
long |
DS 広告主 ID。 | |
conversion[].agencyId |
long |
DS 代理店 ID。 | |
conversion[].attributionModel |
string |
DoubleClick Search カスタマー サポートへのお問い合わせ後に広告主様のみご利用いただけます。 | |
conversion[].campaignId |
long |
DS キャンペーン ID。 | |
conversion[].channel |
string |
商品の販売チャネル。指定できる値は次のとおりです。
|
|
conversion[].clickId |
string |
コンバージョンの DS クリック ID。 | |
conversion[].conversionId |
string |
オフライン コンバージョンの場合は、広告主がこの ID を指定します。広告主は、自分にとってわかりやすい任意の ID を指定できます。リクエスト内の各コンバージョンには一意の ID を指定する必要があります。ID とタイムスタンプの組み合わせは、その広告主のすべてのコンバージョンの中で一意である必要があります。 オンライン コンバージョンの場合は、広告主の Floodlight 処理に応じて、 dsConversionId または floodlightOrderId がこのプロパティにコピーされます。 |
|
conversion[].conversionModifiedTimestamp |
unsigned long |
コンバージョンが最後に変更された時刻(エポック ミリ UTC)。 | |
conversion[].conversionTimestamp |
unsigned long |
コンバージョンが発生した時刻(エポックミリ UTC)。 | |
conversion[].countMillis |
long |
DoubleClick Search カスタマー サポートへのお問い合わせ後に広告主様のみご利用いただけます。 | |
conversion[].criterionId |
long |
DS 条件(キーワード)ID。 | |
conversion[].currencyCode |
string |
コンバージョンの収益の通貨コード。ISO 4217 英字(3 文字)形式で指定してください。 | 書き込み可能 |
conversion[].customDimension[] |
list |
コンバージョンのカスタム ディメンション。レポート内のデータのフィルタリングに使用できます。 | |
conversion[].customDimension[].name |
string |
カスタム ディメンション名。 | |
conversion[].customDimension[].value |
string |
カスタム ディメンションの値。 | |
conversion[].customMetric[] |
list |
コンバージョンのカスタム指標。 | |
conversion[].customMetric[].name |
string |
カスタム指標の名前。 | |
conversion[].customMetric[].value |
double |
カスタム指標の数値。 | |
conversion[].customerId |
string |
検索広告 360 リニューアル版のお客様 ID。クライアント アカウントである必要があります。このフィールドを設定した場合、他のすべての ID フィールドは検索広告 360 リニューアル版の ID に設定する必要があります。 | |
conversion[].deviceType |
string |
コンバージョンが発生したデバイスのタイプ。
有効な値は次のとおりです。
|
|
conversion[].dsConversionId |
long |
DoubleClick Search が各コンバージョンに対して生成する ID。 | |
conversion[].engineAccountId |
long |
DS エンジン アカウント ID。 | |
conversion[].floodlightOrderId |
string |
コンバージョンに関して広告主から提供された Floodlight オーダー ID。 | |
conversion[].inventoryAccountId |
long |
この ID は、商品が含まれる在庫アカウントを一意に識別するために生成され、使用されます。 | |
conversion[].productCountry |
string |
商品を含む Merchant Center フィードに登録されている国。国の指定には ISO 3166 コードを使用します。 | |
conversion[].productGroupId |
long |
DS 商品グループ ID。 | |
conversion[].productId |
string |
商品 ID(SKU)。 | |
conversion[].productLanguage |
string |
商品が含まれる Merchant Center フィードに登録されている言語。ISO 639 コードを使用して言語を指定します。 | |
conversion[].quantityMillis |
long |
このコンバージョンの量(ミリ単位)。 | 書き込み可能 |
conversion[].revenueMicros |
long |
この TRANSACTION コンバージョンの収益額(マイクロ単位)(値に 1000000 を掛けた値、小数なし)。たとえば、収益の値を「10」に指定するには、リクエストに「10000000」(1, 000 万)と入力します。 |
書き込み可能 |
conversion[].segmentationId |
long |
数値のセグメンテーション識別子(例: DoubleClick Search Floodlight アクティビティ ID)。 | |
conversion[].segmentationName |
string |
わかりやすいセグメント識別子(例: DoubleClick Search の Floodlight アクティビティ名)。 | |
conversion[].segmentationType |
string |
このコンバージョンのセグメンテーション タイプ(例: FLOODLIGHT )。
有効な値は次のとおりです。
|
|
conversion[].state |
string |
コンバージョンの状態(ACTIVE または REMOVED )。注: DELETED は非推奨となりました。
有効な値は次のとおりです。
|
書き込み可能 |
conversion[].storeId |
string |
商品を宣伝した実店舗の ID。チャンネルが「local 」の場合にのみ適用されます。 |
|
conversion[].type |
string |
コンバージョンのタイプ(ACTION または TRANSACTION )。「ACTION 」コンバージョンは、ユーザーが行った、金銭的な数値化可能な値を持たないアクションを指します。「TRANSACTION 」のコンバージョンは、ユーザーによる、金銭的な数値化可能な値を持つアクションを指します。たとえば、メーリング リストの登録(ACTION )や e コマースでの購入(TRANSACTION )などが該当します。
有効な値は次のとおりです。
|
|
kind |
string |
これが ConversionList リソースであることを示します。値: 固定文字列 doubleclicksearch#conversionList 。 |
Methods
- get
- DoubleClick Search エンジン アカウントからコンバージョンのリストを取得します。
- getByCustomerId
- 検索広告 360 リニューアル版のお客様 ID を使用して、DoubleClick Search エンジン アカウントからコンバージョンのリストを取得します。
- insert
- 新しいコンバージョンのバッチを DoubleClick Search に挿入します。
- update
- DoubleClick Search で一連のコンバージョンを更新します。
- updateAvailability
- DoubleClick Search で一連の Floodlight アクティビティが利用可能かどうかを更新します。