Neue Conversions hinzufügen

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

Wenn Sie eine conversionTimestamp des heutigen oder Vortags für eine Conversion, Messwerte für Die Conversion ist innerhalb einer Stunde nach dem Upload in der Search Ads 360-Benutzeroberfläche zu sehen. Wenn Sie einen conversionTimestamp angeben, der älter als gestern ist, werden die Messwerte in mehrere Stunden.

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 die Campaign Manager API verwenden, um eines zu erstellen. Sie können die API nicht verwenden, um Folgendes anzugeben: dass eine Floodlight-Aktivität hauptsächlich für Offline-Conversions verwendet wird. wenn Gebotsstrategien Daten aus der Conversion verwenden.

Wir empfehlen, nach der Verwendung der API ein Floodlight-Tag Aktivität, meldet sich ein Search Ads 360-Nutzer in Search Ads 360 an und ändert die um anzugeben, dass die primäre Quelle Conversions sind Offline-Aktivitäten.

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 zu ändern für jede Floodlight-Aktivität, die Sie zum Erstellen von Berichten zu Offline-Conversions verwenden. Die Einstellungen sollten weisen darauf hin, dass die primäre Quelle der Conversions Offline-Aktivitäten sind. Weitere Informationen finden Sie in der Search Ads 360-Hilfe .

2. Laden Sie Conversions hoch, sobald sie verfügbar sind. Wenn Sie bestimmten Besuchen zuordnen, warten Sie danach mindestens 30 Minuten Besuch vor dem Hochladen der Conversion. Search Ads 360 erkennt die Klick-ID des Besuchs möglicherweise nicht, wenn früher als 30 Minuten nach dem Besuch hochgeladen werden. In seltenen Fällen müssen Sie möglicherweise warten Sie bis zu 4 Stunden, bevor Search Ads 360 die clickId erkennen konnte.

   Uploads müssen immer die neuesten Conversions enthalten. Innerhalb eines Uploadanfrage senden, ist es in Ordnung, wenn die Einträge nicht in chronologischer Reihenfolge angeordnet sind. Eine Gebotsstrategie kann jedoch keine älteren Conversions berücksichtigen können, 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 Verfügbarkeitszeitstempel.

   Der Verfügbarkeitszeitstempel sollte einer der folgenden sein:

   • Wenn Sie in den letzten 24 Stunden Conversions erfasst, aber noch nicht hochgeladen haben Dennoch sollte der Zeitstempel die Zeit sein, zu der die zuletzt hochgeladene Conversion So erfahren Search Ads 360, dass Conversions in den letzten 24 Stunden, aber Sie haben die Daten noch nicht bereitgestellt. 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 stattgefunden haben, sollte der Zeitstempel den die aktuelle Uhrzeit und das aktuelle Datum. So weiß Search Ads 360, dass keine Conversions wurden in den letzten 24 Stunden erzielt. Gebotsstrategien und andere automatisierte die letzten 24 Stunden – einen ganzen Tag ohne Conversions – des Leistungsverlaufs.

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, dem Sie die Conversion zuordnen. In den folgenden Abschnitten werden die erforderlichen und optionale Felder für jedes Ereignis oder jeden Artikel, dem 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, Search Ads 360 stuft die Nutzersitzung auf der Website des Werbetreibenden als Besuch ein. Um eine Conversion einem Besuch zuzuordnen, geben Sie Folgendes in Ihrer Conversion.insert() an Anfrage:

Pflichtfelder

• clickId: Die Klick-ID des Besuchs. Hierbei wird zwischen Groß- und Kleinschreibung unterschieden. Im in den Webprotokollen des Werbetreibenden für die Klick-ID oder auflisten Sie die Conversions und verwenden Sie Klick-ID aus einer anderen Conversion. Search Ads 360 ordnet die Conversion das Keyword, die Anzeige und andere Search Ads 360-Objekte, der Besuch generiert wird.
  Warten Sie danach mindestens 30 Minuten. Search Ads 360 generiert eine Klick-ID, um Conversions hochzuladen. Wenn Sie die Meldung „Click ID is not found“ (Klick-ID wurde nicht gefunden) erhalten Fehler, warten Sie 4 Stunden und laden Sie dann Conversions erneut erfassen. Alle Conversions sollten innerhalb von 90 Tagen nach Klick-ID generiert wird. Andernfalls erkennt die Search Ads 360 API den Besuch möglicherweise nicht.
