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 des Klicks angegeben werden, 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 Verlaufs-Conversions finden Sie in der Search Ads 360-Hilfe.

Wenn in Ihrer Conversion.insert()-Anfrage mehrere Conversions angegeben sind, versucht Search Ads 360, jede Conversion einzeln hochzuladen, anstatt den gesamten Batch als Alles-oder-Nichts-Transaktion hochzuladen. Wenn einige Conversions in einem Batch nicht hochgeladen werden können, werden andere möglicherweise trotzdem hochgeladen. Conversion-Uploads können aufgrund eines ungültigen Requests oder vorübergehender Netzwerk- oder Systemfehler fehlschlagen. Wir empfehlen Ihnen daher, die Antwort für jede eingefügte Conversion zu lesen, um sicherzugehen, dass der Upload erfolgreich war.

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. Wenn Sie ein conversionTimestamp angeben, das älter als gestern ist, werden die Messwerte in einigen Stunden aktualisiert.

Wandeln Sie alle Zeitstempel für Conversions in Epochenzeit (auch als Unix-Zeit bezeichnet) 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 die Campaign Manager-API verwenden, um eine zu erstellen. Sie können mit der API nicht angeben, dass eine Floodlight-Aktivität hauptsächlich für Offline-Conversions verwendet wird. Das ist jedoch empfehlenswert, wenn Gebotsstrategien Daten aus der Conversion verwenden.

Wir empfehlen, dass sich ein Search Ads 360-Nutzer in Search Ads 360 anmeldet und die Einstellung der Aktivität ändert, um anzugeben, dass die primäre Quelle von Conversions Offline-Aktivitäten sind, nachdem Sie die API zum Erstellen einer Floodlight-Aktivität verwendet haben.

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, die Sie zum Erfassen von Offline-Conversions verwenden. Die Einstellungen sollten darauf hinweisen, dass die primäre Quelle für Conversions Offline-Aktivitä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 als 6 Stunden nach dem Besuch durchführen. In seltenen Fällen kann es bis zu 24 Stunden dauern, bis die Klick-ID in Search Ads 360 erkannt wird.

    Sorgen Sie dafür, dass jeder Upload die neuesten Conversions enthält. Bei 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.

Einfügeanfrage senden

Sie können eine Conversion.insert()-Anfrage senden, um eine der folgenden Aktionen auszuführen:

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

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

Conversion einem bestimmten Besuch zuordnen

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

