Neue Conversions hinzufügen

Rufen Sie die Methode Conversion.insert() auf, um eine oder mehrere Conversions hinzuzufügen. Damit die Conversion richtig zugeordnet werden kann, muss in Ihrer Anfrage der Name einer Floodlight-Aktivität angegeben werden, die der Werbetreibende zum Erfassen von Offline-Conversions verwendet. Außerdem muss die ID des Keywords, der Anzeige und möglicherweise der Klick angegeben sein, der zur Conversion geführt hat. Informationen zum Abrufen von Search Ads 360-IDs finden Sie unter Search Ads 360-IDs und Conversions.

Informationen zu den Einschränkungen beim Hochladen von bisherigen Conversions finden Sie in der Search Ads 360-Hilfe.

Wenn in Ihrer Conversion.insert()-Anfrage mehrere Conversions angegeben sind, wird in Search Ads 360 versucht, jede Conversion auf Best-Effort-Basis hochzuladen, anstatt den gesamten Batch als Alles-oder-Nichts-Transaktion hochzuladen. Wenn einige Conversions in einem Batch nicht hochgeladen werden, können andere möglicherweise trotzdem erfolgreich hochgeladen werden. Conversion-Uploads können aufgrund einer ungültigen Anfrage oder vorübergehenden Netzwerk- oder Systemfehlern fehlschlagen. Wir empfehlen daher, die Antwort für jede eingefügte Conversion zu lesen, um sicherzustellen, dass der Upload erfolgreich ist.

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

Wenn Sie für eine Conversion eine conversionTimestamp von heute oder gestern angeben, werden die Messwerte für die Conversion innerhalb einer Stunde nach dem Upload in der Search Ads 360-Benutzeroberfläche angezeigt. Wenn Sie einen conversionTimestamp angeben, der älter als gestern ist, werden Messwerte in einigen Stunden aktualisiert.

Konvertieren Sie alle Zeitstempel für Conversions in eine Epochenzeit (Unixzeit).

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

Wenn der Werbetreibende noch keine Floodlight-Aktivität für das Tracking von Offline-Conversions erstellt hat, können Sie dazu die Campaign Manager API verwenden. Sie können die API nicht verwenden, um anzugeben, dass eine Floodlight-Aktivität primär für Offline-Conversions verwendet wird. Dies ist eine Best Practice, wenn Gebotsstrategien Daten aus der Conversion verwenden.

Nachdem Sie die API zum Erstellen einer Floodlight-Aktivität verwendet haben, meldet sich ein Search Ads 360-Nutzer in Search Ads 360 an und ändert die Einstellung der Aktivität, um anzugeben, dass die primäre Quelle der Conversions Offline-Aktivität ist.

Best Practices zum Hinzufügen von Conversions

Wir empfehlen die folgenden Best Practices zum 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, die Sie zum Erfassen von Offline-Conversions verwenden. Aus den Einstellungen sollte hervorgehen, dass Offlineaktivitäten die primäre Quelle von Conversions 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 30 Minuten, bevor Sie die Conversion hochladen. Search Ads 360 erkennt die Klick-ID des Besuchs möglicherweise nicht, wenn Sie den Upload früher als 30 Minuten nach dem Besuch durchführen. In seltenen Fällen kann es bis zu 4 Stunden dauern, bis Search Ads 360 die clickId erkennt.

    Uploads müssen immer die neuesten Conversions enthalten. Innerhalb einer einzelnen Uploadanfrage ist es in Ordnung, wenn die Einträge in einer nicht chronologischen Reihenfolge sind. Eine Gebotsstrategie kann jedoch möglicherweise keine älteren Conversions berücksichtigen, die Sie später in einer anderen Anfrage hochladen.

  3. Wenn Sie mehr als 24 Stunden warten, bevor Sie Conversions für eine Floodlight-Aktivität hochladen, senden Sie einen Verfügbarkeitszeitstempel.

    Der Verfügbarkeitszeitstempel sollte einer der folgenden sein:

    • Wenn Sie in den letzten 24 Stunden Conversions erfasst, diese aber noch nicht hochgeladen haben, sollte der Zeitstempel der Zeitpunkt der zuletzt hochgeladenen Conversion sein. Dadurch wird Search Ads 360 mitgeteilt, dass in den letzten 24 Stunden möglicherweise Conversions aufgetreten sind, Sie aber die Daten noch nicht bereitgestellt haben. Gebotsstrategien und andere automatisierte Systeme berücksichtigen den Leistungsverlauf nur bis zur letzten Conversion, die Sie hochgeladen haben.
    • Wenn in den letzten 24 Stunden keine Conversions aufgetreten sind, sollte der Zeitstempel die aktuelle Uhrzeit und das aktuelle Datum sein. Dadurch wird Search Ads 360 mitgeteilt, dass in den letzten 24 Stunden keine Conversions aufgetreten sind. Gebotsstrategien und andere automatisierte Systeme nehmen die letzten 24 Stunden – einen ganzen Tag ohne Conversions – als Teil des Leistungsverlaufs auf.

