Neue Conversions hinzufügen

Wie lange dauert es, bis ich die hochgeladenen Daten verwenden kann?

Wenn Sie für eine Conversion einen conversionTimestamp für den heutigen oder gestrigen Tag angeben, werden die Conversion-Messwerte innerhalb einer Stunde nach dem Upload in der Search Ads 360-Benutzeroberfläche angezeigt. Falls Sie einen conversionTimestamp für einen Zeitpunkt vor dem gestrigen Datum angeben, werden die Messwerte in einigen Stunden aktualisiert.

Wandeln Sie alle Zeitstempel für Conversions in Epochenzeit (auch Unix-Zeit genannt) um.

Kann ich Floodlight-Aktivitäten über die API erstellen?

Wenn der Werbetreibende noch keine Floodlight-Aktivität zum Erfassen von Offline-Conversions erstellt hat, können Sie mit der Campaign Manager API eine solche erstellen. Mit der API können Sie nicht angeben, dass eine Floodlight-Aktivität hauptsächlich für Offline-Conversions verwendet wird. Dies ist jedoch eine bewährte Methode, wenn in Gebotsstrategien Daten aus der Conversion verwendet werden.

Wir empfehlen, dass sich ein Search Ads 360-Nutzer nachdem Sie mit der API eine Floodlight-Aktivität erstellt haben in Search Ads 360 anmeldet und die Einstellung der Aktivität so ändert, dass die primäre Quelle für Conversions die Offlineaktivität ist.

Best Practices für das Hinzufügen von Conversions

Wir empfehlen die folgenden Best Practices für das Hinzufügen von Conversions:

1. Bitten Sie einen Search Ads 360-Nutzer, sich in Search Ads 360 anzumelden und die Einstellungen für jede Floodlight-Aktivität zu ändern, mit der Sie Offline-Conversions erfassen. In den Einstellungen sollte angegeben sein, dass die primäre Quelle für Conversions Offlineaktivitäten sind. Eine Anleitung finden Sie in der Search Ads 360-Hilfe.

2. Laden Sie Conversions hoch, sobald sie verfügbar sind. Wenn Sie Conversions bestimmten Besuchen zuordnen, warten Sie nach dem Besuch mindestens 6 Stunden, bevor Sie die Conversion hochladen. Search Ads 360 erkennt möglicherweise die Klick-ID des Besuchs nicht, wenn Sie den Upload früher durchführen. In seltenen Fällen kann es bis zu 24 Stunden dauern, bis die Klick-ID in Search Ads 360 erkannt wird.

   Achten Sie darauf, dass jeder Upload die neuesten Conversions enthält. Innerhalb einer einzelnen Uploadanfrage ist es in Ordnung, wenn die Einträge nicht in chronologischer Reihenfolge sind. In Gebotsstrategien können möglicherweise keine älteren Conversions berücksichtigt werden, die Sie später in einer anderen Anfrage hochladen.

Anfrage zum Einfügen senden

Sie können eine Conversion.insert()-Anfrage senden, um Folgendes zu tun:

• Conversions einem bestimmten Besuch zuordnen
• Eine Conversion nur einem Keyword zuordnen

Welche Felder in einer Conversion.insert()-Anfrage erforderlich sind, hängt vom Ereignis oder Artikel ab, dem Sie die Conversion zuordnen. In den folgenden Abschnitten sind die erforderlichen und optionalen Felder für jedes Ereignis oder Element aufgeführt, dem Sie eine Conversion zuordnen können.

Conversions einem bestimmten Besuch zuordnen

Wenn ein Nutzer auf eine oder mehrere Anzeigen klickt und die Website eines Werbetreibenden aufruft, wird die Nutzersitzung auf der Website des Werbetreibenden in Search Ads 360 als Besuch betrachtet. Wenn Sie einer Besuchsaktion eine Conversion zuordnen möchten, geben Sie in Ihrer Conversion.insert()-Anfrage Folgendes an:

