新しいコンバージョンを追加

アップロードしたデータを使用できるようになるまで、どのくらいかかりますか？

コンバージョンの当日または前日のconversionTimestamp、 コンバージョンがアップロードから 1 時間以内に検索広告 360 の管理画面に表示されます。もし 昨日より古い conversionTimestamp を指定すると、指標は 数時間かかります。

変換のすべてのタイムスタンプをエポック時刻（Unix 時間）に変換します。

API から Floodlight アクティビティを作成できますか？

広告主がオフライン コンバージョンのトラッキング用の Floodlight アクティビティをまだ作成していない場合は、 <ph type="x-smartling-placeholder"></ph> キャンペーン マネージャー API を使用して作成してください。API を使用して Floodlight アクティビティを主にオフライン コンバージョンに使用すること。この場合は、この方法が最適です。 入札戦略でコンバージョンのデータが使用されるタイミングを実践します。

API を使用して Floodlight を作成したら、 アクティビティ] がある場合、検索広告 360 のユーザーが検索広告 360 にログインしてアクティビティの 設定を使用して、サービスのプライマリ ソース オフライン アクティビティかを確認します。

コンバージョンの追加に関するベスト プラクティス

コンバージョンを追加する際は、次のベスト プラクティスをおすすめします。

1. 検索広告 360 ユーザーに、検索広告 360 にログインして設定を変更するよう依頼する （オフライン コンバージョンのレポートに使用する各 Floodlight アクティビティ）この設定は、 は、コンバージョンの主な発生元がオフライン アクティビティであることを示しています。詳しくは、 検索広告 360 ヘルプセンター をご覧ください。

2. コンバージョンは、利用可能になり次第アップロードします。 コンバージョンを特定の訪問に結び付ける場合は、コンバージョンを コンバージョンをアップロードする前に確認できます。次の場合、検索広告 360 で訪問のクリック ID が認識されないことがあります。 アップロードしてから 30 分以内にまれに、次のような状況が発生することがあります。 検索広告 360 が clickId を認識できるようになるまで、最大 4 時間お待ちください。

   各アップロードに最新のコンバージョンが含まれていることを確認します。1 つの エントリが時系列でなくても問題ありません。入札戦略によっては 古いコンバージョンを後で別のリクエストでアップロードしても、そのコンバージョンは考慮されません。

3. 24 時間以上経過してから Floodlight アクティビティのコンバージョンをアップロードする場合は、 メッセージを送信 タイムスタンプ。

   状況を示すタイムスタンプは次のいずれかにする必要があります。

   • 過去 24 時間以内にコンバージョンを記録したが、コンバージョンをアップロードしていない場合 ただし、タイムスタンプは最後にアップロードされたコンバージョンが 発生します。これにより、コンバージョンが発生した可能性があることを検索広告 360 に伝えます。 過去 24 時間以内のもので、データがまだ提供されていません。入札戦略と その他の自動システムでは、過去の掲載結果の履歴のみが 表します。
   • 過去 24 時間以内にコンバージョンが発生しなかった場合、タイムスタンプは 現在の日時が表示されます。これにより検索広告 360 では 過去 24 時間以内に発生したコンバージョン入札戦略とその他の自動入札 システムには過去 24 時間（コンバージョンが発生していない丸 1 日）が含まれる パフォーマンス履歴の一部になります

挿入リクエストを送信する

Conversion.insert() リクエストを送信すると、次のことができます。

• コンバージョンを特定の訪問に関連付ける
• コンバージョンをキーワードのみに関連付ける

Conversion.insert() リクエストに必要なフィールドは、 そのイベントやアイテムが表示されます以下のセクションでは、必要な オプション フィールドも用意されています。

コンバージョンを特定の訪問に関連付ける

ユーザーが 1 つ以上の広告をクリックして広告主のサイトにアクセスすると 検索広告 360 では、広告主のサイトでのユーザー セッションが訪問とみなされます。 コンバージョンを訪問に結び付けるには、Conversion.insert() で次のように指定します。 request:

必須項目

• clickId: 訪問のクリック ID（大文字と小文字は区別されます）。詳しくは、 広告主のウェブログでクリック ID を確認するか、コンバージョンを一覧表示して、 別のコンバージョンのクリック ID などです。検索広告 360 はコンバージョンを 原因となっていたキーワード、広告などの検索広告 360 オブジェクト アクセスが生成されます。
  通知を受け取ったら 30 分以上待ちます 検索広告 360 でクリック ID が生成され、コンバージョンをアップロードします。 「クリック ID が見つかりません」というメッセージが表示された場合4 時間待ってから 役立ちます すべてのコンバージョンは、発生から 90 日以内にアップロードする必要があります。 クリック ID が生成されます。 そうしないと、Search Ads 360 API で訪問が認識されない可能性があります。