• conversionId: Bei Offline-Conversions geben Werbetreibende diese ID an. Werbetreibende können geben Sie eine beliebige ID an, die für sie aussagekräftig 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 die dsConversionId oder floodlightOrderId abhängig von den Floodlight-Anweisungen des Werbetreibenden in diese Eigenschaft ein.
• conversionTimestamp: Gibt das Datum und die Uhrzeit an, zu denen der Conversion erfolgte. Wenn zum Beispiel der Parameter Die Conversion erfolgt am Freitag, den 5. August 2016 um 11:53:22 Uhr Eastern Daylight Savings Time (GMT -4:00), Geben Sie den Zeitstempel in Epochenmillisekunden an: 1470412402000.
• segmentationType: Gibt den Typ des Conversion-Systems an, das Sie hochladen in die die Conversion führt. Derzeit werden nur Floodlight-Conversions unterstützt. Dieses Feld muss immer FLOODLIGHT angegeben werden.
• segmentationName: Der Name der Floodlight-Aktivität des Werbetreibenden. mit dem die Conversion erfasst wird.

  Enthält Ihr Werbetreibender Aktivitäten mit demselben Namen, z. B. wenn die Aktivitäten zu verschiedenen Floodlight-Gruppen gehören, wird empfohlen, benennen Sie eine der Aktivitäten um.

  Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie die ID in segmentationId angeben, anstatt den Namen in Das Feld segmentationName. In Campaign Manager wird der Floodlight-Aktivität auch eine ID zugewiesen, aber die Campaign Manager-ID unterscheidet sich von der Search Ads 360-ID und kann nicht verwendet werden, um conversions.) Um die Search Ads 360-ID für eine Floodlight-Aktivität zu sehen, laden Sie eine den Bericht zu Conversions (entweder vom Search Ads 360-Benutzeroberfläche oder die Berichterstellung API). Wenn der Floodlight-Aktivität mindestens eine Conversion während der nicht auswählen, wird die Search Ads 360-ID im Bericht angezeigt.

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

  Wenn Sie TRANSACTION angeben, müssen Sie außerdem das folgende Feld angeben:

  • revenueMicros: Der Geldwert der Conversion.

Optionale Felder

• quantityMillis: Die Anzahl der Elemente bei dieser Conversion. Beispiel: Der Parameter 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, fügt Search Ads 360 automatisch ein Wert von 1000.
• currencyCode: Die Währung des Umsatzes einer Transaktion. Standardmäßig beträgt der Umsatz in der Währung des Werbetreibenden verwendet wird. Wenn Sie eine andere Währung angeben, den angegebenen Umsatzbetrag in die Währung des Werbetreibenden umgerechnet. Weitere Informationen
  Verwenden Sie das alphabetische ISO 4217-Zeichen (3-Zeichen) Format, um die Währung anzugeben.
  Gilt nur für Conversions vom Typ TRANSACTION.
• customMetric und customDimension: Lädt zusätzliche Daten zu einem Conversion erfasst werden, etwa das Land, in das ein gekaufter Artikel versendet wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. Weitere Informationen über Daten für benutzerdefinierte Floodlight-Variablen.
• deviceType: Gibt den Gerätetyp an, auf dem die Conversion erfolgt ist. Weitere Informationen finden Sie unter die Liste der akzeptierten Werte für dieses ein.

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 Ihr Hauptanliegen darin besteht, Conversions den Keywords zuzuordnen, die Zuordnung zu Anzeigen betreffen. Sie können die meisten Search Ads 360- IDs und geben nur die Keyword-ID sowie einige andere Felder an:

Pflichtfelder