Pflichtfelder

• clickId: Die Klick-ID des Besuchs, bei der Groß- und Kleinschreibung beachtet wird. Suchen Sie in den Webprotokollen des Werbetreibenden nach der Klick-ID oder listen Sie Conversions auf und verwenden Sie eine Klick-ID aus einer anderen Conversion. In Search Ads 360 wird die Conversion dem Keyword, der Anzeige und anderen Search Ads 360-Objekten zugeordnet, die für den Besuch verantwortlich waren.
  Warten Sie mindestens 6 Stunden, nachdem Search Ads 360 eine Klick-ID generiert hat, um Conversions hochzuladen. Wenn Sie die Fehlermeldung „Klick-ID nicht gefunden“ erhalten, warten Sie 24 Stunden und laden Sie die Conversions dann noch einmal hoch. Alle Conversions müssen innerhalb von 90 Tagen nach der Generierung der Klick-ID hochgeladen werden. Andernfalls wird der Besuch möglicherweise nicht von der Search Ads 360 API erkannt.
• conversionId: Bei Offline-Conversions wird diese ID von Werbetreibenden angegeben. Werbetreibende können eine beliebige ID angeben, die für sie von Bedeutung ist. Für jede Conversion in einer Anfrage muss eine eindeutige ID angegeben werden. Die Kombination aus ID und Zeitstempel muss für alle Conversions des Werbetreibenden eindeutig sein. Bei Online-Conversions wird in Search Ads 360 die dsConversionId oder floodlightOrderId je nach Floodlight-Anweisungen des Werbetreibenden in diese Property kopiert.
• conversionTimestamp: Gibt das Datum und die Uhrzeit an, zu der die Conversion stattgefunden hat. Wenn die Conversion beispielsweise am Freitag, 5. August 2016, um 11:53:22 Uhr (Eastern Daylight Savings Time, GMT – 4:00) erfolgt, geben Sie den Zeitstempel in Epoch-Millisekunden an: 1470412402000.
• segmentationType: Gibt den Conversion-Systemtyp an, in das die Conversion hochgeladen wird. Derzeit werden nur Floodlight-Conversions unterstützt. Daher muss in diesem Feld immer FLOODLIGHT angegeben werden.
• segmentationName: Der Name der Floodlight-Aktivität, mit der der Werbetreibende die Conversion erfasst.

  Wenn Ihr Werbetreibender Aktivitäten mit demselben Namen enthält (was passieren kann, wenn die Aktivitäten zu verschiedenen Floodlight-Gruppen gehören), sollten Sie eine der Aktivitäten umbenennen.

  Wenn Sie die ID kennen, die einer Floodlight-Aktivität in Search Ads 360 zugewiesen wurde, können Sie sie stattdessen im Feld segmentationId angeben.segmentationName In Campaign Manager wird der Floodlight-Aktivität ebenfalls eine ID zugewiesen. Die Campaign Manager-ID unterscheidet sich jedoch von der Search Ads 360-ID und kann nicht zum Zuordnen von Conversions verwendet werden. Wenn Sie die Search Ads 360-ID für eine Floodlight-Aktivität sehen möchten, laden Sie einen Conversion-Bericht herunter (entweder über die Search Ads 360-Benutzeroberfläche oder über die Reporting API). Wenn der Floodlight-Aktivität im Berichtszeitraum mindestens eine Conversion zugeordnet wurde, wird die Search Ads 360-ID im Bericht angezeigt.

• type: Der Conversion-Typ, also entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat keinen Geldwert, während eine TRANSAKTION-Conversion einen Geldwert hat. Beispiele sind Anmeldungen für E-Mail-Listen (AKTION) und E-Commerce-Käufe (TRANSAKTION).

  Wenn Sie TRANSACTION angeben, müssen Sie auch das folgende Feld angeben:

  • revenueMicros: Der Geldwert der Conversion.

Optionale Felder