• conversionId: オフライン コンバージョンの場合は、広告主がこの ID を指定します。広告主様は 意味のある任意の ID を指定します。リクエストの各コンバージョンには一意の ID を指定する必要があります。 ID とタイムスタンプの組み合わせは、広告主のすべてのコンバージョン間で一意である必要があります。 オンライン コンバージョンの場合は、dsConversionId または floodlightOrderId がコピーされます。 必ずこのプロパティにタグを付けます。
• conversionTimestamp: アクションが行われた日時を 記録されます。たとえば、 2016 年 8 月 5 日（金）午前 11 時 53 分 22 秒（米国東部夏時間（GMT -4:00））に、 タイムスタンプをエポックミリ秒単位で指定する（1470412402000）。
• segmentationType: アップロードするコンバージョン システムのタイプを指定します。 指定します。現在サポートされているのは Floodlight コンバージョンのみであるため、このフィールドには FLOODLIGHT を指定する必要があります。
• segmentationName: 広告主が担当する Floodlight アクティビティの名前 レポートに使用できます。

  広告主に同じ名前のアクティビティがある場合（ 異なる Floodlight グループに属している場合、 アクティビティのいずれかの名前を変更します。

  検索広告 360 が Floodlight アクティビティに割り当てた ID がわかっている場合は、 名前を指定する代わりに、segmentationId で ID を指定できます。 segmentationName フィールド。（キャンペーン マネージャーでは Floodlight アクティビティにも ID が割り当てられ、 ただし、キャンペーン マネージャー ID は検索広告 360 ID とは異なるため、 conversions.)Floodlight アクティビティの検索広告 360 ID を表示するには、 コンバージョン レポート（ 検索広告 360 の管理画面またはレポート API）。期間中に少なくとも 1 つのコンバージョンが Floodlight アクティビティに起因する場合、 検索広告 360 ID が表示されます。

• type: コンバージョンのタイプ（ACTION または） または TRANSACTION。アクション コンバージョンには金銭的価値はありませんが、 TRANSACTION 変換を行います。例として、メーリング リストの登録（ACTION）と トランザクションです。

  TRANSACTION を指定した場合、 次のフィールドも指定する必要があります。

  • revenueMicros: コンバージョンの金銭的価値。

省略可能項目

• quantityMillis: このコンバージョンの商品アイテム数。たとえば、 メールのニュースレターに登録したユーザー数、販売された商品の総数。 ACTION コンバージョンにこのフィールドを指定しない場合は、検索広告 360 によって自動的に 1000 の値。
• currencyCode: トランザクションの収益の通貨。デフォルトでは は広告主の通貨で表示されます。別の通貨を指定した場合、検索広告 360 指定された収益額を広告主の通貨に換算します。 詳細
  ISO 4217 アルファベット（3 文字）を使用してください 形式で通貨を指定します。
  トランザクション コンバージョンにのみ適用されます。
• customMetric、customDimension: たとえば購入された商品の配送先の国、商品 ID、 通話時間の長さ。詳細: カスタムトレーニングや Floodlight 変数。
• deviceType: コンバージョンが発生したデバイスのタイプを指定します。詳しくは、 使用可能な値のリスト 表示されます。

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
    "currencyCode": "USD"
  }]
}
          

  /**
   * Instantiate the Doubleclicksearch service, create conversions, and upload them.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.

    // Set up a List to keep track of each conversion you create.
    List<Conversion> conversions = new Vector<Conversion>();

    // Add a conversion to the List.
    addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
        "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);

    // Upload the List and handle the response.
    uploadConversions(conversions, service);
  }


  /**
   * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
   * the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
   */
  private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
      String clickId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion().setClickId(clickId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }


  /**
   * Convert the List of conversions to a DS ConversionList, send an insert request to DS,
   * and output the response to a file.
   */
  private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
      throws IOException {

    FileOutputStream outputStream =
        new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
    final PrintStream printStream = new PrintStream(outputStream);

    try {
      // Convert the List to a ConversionList.
      ConversionList conversionList = new ConversionList().setConversion(conversions);

      // Insert an upload request and download the response to a file.
      service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
      printStream.close();
    } catch (GoogleJsonResponseException e) {
      System.err.println("Get request was rejected.");
      for (ErrorInfo error : e.getDetails().getErrors()) {
        System.err.println(error.getMessage());
      }
      System.exit(e.getStatusCode());
    }
  }
            

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a visit.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
              'conversionId': 'test_20140206_00',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

コンバージョンをキーワードのみに関連付ける

コンバージョンをキーワードに結び付けることが主な目的で、 アトリビューションについて心配する必要はありません。検索広告 360 のほとんどの キーワードの識別子とその他のフィールドのみを指定します。

必須項目