Anfrage zum Einfügen senden

Mit einer Conversion.insert()-Anfrage können Sie folgende Aktionen ausführen:

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

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

Conversion einem bestimmten Besuch zuordnen

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

Pflichtfelder

  • clickId: Die Klick-ID des Besuchs. Hierbei wird zwischen Groß- und Kleinschreibung unterschieden. Suchen Sie in den Webprotokollen des Werbetreibenden nach der Klick-ID oder auflisten Sie die Conversions und verwenden Sie eine Klick-ID aus einer anderen Conversion. Search Ads 360 ordnet die Conversion dem Keyword, der Anzeige und anderen Search Ads 360-Objekten zu, die für den Besuch verantwortlich waren.
    Warten Sie mindestens 30 Minuten, nachdem Search Ads 360 eine Klick-ID generiert hat, bevor Sie Conversions hochladen. Wenn Sie die Fehlermeldung „Klick-ID wurde nicht gefunden“ erhalten, warten Sie 4 Stunden und laden Sie die Conversions dann noch einmal hoch. Alle Conversions sollten innerhalb von 90 Tagen nach Erzeugung der Klick-ID hochgeladen werden. Andernfalls erkennt die Search Ads 360 API den Besuch möglicherweise nicht.
  • conversionId: Bei Offline-Conversions geben Werbetreibende diese ID an. 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 unter allen Conversions des Werbetreibenden eindeutig sein. Bei Online-Conversions kopiert Search Ads 360 das dsConversionId oder floodlightOrderId abhängig von den Floodlight-Anweisungen des Werbetreibenden in diese Property.
  • conversionTimestamp: Gibt Datum und Uhrzeit der Conversion an. Erfolgt die Conversion beispielsweise am Freitag, dem 5. August 2016 um 11:53:22 Uhr Eastern Daylight Savings Time (GMT -4:00), geben Sie den Zeitstempel in Epochen-Millisekunden an: 1470412402000.
  • segmentationType: Gibt den Typ des Conversion-Systems an, in das Sie die Conversion hochladen. Derzeit werden nur Floodlight-Conversions unterstützt. Deshalb muss in diesem Feld immer FLOODLIGHT angegeben werden.
  • segmentationName: Der Name der Floodlight-Aktivität, die der Werbetreibende verwendet, um die Conversion zu erfassen.

    Wenn Ihr Werbetreibender Aktivitäten mit demselben Namen enthält (dies kann passieren, wenn die Aktivitäten zu verschiedenen Floodlight-Gruppen gehören), empfiehlt es sich, eine der Aktivitäten umzubenennen.

    Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie die ID auch in segmentationId angeben, anstatt den Namen im Feld segmentationName anzugeben. Campaign Manager weist der Floodlight-Aktivität auch eine ID zu, die sich jedoch von der Search Ads 360-ID unterscheidet. Sie kann nicht für die Zuordnung 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 während des Berichtszeitraums mindestens eine Conversion zugeordnet wurde, sehen Sie die Search Ads 360-ID im Bericht.

  • type: Der Typ der Conversion, also entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat im Gegensatz zu einer TRANSACTION-Conversion keinen finanziellen Wert. Beispiele sind Anmeldungen für E-Mail-Listen (ACTION) und E-Commerce-Käufe (TRANSACTION).

    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. Zum Beispiel 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 wird. Wenn Sie eine andere Währung angeben, rechnet Search Ads 360 den angegebenen Umsatzbetrag in die Währung des Werbetreibenden um. Weitere Informationen
    Verwenden Sie zur Angabe der Währung das alphabetische Format nach ISO 4217 (3 Zeichen).
    Gilt nur für Conversions vom Typ TRANSACTION.
  • customMetric und customDimension: Lädt zusätzliche Daten zu einer Conversion hoch, z. B. das Land, in das ein gekaufter Artikel geliefert wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. Weitere Informationen zum Hochladen von Daten für benutzerdefinierte Floodlight-Variablen
  • deviceType: Gibt den Gerätetyp an, auf dem die Conversion erfolgt ist. Weitere Informationen finden Sie in der Liste der für dieses Feld akzeptierten Werte.