• quantityMillis: Die Anzahl der Elemente bei dieser Conversion. Beispielsweise die Anzahl der Nutzer, die sich für einen E-Mail-Newsletter angemeldet haben, oder die Gesamtmenge der verkauften Artikel. Wenn Sie dieses Feld für ACTION-Conversions nicht angeben, wird in Search Ads 360 automatisch der Wert 1000 eingefügt.
• currencyCode: Die Währung des Umsatzes einer Transaktion. Standardmäßig wird davon ausgegangen, dass der Umsatz in der Währung des Werbetreibenden angegeben ist. Wenn Sie eine andere Währung angeben, wandelt Search Ads 360 den angegebenen Umsatzbetrag in die Währung des Werbetreibenden um. Weitere Informationen
  Verwenden Sie das alphabetische ISO 4217-Format (3-Zeichen), um die Währung anzugeben.
  Gilt nur für TRANSAKTIONS-Conversions.
• customMetric und customDimension: Hiermit werden zusätzliche Daten zu einer Conversion hochgeladen, z. B. das Land, in das ein gekaufter Artikel versendet wird, Produkt-IDs oder die Dauer eines Telefongesprächs. Weitere Informationen zum Hochladen von Daten für benutzerdefinierte Floodlight-Variablen
• deviceType: Gibt den Typ des Geräts an, auf dem die Conversion erfolgt ist. Eine Liste der zulässigen Werte für dieses Feld finden Sie hier.

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())

Eine Conversion nur einem Keyword zuordnen

Wenn Sie Conversions hauptsächlich Keywords zuordnen möchten und nicht Anzeigen, können Sie die meisten Search Ads 360-Kennzeichnungen weglassen und nur die Kennzeichnung des Keywords sowie einige andere Felder angeben:

Pflichtfelder

• criterionId: Das ist die Keyword-ID. Sie können die criterionId abrufen, indem Sie das Makro TrackerId in Ihre Landingpage-URLs einfügen. Informationen zum Abrufen von Keyword-IDs finden Sie unter Search Ads 360-IDs und Conversions.
• conversionId: Bei Offline-Conversions wird diese ID von Werbetreibenden angegeben. Werbetreibende können eine beliebige ID angeben, die für sie von Bedeutung ist. Für jede Conversion in einer Anfrage muss eine eindeutige ID angegeben werden. Die Kombination aus ID und Zeitstempel muss für alle Conversions des Werbetreibenden eindeutig sein. Bei Online-Conversions wird in Search Ads 360 die dsConversionId oder floodlightOrderId je nach Floodlight-Anweisungen des Werbetreibenden in diese Property kopiert.
• conversionTimestamp: Gibt das Datum und die Uhrzeit an, zu der die Conversion stattgefunden hat. Wenn die Conversion beispielsweise am Freitag, 5. August 2016, um 11:53:22 Uhr (Eastern Daylight Savings Time, GMT – 4:00) erfolgt, geben Sie den Zeitstempel in Epoch-Millisekunden an: 1470412402000.
• segmentationType: Gibt den Conversion-Systemtyp an, in das die Conversion hochgeladen wird. Derzeit werden nur Floodlight-Conversions unterstützt. Daher muss in diesem Feld immer FLOODLIGHT angegeben werden.
• segmentationName: Der Name der Floodlight-Aktivität, mit der der Werbetreibende die Conversion erfasst.

  Wenn Ihr Werbetreibender Aktivitäten mit demselben Namen enthält (was passieren kann, wenn die Aktivitäten zu verschiedenen Floodlight-Gruppen gehören), sollten Sie eine der Aktivitäten umbenennen.

  Wenn Sie die ID kennen, die einer Floodlight-Aktivität in Search Ads 360 zugewiesen wurde, können Sie sie stattdessen im Feld segmentationId angeben.segmentationName In Campaign Manager wird der Floodlight-Aktivität ebenfalls eine ID zugewiesen. Die Campaign Manager-ID unterscheidet sich jedoch von der Search Ads 360-ID und kann nicht zum Zuordnen von Conversions verwendet werden. Wenn Sie die Search Ads 360-ID für eine Floodlight-Aktivität sehen möchten, laden Sie einen Conversion-Bericht herunter (entweder über die Search Ads 360-Benutzeroberfläche oder über die Reporting API). Wenn der Floodlight-Aktivität im Berichtszeitraum mindestens eine Conversion zugeordnet wurde, wird die Search Ads 360-ID im Bericht angezeigt.