• criterionId: キーワード ID です。criterionId を取得するには、TrackerId を追加します。 マクロを追加します。キーワード ID の取得については、 検索広告 360 ID と コンバージョン。
• conversionId: オフライン コンバージョンの場合は、広告主がこの ID を指定します。広告主様は 意味のある任意の ID を指定します。リクエストの各コンバージョンには一意の ID を指定する必要があります。 ID とタイムスタンプの組み合わせは、広告主のすべてのコンバージョン間で一意である必要があります。 オンライン コンバージョンの場合は、dsConversionId または floodlightOrderId がコピーされます。 必ずこのプロパティにタグを付けます。
• conversionTimestamp: アクションが行われた日時を 記録されます。たとえば、 2016 年 8 月 5 日（金）午前 11 時 53 分 22 秒（米国東部夏時間（GMT -4:00））に、 タイムスタンプをエポックミリ秒単位で指定する（1470412402000）。
• segmentationType: アップロードするコンバージョン システムのタイプを指定します。 指定します。現在サポートされているのは Floodlight コンバージョンのみであるため、このフィールドには FLOODLIGHT を指定する必要があります。
• segmentationName: 広告主が担当する Floodlight アクティビティの名前 レポートに使用できます。

  広告主に同じ名前のアクティビティがある場合（ 異なる Floodlight グループに属している場合、 アクティビティのいずれかの名前を変更します。

  検索広告 360 が Floodlight アクティビティに割り当てた ID がわかっている場合は、 名前を指定する代わりに、segmentationId で ID を指定できます。 segmentationName フィールド。（キャンペーン マネージャーでは Floodlight アクティビティにも ID が割り当てられ、 ただし、キャンペーン マネージャー ID は検索広告 360 ID とは異なるため、 conversions.)Floodlight アクティビティの検索広告 360 ID を表示するには、 コンバージョン レポート（ 検索広告 360 の管理画面またはレポート API）。期間中に少なくとも 1 つのコンバージョンが Floodlight アクティビティに起因する場合、 検索広告 360 ID が表示されます。

• type: コンバージョンのタイプ（ACTION または） または TRANSACTION。アクション コンバージョンには金銭的価値はありませんが、 TRANSACTION 変換を行います。例として、メーリング リストの登録（ACTION）と トランザクションです。

  TRANSACTION を指定した場合、 次のフィールドも指定する必要があります。

  • revenueMicros: コンバージョンの金銭的価値。

省略可能項目

• quantityMillis: このコンバージョンの商品アイテム数。たとえば、 メールのニュースレターに登録したユーザー数、販売された商品の総数。 ACTION コンバージョンにこのフィールドを指定しない場合は、検索広告 360 によって自動的に 1000 の値。
• currencyCode: トランザクションの収益の通貨。デフォルトでは は広告主の通貨で表示されます。別の通貨を指定した場合、検索広告 360 指定された収益額を広告主の通貨に換算します。 詳細
  ISO 4217 アルファベット（3 文字）を使用してください 形式で通貨を指定します。
  トランザクション コンバージョンにのみ適用されます。
• customMetric、customDimension: たとえば購入された商品の配送先の国、商品 ID、 通話時間の長さ。詳細: カスタムトレーニングや Floodlight 変数。
• deviceType: コンバージョンが発生したデバイスのタイプを指定します。詳しくは、 使用可能な値のリスト 表示されます。

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "criterionId": "43700003491981017", // Replace with your ID
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1351196386000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  }]
}

  /**
   * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>.
   * The example in the preceding section contains the uploadConversions method,
   * which can submit the list as an insert() request.
   */
  private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCriterionId(criterionId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }        

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword only.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'criterionId': '43700004289911004', // Replace with your ID
              'conversionId': 'test_1378710000000',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

例

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "attributionModel": "External Attribution Model",
    "countMillis": "330",
    "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
    "currencyCode": "USD"
  }]
}
          

requestValidation エラー

requestValidation エラーは、コンバージョンのアップロードでデータの問題があることを示します。 （例: コンバージョンがアップロードされている、clickId が見つからないなど）。この エラータイプの場合、メッセージの details には次の 2 つの項目が含まれます。

• エラーのタイプを識別する 16 進数コード。このコードは、 エラーを特定することができます。
• 検証エラーの説明。

詳しくは、 コードのリストと コンバージョンのアップロード エラーに対して検索広告 360 が返す可能性のある説明文です。

その他のエラー

その他すべてのタイプのエラー（internalError、transactionFailed、 lateStageRequestError など）は、 検索広告 360

エラーへの応答

リクエストが失敗した場合は、後でリクエストの呼び出し全体を再送信してみてください。検索広告 360 発生したすべてのコンバージョンについて requestValidation エラーが報告されます。 残りのコンバージョンのアップロードが試行されます。

再送信してもエラーが表示される場合は、 トラブルシューティング をご覧ください。