JavaScript Object Notation

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"
  }]
}

Java

  /**
   * 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());
    }
  }

Python

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 es Ihnen vor allem darum geht, Conversions Keywords zuzuordnen – und nicht zu Anzeigen –, können Sie die meisten Search Ads 360-Kennungen weglassen und nur die Keyword-ID zusammen mit einigen anderen Feldern angeben:

Pflichtfelder

  • criterionId: Dies ist die Keyword-ID. Sie können die criterionId abrufen, indem Sie das TrackerId-Makro in Ihre Landingpage-URLs einfügen. Weitere Informationen zum Abrufen von Keyword-IDs finden Sie unter Search Ads 360-IDs und Conversions.
  • conversionId: Bei Offline-Conversions geben Werbetreibende diese ID an. 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 unter allen Conversions des Werbetreibenden eindeutig sein. Bei Online-Conversions kopiert Search Ads 360 das dsConversionId oder floodlightOrderId abhängig von den Floodlight-Anweisungen des Werbetreibenden in diese Property.
  • conversionTimestamp: Gibt Datum und Uhrzeit der Conversion an. Erfolgt die Conversion beispielsweise am Freitag, dem 5. August 2016 um 11:53:22 Uhr Eastern Daylight Savings Time (GMT -4:00), geben Sie den Zeitstempel in Epochen-Millisekunden an: 1470412402000.
  • segmentationType: Gibt den Typ des Conversion-Systems an, in das Sie die Conversion hochladen. Derzeit werden nur Floodlight-Conversions unterstützt. Deshalb muss in diesem Feld immer FLOODLIGHT angegeben werden.
  • segmentationName: Der Name der Floodlight-Aktivität, die der Werbetreibende verwendet, um die Conversion zu erfassen.

    Wenn Ihr Werbetreibender Aktivitäten mit demselben Namen enthält (dies kann passieren, wenn die Aktivitäten zu verschiedenen Floodlight-Gruppen gehören), empfiehlt es sich, eine der Aktivitäten umzubenennen.

    Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie die ID auch in segmentationId angeben, anstatt den Namen im Feld segmentationName anzugeben. Campaign Manager weist der Floodlight-Aktivität auch eine ID zu, die sich jedoch von der Search Ads 360-ID unterscheidet. Sie kann nicht für die Zuordnung 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 während des Berichtszeitraums mindestens eine Conversion zugeordnet wurde, sehen Sie die Search Ads 360-ID im Bericht.

  • type: Der Typ der Conversion, also entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat im Gegensatz zu einer TRANSACTION-Conversion keinen finanziellen Wert. Beispiele sind Anmeldungen für E-Mail-Listen (ACTION) und E-Commerce-Käufe (TRANSACTION).

    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. Zum Beispiel 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 wird. Wenn Sie eine andere Währung angeben, rechnet Search Ads 360 den angegebenen Umsatzbetrag in die Währung des Werbetreibenden um. Weitere Informationen
    Verwenden Sie zur Angabe der Währung das alphabetische Format nach ISO 4217 (3 Zeichen).
    Gilt nur für Conversions vom Typ TRANSACTION.
  • customMetric und customDimension: Lädt zusätzliche Daten zu einer Conversion hoch, z. B. das Land, in das ein gekaufter Artikel geliefert wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. Weitere Informationen zum Hochladen von Daten für benutzerdefinierte Floodlight-Variablen
  • deviceType: Gibt den Gerätetyp an, auf dem die Conversion erfolgt ist. Weitere Informationen finden Sie in der Liste der für dieses Feld akzeptierten Werte.

JavaScript Object Notation

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"
  }]
}

Java

  /**
   * 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;
  }

Python


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

Daten aus dem Attributionsmodell eines Drittanbieters hochladen

Mit einem Attributionsmodell wird der Wert einer Conversion auf alle Aktivitäten in einem Conversion-Pfad verteilt. Klickt ein Nutzer beispielsweise auf eine Anzeige für die bezahlte Suche, eine Displayanzeige und eine andere Anzeige für die bezahlte Suche, bevor er eine Conversion ausführt, wird bei einem linearen Attributionsmodell jedem Klick 33% der Conversion zugeordnet.

In Search Ads 360 stehen Attributionsmodelle zur Verfügung. Wenn Sie jedoch einen Drittanbieter-Dienst oder eine eigene Funktion zur Verteilung von Werten auf Klicks verwenden, können Sie die Attributionsdaten des Drittanbieters in Search Ads 360 hochladen und die Daten in Berichten und Search Ads 360-Gebotsstrategien verwenden.

Hinweis

Erstellen Sie in Campaign Manager ein benutzerdefiniertes Attributionsmodell und importieren Sie das Modell in Search Ads 360. Sie müssen External Attribution Model als Namen für das Modell verwenden. So erkennen die Search Ads 360-Funktionen, dass ein Attributionsmodell auf die von Ihnen hochgeladenen Conversion-Daten angewendet wurde. Weitere Informationen

Pflichtfelder

Wenn Sie das Attributionsmodell eines Drittanbieters auf eine Conversion anwenden möchten, geben Sie in der Conversion.insert()-Anfrage alle folgenden Parameter an:

  • clickId: Die Klick-ID des Besuchs. Hierbei wird zwischen Groß- und Kleinschreibung unterschieden. Suchen Sie in den Webprotokollen des Werbetreibenden nach der Klick-ID oder auflisten Sie die Conversions und verwenden Sie eine Klick-ID aus einer anderen Conversion. Search Ads 360 ordnet die Conversion dem Keyword, der Anzeige und anderen Search Ads 360-Objekten zu, die für den Besuch verantwortlich waren.
    Warten Sie mindestens 30 Minuten, nachdem Search Ads 360 eine Klick-ID generiert hat, bevor Sie eine Conversion mit der ID hochladen. Andernfalls erkennt die Search Ads 360 API den Besuch möglicherweise nicht.
  • attributionModel: Wählen Sie External Attribution Model aus. Weitere Informationen
  • countMillis: Der Beitrag zur Conversion, der diesem Klick zugeordnet werden soll. Gilt nur, wenn die Anfrage auch das Feld attributionModel enthält.

    Verwechseln Sie dies nicht mit quantityMillis, einem optionalen Feld, das die Anzahl der Artikel in einer Conversion angibt, z. B. die Anzahl der Artikel in einem Einkaufswagenkauf.

  • conversionId: Bei Offline-Conversions geben Werbetreibende diese ID an. 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 unter allen Conversions des Werbetreibenden eindeutig sein. Bei Online-Conversions kopiert Search Ads 360 das dsConversionId oder floodlightOrderId abhängig von den Floodlight-Anweisungen des Werbetreibenden in diese Property.
  • conversionTimestamp: Gibt Datum und Uhrzeit der Conversion an. Erfolgt die Conversion beispielsweise am Freitag, dem 5. August 2016 um 11:53:22 Uhr Eastern Daylight Savings Time (GMT -4:00), geben Sie den Zeitstempel in Epochen-Millisekunden an: 1470412402000.
  • segmentationType: Gibt den Typ des Conversion-Systems an, in das Sie die Conversion hochladen. Derzeit werden nur Floodlight-Conversions unterstützt. Deshalb muss in diesem Feld immer FLOODLIGHT angegeben werden.
  • segmentationName: Der Name der Floodlight-Aktivität, die der Werbetreibende verwendet, um die Conversion zu erfassen.

    Wenn Ihr Werbetreibender Aktivitäten mit demselben Namen enthält (dies kann passieren, wenn die Aktivitäten zu verschiedenen Floodlight-Gruppen gehören), empfiehlt es sich, eine der Aktivitäten umzubenennen.

    Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie die ID auch in segmentationId angeben, anstatt den Namen im Feld segmentationName anzugeben. Campaign Manager weist der Floodlight-Aktivität auch eine ID zu, die sich jedoch von der Search Ads 360-ID unterscheidet. Sie kann nicht für die Zuordnung 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 während des Berichtszeitraums mindestens eine Conversion zugeordnet wurde, sehen Sie die Search Ads 360-ID im Bericht.

  • type: Der Typ der Conversion, also entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat im Gegensatz zu einer TRANSACTION-Conversion keinen finanziellen Wert. Beispiele sind Anmeldungen für E-Mail-Listen (ACTION) und E-Commerce-Käufe (TRANSACTION).

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

    • revenueMicros: Der Geldwert der Conversion.

Wenn Sie den Conversion-Umsatz erfassen, achten Sie darauf, dass der Umsatz mit Ihrem Modell auf die einzelnen Touchpoints in einem Conversion-Pfad verteilt wird.Wenn Ihr Modell beispielsweise einen linearen Ansatz verwendet, bei dem der Umsatz gleichmäßig auf alle Touchpoints verteilt wird, werden in einem Conversion-Pfad mit drei Anzeigenklicks jedem Klick 33% der Conversion zugeordnet. Wenn mit der Conversion ein Umsatz von 100 $erzielt wurde, muss Ihr Modell 33 $Umsatz auf jeden Klick verteilen und revenueMicros sollte nur 33 $Umsatz pro Klick angeben.

Optionale Felder

  • quantityMillis: Die Anzahl der Elemente bei dieser Conversion. Zum Beispiel 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 wird. Wenn Sie eine andere Währung angeben, rechnet Search Ads 360 den angegebenen Umsatzbetrag in die Währung des Werbetreibenden um. Weitere Informationen
    Verwenden Sie zur Angabe der Währung das alphabetische Format nach ISO 4217 (3 Zeichen).
    Gilt nur für Conversions vom Typ TRANSACTION.
  • customMetric und customDimension: Lädt zusätzliche Daten zu einer Conversion hoch, z. B. das Land, in das ein gekaufter Artikel geliefert wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. Weitere Informationen zum Hochladen von Daten für benutzerdefinierte Floodlight-Variablen
  • deviceType: Gibt den Gerätetyp an, auf dem die Conversion erfolgt ist. Weitere Informationen finden Sie in der Liste der für dieses Feld akzeptierten Werte.

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"
  }]
}

Search Ads 360-Antworten verarbeiten

Die Antwort von Search Ads 360 zeigt nur dann einen Erfolg an, wenn alle Conversions in der Anfrage validiert und hochgeladen wurden.

Wenn die Anfrage erfolgreich ist

Wenn die Anfrage erfolgreich ist, enthält die Antwort die vollständige interne Search Ads 360-Darstellung für jede hochgeladene Conversion, z. B. Kampagnen-ID, Anzeigengruppen-ID und Keyword-ID (Kriteriums-ID).

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "0",
   "dsConversionId": "48719131694768384",
   "conversionId": "test_1383157331951",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368"
  },
  ...
 ]
}

Wenn die Anfrage nicht erfolgreich ist

Wenn eine oder mehrere Conversions nicht validiert oder hochgeladen werden können, enthält die Antwort für jeden fehlgeschlagenen Conversion-Upload eine Nachricht. Die Antwort enthält keine Nachrichten zu Conversions, die hochgeladen wurden.

Hier ist eine Beispielantwort auf eine Anfrage, die nicht vollständig erfolgreich ist:

{
 "error": {
    "errors": [
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
       },
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details:  [0x00000101: Click ID ..."
       }
    ]
  }
}

Jede Fehlermeldung enthält zwei wichtige Felder: einen Grund und eine detaillierte Fehlermeldung. Das Feld „Grund“ kann requestValidation, internalError, transactionFailed oder lateStageRequestError enthalten.

requestValidation-Fehler

requestValidation-Fehler weisen auf Datenprobleme in der Conversion-Upload-Anfrage hin, z.B. wenn die Conversion bereits hochgeladen oder die clickId nicht gefunden wurde. Bei diesem Fehlertyp enthält die Meldung details zwei Elemente:

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

Weitere Informationen finden Sie in der Liste der Codes und Beschreibungen, die Search Ads 360 bei Fehlern beim Hochladen von Conversions zurückgeben kann.

Andere Arten von Fehlern

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

Auf Fehler reagieren

Wenn die Anfrage fehlschlägt, versuchen Sie später, den gesamten Anfrageaufruf noch einmal zu senden. Search Ads 360 meldet requestValidation-Fehler für alle Conversions, die bereits hochgeladen wurden, es wird jedoch versucht, die verbleibenden Conversions hochzuladen.

Sollten nach dem erneuten Senden weiterhin Fehler auftreten, finden Sie im Abschnitt Fehlerbehebung Informationen zum weiteren Vorgehen.