Pflichtfelder

  • clickId: Die Klick-ID des Besuchs, bei der die Groß-/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 zum Hochladen von Conversions generiert hat. Wenn Sie die Fehlermeldung „Klick-ID nicht gefunden“ erhalten, warten Sie 24 Stunden und laden Sie die Conversions dann noch einmal hoch. Alle Conversions sollten 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 bereitgestellt. Werbetreibende können eine beliebige ID angeben, die für sie relevant 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 kopiert Search Ads 360 die dsConversionId oder floodlightOrderId in diese Property, je nach Floodlight-Anweisungen des Werbetreibenden.
  • conversionTimestamp: Gibt das Datum und die Uhrzeit der Conversion an. 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 Epochenmillisekunden an: 1470412402000.
  • segmentationType: Gibt den Typ des Conversion-Systems an, in das Sie die Conversion hochladen. Derzeit werden nur Floodlight-Conversions unterstützt. Daher ist dieses Feld immer erforderlich, um FLOODLIGHT anzugeben.
  • segmentationName: Der Name der Floodlight-Aktivität, die der Werbetreibende zum Melden der Conversion verwendet.

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

    Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie sie alternativ im Feld segmentationId angeben, anstatt den Namen im Feld segmentationName anzugeben. Campaign Manager weist der Floodlight-Aktivität ebenfalls eine ID zu. Diese 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 Conversions-Bericht herunter (entweder über die Search Ads 360-Benutzeroberfläche oder die Reporting API). Wenn der Floodlight-Aktivität im Berichtszeitraum mindestens eine Conversion zugeordnet wurde, sehen Sie die Search Ads 360-ID im Bericht.

  • type: Der Typ der Conversion, entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat keinen Geldwert, eine TRANSACTION-Conversion schon. Beispiele sind Anmeldungen für E-Mail-Listen (ACTION) im Vergleich zu E-Commerce-Käufen (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. Beispiele: Anzahl der Personen, 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, rechnet 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 TRANSACTION-Conversions.
  • customMetric und customDimension: Hier werden zusätzliche Daten zu einer Conversion hochgeladen, z. B. das Land, in das ein gekaufter Artikel versendet wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. 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 für dieses Feld akzeptierten Werte finden Sie hier.

JSON

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

Conversion nur einem Keyword zuordnen

Wenn es Ihnen hauptsächlich darum geht, Conversions Keywords zuzuordnen, und Sie sich nicht um die Zuordnung zu Anzeigen kümmern, können Sie die meisten Search Ads 360-Kennungen weglassen und nur die Kennung des Keywords zusammen mit einigen anderen Feldern angeben:

Pflichtfelder

  • criterionId: Das ist die Keyword-Kennung. Sie können die criterionId abrufen, indem Sie das Makro TrackerId Ihren Landingpage-URLs hinzufügen. Weitere Informationen zum Abrufen von Keyword-IDs finden Sie hier.
  • conversionId: Bei Offline-Conversions wird diese ID von Werbetreibenden bereitgestellt. Werbetreibende können eine beliebige ID angeben, die für sie relevant 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 kopiert Search Ads 360 die dsConversionId oder floodlightOrderId in diese Property, je nach Floodlight-Anweisungen des Werbetreibenden.
  • conversionTimestamp: Gibt das Datum und die Uhrzeit der Conversion an. 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 Epochenmillisekunden an: 1470412402000.
  • segmentationType: Gibt den Typ des Conversion-Systems an, in das Sie die Conversion hochladen. Derzeit werden nur Floodlight-Conversions unterstützt. Daher ist dieses Feld immer erforderlich, um FLOODLIGHT anzugeben.
  • segmentationName: Der Name der Floodlight-Aktivität, die der Werbetreibende zum Melden der Conversion verwendet.

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

    Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie sie alternativ im Feld segmentationId angeben, anstatt den Namen im Feld segmentationName anzugeben. Campaign Manager weist der Floodlight-Aktivität ebenfalls eine ID zu. Diese 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 Conversions-Bericht herunter (entweder über die Search Ads 360-Benutzeroberfläche oder die Reporting API). Wenn der Floodlight-Aktivität im Berichtszeitraum mindestens eine Conversion zugeordnet wurde, sehen Sie die Search Ads 360-ID im Bericht.

  • type: Der Typ der Conversion, entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat keinen Geldwert, eine TRANSACTION-Conversion schon. Beispiele sind Anmeldungen für E-Mail-Listen (ACTION) im Vergleich zu E-Commerce-Käufen (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. Beispiele: Anzahl der Personen, 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, rechnet 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 TRANSACTION-Conversions.
  • customMetric und customDimension: Hier werden zusätzliche Daten zu einer Conversion hochgeladen, z. B. das Land, in das ein gekaufter Artikel versendet wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. 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 für dieses Feld akzeptierten Werte finden Sie hier.

JSON

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 einem Attributionsmodell eines Drittanbieters hochladen

Mit einem Attributionsmodell wird der Wert einer Conversion auf alle Aktivitäten im Conversion-Pfad verteilt. Klickt ein Nutzer beispielsweise auf eine Anzeige für die bezahlte Suche, eine Displayanzeige und eine weitere Anzeige für die bezahlte Suche, bevor eine Conversion erfolgt, werden jedem Klick über ein lineares Attributionsmodell 33% des Conversion-Werts zugewiesen.

Sie haben die Möglichkeit, in Search Ads 360 bereitgestellte Attributionsmodelle, einen Drittanbieter-Dienst oder eine eigene Funktion zu nutzen, um den Conversion-Wert zuzuordnen. Sie können die Attributionsdaten des Drittanbieters in Search Ads 360 hochladen und in Berichten und Search Ads 360-Gebotsstrategien verwenden.

Vorbereitung

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 können Search Ads 360-Funktionen erkennen, dass ein Attributionsmodell auf die von Ihnen hochgeladenen Conversion-Daten angewendet wurde. Weitere Informationen

Pflichtfelder

Wenn Sie ein Drittanbieter-Attributionsmodell auf eine Conversion anwenden möchten, geben Sie in Ihrer Conversion.insert()-Anfrage Folgendes an:

  • clickId: Die Klick-ID des Besuchs, bei der die Groß-/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 30 Minuten, nachdem Search Ads 360 eine Klick-ID generiert hat, bevor Sie eine Conversion mit der ID hochladen. Andernfalls wird der Besuch möglicherweise nicht von der Search Ads 360 API erkannt.
  • attributionModel: Auf Externes Attributionsmodell festgelegt. Weitere Informationen
  • countMillis: Der Betrag des Conversion-Guthabens, das diesem Klick zugewiesen werden soll. Gilt nur, wenn die Anfrage auch das Feld attributionModel enthält.

    Verwechseln Sie das 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 wird diese ID von Werbetreibenden bereitgestellt. Werbetreibende können eine beliebige ID angeben, die für sie relevant 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 kopiert Search Ads 360 die dsConversionId oder floodlightOrderId in diese Property, je nach Floodlight-Anweisungen des Werbetreibenden.
  • conversionTimestamp: Gibt das Datum und die Uhrzeit der Conversion an. 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 Epochenmillisekunden an: 1470412402000.
  • segmentationType: Gibt den Typ des Conversion-Systems an, in das Sie die Conversion hochladen. Derzeit werden nur Floodlight-Conversions unterstützt. Daher ist dieses Feld immer erforderlich, um FLOODLIGHT anzugeben.
  • segmentationName: Der Name der Floodlight-Aktivität, die der Werbetreibende zum Melden der Conversion verwendet.

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

    Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie sie alternativ im Feld segmentationId angeben, anstatt den Namen im Feld segmentationName anzugeben. Campaign Manager weist der Floodlight-Aktivität ebenfalls eine ID zu. Diese 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 Conversions-Bericht herunter (entweder über die Search Ads 360-Benutzeroberfläche oder die Reporting API). Wenn der Floodlight-Aktivität im Berichtszeitraum mindestens eine Conversion zugeordnet wurde, sehen Sie die Search Ads 360-ID im Bericht.

  • type: Der Typ der Conversion, entweder ACTION oder TRANSACTION. Eine ACTION-Conversion hat keinen Geldwert, eine TRANSACTION-Conversion schon. Beispiele sind Anmeldungen für E-Mail-Listen (ACTION) im Vergleich zu E-Commerce-Käufen (TRANSACTION).

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

    • revenueMicros: Der Geldwert der Conversion.

Wenn Sie den Conversion-Umsatz erfassen, sollten Sie darauf achten, dass der Umsatz mit Ihrem Modell auf alle Berührungspunkte im Conversion-Pfad verteilt wird. Wenn Ihr Modell beispielsweise einen linearen Ansatz verwendet, bei dem der Umsatz gleichmäßig auf alle Berührungspunkte verteilt wird, werden in einem Conversion-Pfad mit drei Anzeigenklicks jedem Klick 33% der Conversion zugewiesen. Wenn Sie mit der Conversion einen Umsatz in Höhe von 100 € erzielt haben, sollten Sie überprüfen, ob Ihr Modell jedem Klick 33 € zugewiesen hat. Für jeden Klick dürfen nur 33 € Umsatz in revenueMicros angegeben werden.

Optionale Felder

  • quantityMillis: Die Anzahl der Elemente bei dieser Conversion. Beispiele: Anzahl der Personen, 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, rechnet 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 TRANSACTION-Conversions.
  • customMetric und customDimension: Hier werden zusätzliche Daten zu einer Conversion hochgeladen, z. B. das Land, in das ein gekaufter Artikel versendet wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. 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 für dieses Feld akzeptierten Werte finden Sie hier.

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 gibt nur dann an, dass der Vorgang erfolgreich war, wenn alle Conversions in der Anfrage erfolgreich 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 die Validierung oder der Upload einer oder mehrerer Conversions fehlschlägt, enthält die Antwort Meldungen für jeden fehlgeschlagenen Conversion-Upload. Die Antwort enthält keine Nachrichten zu Conversions, die erfolgreich hochgeladen wurden.

Hier sehen Sie ein Beispiel für eine Antwort auf eine Anfrage, die nicht vollständig erfolgreich war:

{
 "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 „reason“ kann requestValidation, internalError, transactionFailed oder lateStageRequestError enthalten.

requestValidation-Fehler

requestValidation-Fehler weisen auf Datenprobleme beim Hochladen von Conversions hin, z.B. dass die Conversion bereits hochgeladen wurde oder die clickId nicht gefunden wird. Bei dieser Art von Fehler 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 für Fehler beim Conversion-Upload 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 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 Conversions gemeldet, die bereits hochgeladen wurden. Es wird jedoch versucht, die verbleibenden Conversions hochzuladen.

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