• criterionId: Dies ist die Keyword-ID. Du erhältst das criterionId, wenn du TrackerId hinzufügst an Ihre Landingpage-URLs anhängen. 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 geben Sie eine beliebige ID an, die für sie aussagekräftig 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 die dsConversionId oder floodlightOrderId abhängig von den Floodlight-Anweisungen des Werbetreibenden in diese Eigenschaft ein.
• conversionTimestamp: Gibt das Datum und die Uhrzeit an, zu denen der Conversion erfolgte. Wenn zum Beispiel der Parameter Die Conversion erfolgt am Freitag, den 5. August 2016 um 11:53:22 Uhr Eastern Daylight Savings Time (GMT -4:00), Geben Sie den Zeitstempel in Epochenmillisekunden an: 1470412402000.
• segmentationType: Gibt den Typ des Conversion-Systems an, das Sie hochladen in die die Conversion führt. Derzeit werden nur Floodlight-Conversions unterstützt. Dieses Feld muss immer FLOODLIGHT angegeben werden.
• segmentationName: Der Name der Floodlight-Aktivität des Werbetreibenden. mit dem die Conversion erfasst wird.

  Enthält Ihr Werbetreibender Aktivitäten mit demselben Namen, z. B. wenn die Aktivitäten zu verschiedenen Floodlight-Gruppen gehören, wird empfohlen, benennen Sie eine der Aktivitäten um.

  Wenn Sie die ID kennen, die Search Ads 360 einer Floodlight-Aktivität zugewiesen hat, können Sie die ID in segmentationId angeben, anstatt den Namen in Das Feld segmentationName. In Campaign Manager wird der Floodlight-Aktivität auch eine ID zugewiesen, aber die Campaign Manager-ID unterscheidet sich von der Search Ads 360-ID und kann nicht verwendet werden, um conversions.) Um die Search Ads 360-ID für eine Floodlight-Aktivität zu sehen, laden Sie eine den Bericht zu Conversions (entweder vom Search Ads 360-Benutzeroberfläche oder die Berichterstellung API). Wenn der Floodlight-Aktivität mindestens eine Conversion während der nicht auswählen, wird die Search Ads 360-ID im Bericht angezeigt.

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

  Wenn Sie TRANSACTION angeben, müssen Sie außerdem das folgende Feld angeben:

  • revenueMicros: Der Geldwert der Conversion.

Optionale Felder

• quantityMillis: Die Anzahl der Elemente bei dieser Conversion. Beispiel: Der Parameter 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, fügt Search Ads 360 automatisch ein Wert von 1000.
• currencyCode: Die Währung des Umsatzes einer Transaktion. Standardmäßig beträgt der Umsatz in der Währung des Werbetreibenden verwendet wird. Wenn Sie eine andere Währung angeben, den angegebenen Umsatzbetrag in die Währung des Werbetreibenden umgerechnet. Weitere Informationen
  Verwenden Sie das alphabetische ISO 4217-Zeichen (3-Zeichen) Format, um die Währung anzugeben.
  Gilt nur für Conversions vom Typ TRANSACTION.
• customMetric und customDimension: Lädt zusätzliche Daten zu einem Conversion erfasst werden, etwa das Land, in das ein gekaufter Artikel versendet wird, Produkt-IDs oder sogar die Dauer eines Telefonanrufs. Weitere Informationen über Daten für benutzerdefinierte Floodlight-Variablen.
• deviceType: Gibt den Gerätetyp an, auf dem die Conversion erfolgt ist. Weitere Informationen finden Sie unter die Liste der akzeptierten Werte für dieses ein.

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

requestValidation-Fehler weisen auf Datenprobleme beim Conversion-Upload hin. (z.B. wenn die Conversion bereits hochgeladen oder die clickId nicht gefunden wurde). In dieser Fehlertyp enthält, enthält die Meldung details zwei Elemente:

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

Weitere Informationen finden Sie in der eine Liste mit Codes und Beschreibungen, die Search Ads 360 für Fehler beim Hochladen von Conversions zurückgeben kann.

Andere Arten von Fehlern

Alle anderen Fehlertypen (internalError, transactionFailed, oder lateStageRequestError), um anzuzeigen, dass ein internes Problem in Search Ads 360

Auf Fehler reagieren

Wenn die Anfrage fehlschlägt, versuchen Sie später, den gesamten Anfrageaufruf noch einmal zu senden. Search Ads 360 melden requestValidation-Fehler für alle Conversions, die bereits hochgeladen wurde, versucht aber, die restlichen Conversions hochzuladen.

Sollten nach dem erneuten Einreichen weiterhin Fehler auftreten, sehen Sie sich Fehlerbehebung .