• type: Der Conversion-Typ, also entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat keinen Geldwert, während eine TRANSAKTION-Conversion einen Geldwert hat. Beispiele sind Anmeldungen für E-Mail-Listen (AKTION) und E-Commerce-Käufe (TRANSAKTION).

  Wenn Sie TRANSACTION angeben, müssen Sie auch das folgende Feld angeben:

  • revenueMicros: Der Geldwert der Conversion.

Optionale Felder

• quantityMillis: Die Anzahl der Elemente bei dieser Conversion. Beispielsweise die Anzahl der Nutzer, die sich für einen E-Mail-Newsletter angemeldet haben, oder die Gesamtmenge der verkauften Artikel. Wenn Sie dieses Feld für ACTION-Conversions nicht angeben, wird in Search Ads 360 automatisch der Wert 1000 eingefügt.
• currencyCode: Die Währung des Umsatzes einer Transaktion. Standardmäßig wird davon ausgegangen, dass der Umsatz in der Währung des Werbetreibenden angegeben ist. Wenn Sie eine andere Währung angeben, wandelt Search Ads 360 den angegebenen Umsatzbetrag in die Währung des Werbetreibenden um. Weitere Informationen
  Verwenden Sie das alphabetische ISO 4217-Format (3-Zeichen), um die Währung anzugeben.
  Gilt nur für TRANSAKTIONS-Conversions.
• customMetric und customDimension: Hiermit werden zusätzliche Daten zu einer Conversion hochgeladen, z. B. das Land, in das ein gekaufter Artikel versendet wird, Produkt-IDs oder die Dauer eines Telefongesprächs. Weitere Informationen zum Hochladen von Daten für benutzerdefinierte Floodlight-Variablen
• deviceType: Gibt den Typ des Geräts an, auf dem die Conversion erfolgt ist. Eine Liste der zulässigen Werte für dieses Feld finden Sie hier.

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())

Beispiel

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-Fehler

Fehler vom Typ requestValidation weisen auf Datenprobleme bei der Conversion-Uploadanfrage hin (z.B. wenn die Conversion bereits hochgeladen wurde oder die Klick-ID nicht gefunden wird). Bei diesem Fehlertyp enthält die Nachricht details zwei Elemente:

• Ein Hexadezimalcode, der den Fehlertyp angibt. Sie können den Code in Ihren eigenen Scripts verwenden, um die Fehler zu identifizieren.
• Eine Beschreibung des Validierungsfehlers.

Weitere Informationen finden Sie in der Liste der Codes und Beschreibungen, die in Search Ads 360 bei Conversion-Uploadfehlern zurückgegeben werden können.

Andere Arten von Fehlern

Alle anderen Arten von Fehlern (internalError, transactionFailed oder lateStageRequestError) weisen auf ein internes Problem in Search Ads 360 hin.

Auf einen Fehler reagieren

Wenn die Anfrage fehlschlägt, versuchen Sie, den gesamten Anfrageaufruf später noch einmal zu senden. In Search Ads 360 werden requestValidation-Fehler für alle bereits hochgeladenen Conversions gemeldet. Die verbleibenden Conversions werden jedoch hochgeladen.

Wenn nach dem erneuten Einreichen weiterhin Fehler angezeigt werden, finden Sie im Abschnitt Fehlerbehebung Informationen dazu, wie Sie vorgehen können.