Conversions erfassen und importieren

Eine Conversion tritt in AdWords auf, wenn ein Nutzer eine festgelegte Aktion ausführt, nachdem er auf eine Anzeige geklickt oder sich eine Anzeige im Displaynetzwerk angesehen hat. Dazu gehören unter anderem der Kauf eines Produkts, die Installation einer mobilen App oder die Anmeldung für eine E-Mail-Liste.

Mit Conversion-Tracking erhalten Sie wichtige Informationen zu den Aktionen, die Nutzer ausführen, nachdem sie sich eine Anzeige angesehen oder darauf geklickt haben. Sie erhalten so einen Überblick über Nutzer, die beispielsweise anrufen, ein Produkt kaufen oder eine mobile App installieren. In AdWords können Sie verschiedene Conversion-Tracker verwenden, je nachdem, welche Arten von Conversions Nutzer durchführen.

In dieser Übersicht werden verschiedene Conversion-Tracker und deren Anwendung beschrieben. Außerdem erfahren Sie, wie Sie die API verwenden, um Offline-Conversions in AdWords zu importieren.

Arten von Conversion-Trackern

Um Conversions zu messen, richten Sie einen ConversionTracker für die Art der Conversion-Aktionen ein, die Sie erfassen möchten. Für das Erfassen eines Onlinekaufs und das Erfassen eines Telefonanrufs benötigen Sie beispielsweise unterschiedliche Conversion-Tracker.

Für die Erfassung der meisten Conversion-Typen sind zusätzliche Maßnahmen erforderlich. Um beispielsweise Conversion-Aktionen auf Ihrer Website zu erfassen, müssen Sie einen AdWordsConversionTracker erstellen und der Conversion-Seite Ihrer Website ein Code-Snippet, auch Tag genannt, hinzufügen.

In den folgenden Abschnitten werden die verschiedenen Arten von Conversion-Trackern beschrieben.

Anruf-Conversions

Um Anrufe über Anruferweiterungen zu erfassen, wird der Tracker AdCallMetricsConversion benötigt. Dafür wird eine Google-Weiterleitungsnummer verwendet und der Conversion-Tracker im FeedItem der Anruferweiterung festgelegt. In der AdWords-Benutzeroberfläche wird diese Art von Conversion Über Anzeigen generierte Anrufe genannt.

Sie können diesen Conversion-Typ erfassen, indem Sie den Conversion-Tracker im FeedItem der Anruferweiterung festlegen und dabei den Platzhaltertyp für CONVERSION TYPE ID verwenden.

Ein Anruf wird als Conversion erfasst, wenn er eine festgelegte Mindestdauer übersteigt. Die Standarddauer beträgt 60 Sekunden.

Conversions auf Websites

Mit AdWordsConversionTracker können Sie verschiedene Arten von Conversions für Websites erfassen, die in der API anhand des Felds trackingCodeType unterschieden werden.

In der folgenden Tabelle sehen Sie die entsprechenden API-Parameter, die für die jeweilige Quelle in der AdWords-Benutzeroberfläche verwendet werden:

trackingCodeType Quelle in der AdWords-Benutzeroberfläche
WEBPAGE Website
WEBPAGE_ONCLICK Klick
CLICK_TO_CALL Klicks auf eine Telefonnummer
--- Analytics

Für die Conversions Website und Klicks auf eine Telefonnummer wird ConversionTrackerService benötigt, mit dem ein Code-Snippet abgerufen und auf Webseiten platziert wird, auf denen eine Conversion-Aktion erfolgen kann, z. B. auf einer Kaufbestätigungsseite oder einer Seite für die Übermittlung der Lead-Informationen.

Der Typ CLICK_TO_CALL unterscheidet sich von AdCallMetricsConversion, da von ihm keine tatsächlichen Anrufe erfasst werden, sondern nur die über Mobilgeräte erfolgten Klicks auf eine Telefonnummer. Diese Möglichkeit ist nützlich, wenn Sie zur Erfassung von Anrufen keine Google-Weiterleitungsnummer verwenden können.

App-Conversions

Mit AppConversion können Sie sowohl App-Installationen als auch In-App-Aktionen für Android und iOS erfassen. In der folgenden Tabelle sind die entsprechenden API-Parameter angegeben, die für die jeweilige Quelle in der AdWords-Benutzeroberfläche verwendet werden:

appPlatform appConversionType Quelle in der AdWords-Benutzeroberfläche
ITUNES FIRST_OPEN App-Installation unter iOS (erstes Öffnen)
ITUNES IN_APP_PURCHASE In-App-Aktionen auf iOS-Geräten
ANDROID_MARKET DOWNLOAD App-Installation unter Android (über Google Play)
ANDROID_MARKET FIRST_OPEN App-Installation unter Android (erstes Öffnen)
ANDROID_MARKET IN_APP_PURCHASE In-App-Aktionen auf Android-Geräten

Wenn Sie FIRST_OPEN als appConversionType festlegen, können Sie eine appPostbackUrl angeben, um eine sofortige Bestätigung zu erhalten, wenn ein Nutzer Ihre App zum ersten Mal öffnet. Lesen Sie den Leitfaden zu Conversion-Tracking für mobile Android-Apps, um weitere Informationen zu erhalten.

Klick-Conversions hochladen

UploadConversion ist der Conversion-Quelle Import > Klick-Conversion in der AdWords-Benutzeroberfläche zugeordnet. Wenn Sie den Conversion-Tracker in der AdWords-Weboberfläche erstellen, wird die automatische Tag-Kennzeichnung für das Konto von selbst aktiviert. Erstellen Sie den Conversion-Tracker aber über die API, geschieht dies nicht. Sie müssen die automatische Tag-Kennzeichnung dann mithilfe von CustomerService aktivieren. Ohne die automatische Tag-Kennzeichnung erhalten Sie den GCLID-Parameter nicht, der erforderlich ist, um die einem Klick zugehörigen Conversions hochzuladen.

Sobald Sie UploadConversion erstellt haben, können Sie OfflineConversionFeedService verwenden, um Klick-Conversions hochzuladen. Weitere Informationen finden Sie im Abschnitt Klick-Conversions importieren.

Anruf-Conversions hochladen

UploadCallConversion ist der Conversion-Quelle Import > Anruf-Conversion in der AdWords-Benutzeroberfläche zugeordnet.

Sobald Sie UploadCallConversion erstellt haben, können Sie OfflineCallConversionFeedService verwenden, um Anruf-Conversions hochzuladen. Weitere Informationen finden Sie im Abschnitt Anruf-Conversions importieren.

Über Websites generierte Anrufe

Eine WebsiteCallMetricsConversion ist der Conversion-Quelle Über eine Website generierte Anrufe in der AdWords-Benutzeroberfläche zugeordnet.

Anders als für AdCallMetricsConversion ist für diesen Conversion-Tracker ein Code-Snippet erforderlich. Dies wird der Website hinzugefügt, um die dynamische Google-Weiterleitungsnummer abzurufen, über die Anrufe für Telefonnummern auf der Website erfasst werden. Außerdem müssen Sie eine Anruferweiterung einrichten und der Kampagne oder den Anzeigengruppen hinzufügen, für die Sie über Websites generierte Anrufe erfassen möchten.

Systemweite Standard-Conversion-Tracker

AdWords bietet einige systemweite Standard-Conversion-Tracker, für die keine Tags erforderlich sind. Diese Conversion-Tracker haben Standardeinstellungen für verschiedene Felder, einschließlich Name, Wert usw.

Wenn Sie die Einstellungen dieser Standard-Conversion-Tracker ändern möchten, erstellen Sie einen ConversionTracker desselben Untertyps und geben Sie die conversionTypeId des systemdefinierten Trackers im Feld originalConversionTypeId des Objekts ConversionTracker an. Dies entspricht der Bearbeitung Ihrer eigenen Kopie des systemweiten Conversion-Trackers. Jede Verwendung des systemweiten Conversion-Trackers in Ihrem Konto wird automatisch durch den Conversion-Tracker ersetzt, den Sie erstellt haben (indem Sie die ID des systemweiten Conversion Trackers als originalConversionTypeId verwenden). Davon sind auch Conversion-Statistiken in Berichten betroffen.

In einem Konto kann nur ein ConversionTracker mit einem systemdefinierten Conversion-Typ erstellt werden. Wenn Sie versuchen, einen zweiten ConversionTracker zu erstellen, indem Sie denselben systemdefinierten Conversion-Tracker im Feld originalConversionTypeId verwenden, schlägt der Vorgang fehl. Mit anderen Worten: Sobald Sie einen systemweiten Conversion-Tracker für Ihr Konto bearbeitet haben, verfügen Sie über die bearbeitete Kopie, nicht über das Original.

Beispielsweise werden alle Anruferweiterungen im Konto, für die der systemweite Conversion-Tracker AdCallMetricsConversion verwendet wurde, dem von Ihnen neu erstellten Tracker zugeordnet. Alle vorherigen Conversion-Statistiken, die den systemweiten Conversion-Typ angegeben haben, geben nun den neuen an.

In der folgenden Tabelle sehen Sie alle systemweiten Standard-Conversion-Tracker und die zugehörigen IDs.

Conversion-Tracker Name Conversion-Typ-ID
AdCallMetricsConversion Über Anzeigen generierte Anrufe 179
AppConversion Android-Downloads 214

Der Standard-Conversion-Tracker AppConversion ist eine Besonderheit, weil Sie hier die App-ID nicht festlegen können. Stattdessen werden alle Conversions von Google Play-Apps erfasst, für die es keine spezifischere AppConversion gibt.

Kontoübergreifendes Conversion-Tracking

Wenn Sie kontoübergreifendes Conversion-Tracking verwenden, gibt ConversionTrackerService folgende Conversion-Typen zurück:

  1. Alle Conversion-Typen, die über das Verwaltungskonto definiert wurden und von dem Konto für kontoübergreifendes Conversion-Tracking verwendet werden.
  2. Alle Conversion-Typen, für die Statistiken erstellt wurden, auch systemdefinierte Typen und Typen, die mit einem Administrator verknüpft sind, auch wenn der Administrator die Verknüpfung später aufhebt.
  3. Alle Typen, die ein Kunde über sein Konto definiert hat, auch Zielvorhaben und Transaktionen, die in verknüpften Analytics-Profilen erstellt wurden. Dazu gehören Typen, die nicht in AdWords importiert wurden, dementsprechend den Status HIDDEN haben und nur über die AdWords-Weboberfläche importiert werden können.

Sie können kontoübergreifende Conversion-Tracker über die API einrichten und abfragen, aber Sie müssen Ihre Konten über das Verwaltungskonto für kontoübergreifendes Conversion-Tracking aktivieren. Weitere Informationen erhalten Sie in diesem Hilfeartikel.

Früher enthielt die Spalte Conversions nur Conversions, die über dasselbe Gerät erfolgt sind. Jetzt können Sie auch geräteübergreifende Conversions in die Spalte Conversions einbeziehen, indem Sie die Property optimizeOnEstimatedConversions der Conversion-Tracking-Einstellungen des Nutzers verwenden. Diese Conversions werden daraufhin in verschiedenen automatischen Gebotsstrategien verwendet, bei denen Optimierungen im Hinblick auf Conversions vorgenommen werden, wie etwa Ziel-CPA (Cost-per-Acquisition), Ziel-ROAS (Return on Advertising Spend) oder auto-optimierter CPC (Cost-per-Click).

In Berichten verfügbare Conversion-Felder

Sie können Conversion-Statistiken für Ihre Konten, Kampagnen oder Anzeigengruppen abrufen, indem Sie die in Berichten verfügbaren Conversion-Felder verwenden.

In den folgenden Tabellen sehen Sie einige häufig verwendete Berichtsfelder, die sich auf Conversions beziehen.

Conversions und davon abgeleitete Felder

Feldname Beschreibung
Conversions Das wichtigste Feld in Berichten zu Conversions, in dem Conversion-Aktionen angezeigt werden, für die Sie bieten können. Nur Conversions aus Conversion-Aktionen (ConversionTracker), für die das Feld excludeFromBidding auf false festgelegt wurde, werden einbezogen.
ConversionRate Conversions, geteilt durch die Gesamtanzahl der Klicks, für die Conversions erfasst werden können. Damit wird angegeben, wie oft eine Interaktion mit einer Anzeige durchschnittlich zu einer Conversion führt, für die das Feld excludeFromBidding auf false festgelegt wurde.
ConversionValue Dies ist der Gesamtwert aller Conversion-Aktionen (ConversionTracker), für die das Feld excludeFromBidding auf false festgelegt wurde.
CostPerConversion Gesamtkosten geteilt durch Conversions
ValuePerConversion ConversionValue geteilt durch Conversions

AllConversions und davon abgeleitete Felder

Feldname Beschreibung
AllConversions Beinhaltet alle Conversions aus AdWords, unabhängig von den für das Feld excludeFromBidding festgelegten Werten. Alle Conversion-Quellen (Website, geräteübergreifend, Anrufe usw.) werden berücksichtigt.
AllConversionRate AllConversions geteilt durch die Gesamtanzahl der Klicks, für die Conversions erfasst werden können. Das bedeutet, wie oft eine Interaktion mit einer Anzeige im Durchschnitt zu einer Conversion führt.
AllConversionValue Der Gesamtwert aller Conversions. Dieser umfasst geräteübergreifende, Website- und Anruf-Conversions sowie Conversion-Aktionen (ConversionTracker) unabhängig von den für das Feld excludeFromBidding festgelegten Werten.
CostPerAllConversion Gesamtkosten geteilt durch AllConversions
ValuePerAllConversion AllConversionValue geteilt durch AllConversions

CrossDeviceConversions

Feldname Beschreibung
CrossDeviceConversions Conversions, die erzielt werden, wenn ein Kunde auf einem Gerät mit einer Anzeige interagiert, die Conversion jedoch auf einem anderen Gerät oder in einem anderen Browser durchführt. Solche Interaktionen können etwa Klicks auf Textanzeigen oder Aufrufe von Videoanzeigen sein. CrossDeviceConversions ist bereits im Feld AllConversions enthalten.

Conversions zugeordnete Spalten mit dem Zusatz "(aktuelles Modell)"

Wenn Sie in AdWords das Feld attributionModelType für eine Conversion-Aktion ändern, werden dadurch die Conversions in den Spalten "Conversions" und "Alle Conversions" lediglich anders gezählt. Wie sich das neu ausgewählte Attributionsmodell auf Ihre bisherigen Conversion-Daten auswirken würde, ist den Spalten mit dem Zusatz "(aktuelles Modell)" zu entnehmen – siehe nachstehende Liste. Beim Vergleich dieser Spalten mit den normalen Spalten für Conversion-Tracking sehen Sie, inwieweit Ihre Daten anders ausgefallen wären, wenn Sie das aktuelle Attributionsmodell verwendet hätten.

Feldname Beschreibung
CostPerCurrentModelAttributedConversion Bisherige CostPerConversion-Daten auf Grundlage des aktuellen Attributionsmodells
CurrentModelAttributedConversionValue Bisherige ConversionValue-Daten auf Grundlage des aktuellen Attributionsmodells
CurrentModelAttributedConversions Bisherige Conversions-Daten auf Grundlage des aktuellen Attributionsmodells
ValuePerCurrentModelAttributedConversion Bisherige ValuePerConversion-Daten auf Grundlage des aktuellen Attributionsmodells

Klick-Conversions importieren

Sie können die AdWords API verwenden, um Offline-Conversions in AdWords hochzuladen. Klicks lassen sich dann den zugehörigen Conversions flexibler zuordnen. So können Sie Anzeigen erfassen, die zu Offlineverkäufen geführt haben, beispielsweise über ein Telefongespräch oder durch einen Vertriebsmitarbeiter.

In diesem Abschnitt erfahren Sie, wie Sie die AdWords API verwenden können, um einen Feed zum Importieren von Offline-Conversions zu erstellen.

Einrichtung

Der erste Schritt besteht darin, Import-Conversion-Typen zu erstellen. Dieser Schritt ist für die "Klassifizierung" jeder einzelnen Conversion erforderlich. Sie können diese Typen über die AdWords-Benutzeroberfläche oder mithilfe von Code erstellen:

UploadConversion uploadConversion = new UploadConversion();
// Set an appropriate category. This field is optional, and will be set to
// DEFAULT if not mentioned.
uploadConversion.setCategory(ConversionTrackerCategory.LEAD);
uploadConversion.setName(conversionName);
uploadConversion.setViewthroughLookbackWindow(30);
uploadConversion.setCtcLookbackWindow(90);

// Optional: Set the default currency code to use for conversions
// that do not specify a conversion currency. This must be an ISO 4217
// 3-character currency code such as "EUR" or "USD".
// If this field is not set on this UploadConversion, AdWords will use
// the account's currency.
uploadConversion.setDefaultRevenueCurrencyCode("EUR");

// Optional: Set the default revenue value to use for conversions
// that do not specify a conversion value. Note that this value
// should NOT be in micros.
uploadConversion.setDefaultRevenueValue(2.50);

ConversionTrackerOperation uploadConversionOperation = new
    ConversionTrackerOperation();
uploadConversionOperation.setOperator(Operator.ADD);
uploadConversionOperation.setOperand(uploadConversion);

ConversionTrackerReturnValue conversionTrackerReturnValue =
    conversionTrackerService.mutate(
        new ConversionTrackerOperation[] {uploadConversionOperation});

In diesem Snippet wird ein UploadConversion-Objekt mithilfe von ConversionTrackerService erstellt. Der angegebene conversionName wird verwendet, um dieses Conversion-Ereignis zu identifizieren. Er muss eindeutig sein.

Nachdem Sie die Import-Conversion-Typen erstellt haben, aktivieren Sie Ihre Website und das Lead-Erfassungssystem, um die GCLID zu erfassen und zu speichern. AdWords versieht jeden Klick auf Ihrer Website, der über eine AdWords-Anzeige zustande kommt, mit einer eindeutigen ID (Google Click ID – GCLID). Darüber hinaus müssen Sie die automatische Tag-Kennzeichnung aktivieren, sodass Ihre Website die GCLID als URL-Parameter empfangen kann. Weitere Informationen zu diesen Schritten finden Sie im Hilfeartikel Offline-Conversion-Tracking.

Offline-Conversions hochladen

Nachdem Sie das UploadConversion-Objekt erstellt haben, müssen Sie diesem Ihre Offline-Conversions zuordnen. Hierfür übergeben Sie die GCLID, Datum und Uhrzeit der Conversion (mit Zeitzonen-ID), den Conversion-Namen und optional den Conversion-Wert sowie die Conversion-Währung an OfflineConversionFeedService:

List<OfflineConversionFeed> conversions = Lists.newArrayList();

// Offline conversion #1
OfflineConversionFeed conversion1 = new OfflineConversionFeed();
conversion1.setConversionName(conversionName1);
conversion1.setConversionTime(conversionTime1); // string format: "yyyyMMdd HHmmss tz"
conversion1.setGoogleClickId(gclId1);

// Optional: Set the conversion value.
conversion1.setConversionValue(conversionValue1);

// Optional: Set the conversion currency to an ISO 4217 3-character currency code
// such as "EUR" or "USD". If this field is not set, then AdWords will assume
// the conversion's value is in the default currency of the tracker.
conversion1.setConversionCurrencyCode(conversionCurrency1);

conversions.add(conversion1);

// Offline conversion #2
OfflineConversionFeed conversion2 = new OfflineConversionFeed();
conversion2.setConversionName(conversionName2);
conversion2.setConversionTime(conversionTime2);
conversion2.setGoogleClickId(gclId2);
conversion2.setConversionValue(conversionValue2);
conversion2.setConversionCurrencyCode(conversionCurrency2);

conversions.add(conversion2);

// Add additional conversions to the conversions list...

List<OfflineConversionFeedOperation> conversionOperations = Lists.newArrayList();
for (OfflineConversionFeed conversion : conversions) {
  OfflineConversionFeedOperation offlineConversionOperation = new OfflineConversionFeedOperation();
  offlineConversionOperation.setOperator(Operator.ADD);
  offlineConversionOperation.setOperand(conversion);

  conversionOperations.add(offlineConversionOperation);
}

OfflineConversionFeedReturnValue offlineConversionReturnValue = offlineConversionFeedService
    .mutate(conversionOperations.toArray(
        new OfflineConversionFeedOperation[conversionOperations.size()]));

Validierungsregeln

Es müssen verschiedene Voraussetzungen erfüllt sein, um einen OfflineConversionFeed hochladen zu können.

Um einen Fehler des Typs OfflineConversionError.INVALID_CONVERSION_TYPE zu vermeiden, muss sich conversionName auf UploadConversion beziehen. Dabei gilt Folgendes:

  • UploadConversion muss den Status ENABLED gehabt haben, als der Klick erfolgte.

  • UploadConversion muss zum Zeitpunkt des Klicks im aktiven Conversion-Konto desjenigen AdWords-Kontos vorhanden gewesen sein, dem der Klick zuzuordnen ist. Wenn zu diesem Zeitpunkt kein kontoübergreifendes Conversion-Tracking in dem betreffenden Konto verwendet wurde, wird dort von AdWords nach dem UploadConversion-Objekt gesucht, das zum Hochladen von Conversions verwendet wurde. Sie finden Ihr aktives Conversion-Tracking-Konto in der AdWords-Benutzeroberfläche unter Tools > Conversions. Dort wird allerdings das aktuelle aktive Conversion-Tracking-Konto angezeigt. Dieses kann sich von dem Conversion-Tracking-Konto unterscheiden, das zum Zeitpunkt des Klicks aktiv war.

Außerdem müssen folgende Bedingungen erfüllt sein:

  • Die conversionTime muss nach dem Zeitpunkt des Klicks liegen, sonst wird der Fehler OfflineConversionError.CONVERSION_PRECEDES_CLICK ausgelöst.

  • Die conversionTime muss vor dem Tracking-Zeitraum für Klick-Conversions liegen, das Sie für das UploadConversion-Objekt angegeben haben. Andernfalls wird der Fehler OfflineConversionError.EXPIRED_CLICK ausgelöst.

  • Der conversionValue muss größer oder gleich null sein.

  • Der conversionTime muss eine Zeitzonen-ID zugeordnet sein. Diese kann sich auf jede gültige Zeitzone beziehen: Sie muss nicht mit der Zeitzone des Kontos übereinstimmen.

Tipps

Beim Erstellen von OfflineConversionFeed ist Folgendes zu berücksichtigen:

  • Uploadvorgänge sind unteilbar. Wenn eine Conversion eine ungültige GCLID hat oder zu lange zurückliegt, wird keine der übrigen zugehörigen Conversions hochgeladen. Nutzen Sie die für teilweise fehlgeschlagene Vorgänge bereitgestellte Funktion, um dies zu vermeiden.

  • Doppelte Uploads einer Conversion (GCLID, Name und Zeit sind identisch) sind zwar zulässig, es wird jedoch nur die erste Instanz erfasst.

  • Eine Conversion wird mit dem Datum des ursprünglichen Klicks und nicht mit dem der Uploadanfrage registriert.

  • Nach dem Erstellen von UploadConversion sollten Sie mit dem Hochladen sechs Stunden warten.

  • Es dauert bis zu drei Stunden, bis importierte Conversion-Statistiken in Ihrem AdWords-Konto angezeigt werden.

Codebeispiele

Im Ordner Remarketing jeder Clientbibliothek gibt es ein Codebeispiel für das Hochladen von Offline-Conversions.

Anruf-Conversions importieren

Sie können die AdWords API verwenden, um Offline-Anruf-Conversions in AdWords hochzuladen. So lassen sich Anrufe den zugehörigen Conversions flexibler zuordnen.

In diesem Abschnitt erfahren Sie, wie Sie die AdWords API verwenden, um einen Feed zum Importieren von Offline-Anruf-Conversions zu erstellen.

Einrichtung

Der erste Schritt besteht darin, einen Conversion-Tracker für Offline-Anruf-Conversions zu erstellen. Sie können diesen über die AdWords-Benutzeroberfläche oder mithilfe von Code erstellen. Mit Code können Sie UploadCallConversion erstellen. Die Vorgehensweise ist ähnlich wie in dem Beispiel unter Einrichtung im Abschnitt Klick-Conversions importieren. Im Beispielcode muss nur UploadConversion durch UploadCallConversion ersetzt werden.

Offline-Anruf-Conversions hochladen

Nachdem Sie das UploadCallConversion-Objekt erstellt haben, müssen Sie diesem Ihre Offline-Anruf-Conversions zuordnen. Hierfür übergeben Sie die Anrufer-ID, Datum und Uhrzeit der Conversion (mit Zeitzonen-ID), den Conversion-Namen sowie optional den Conversion-Wert und die Conversion-Währung an OfflineCallConversionFeedService:

Java

public static void runExample(
    AdWordsServicesInterface adWordsServices,
    AdWordsSession session,
    String callerId,
    String callStartTime,
    String conversionName,
    String conversionTime,
    double conversionValue)
    throws Exception {

  // Get the OfflineCallConversionFeedService.
  OfflineCallConversionFeedServiceInterface offlineCallConversionFeedService =
      adWordsServices.get(session, OfflineCallConversionFeedServiceInterface.class);

  // Associate offline call conversions with the existing named conversion tracker. If this
  // tracker was newly created, it may be a few hours before it can accept conversions.
  OfflineCallConversionFeed feed = new OfflineCallConversionFeed();
  feed.setCallerId(callerId);
  feed.setCallStartTime(callStartTime);
  feed.setConversionName(conversionName);
  feed.setConversionTime(conversionTime);
  feed.setConversionValue(conversionValue);

  OfflineCallConversionFeedOperation offlineCallConversionOperation =
      new OfflineCallConversionFeedOperation();
  offlineCallConversionOperation.setOperator(Operator.ADD);
  offlineCallConversionOperation.setOperand(feed);

  // This example uploads only one call conversion, but you can upload multiple call conversions
  // by passing additional operations.
  OfflineCallConversionFeedReturnValue offlineCallConversionReturnValue =
      offlineCallConversionFeedService.mutate(
          new OfflineCallConversionFeedOperation[] {offlineCallConversionOperation});

  // Display results.
  for (OfflineCallConversionFeed feedResult : offlineCallConversionReturnValue.getValue()) {
    System.out.printf(
        "Uploaded offline conversion value of %.4f for caller ID '%s'.%n",
        feedResult.getConversionValue(), feedResult.getCallerId());
  }
}

C#

public void Run(AdWordsUser user, String conversionName, String callStartTime, String callerId,
    String conversionTime, double conversionValue) {
  // Get the OfflineConversionFeedService.
  OfflineCallConversionFeedService offlineCallConversionFeedService =
      (OfflineCallConversionFeedService) user.GetService(
          AdWordsService.v201702.OfflineCallConversionFeedService);

  // Associate offline call conversions with the existing named conversion tracker. If this
  // tracker was newly created, it may be a few hours before it can accept conversions.
  OfflineCallConversionFeed feed = new OfflineCallConversionFeed();
  feed.callerId = callerId;
  feed.callStartTime = callStartTime;
  feed.conversionName = conversionName;
  feed.conversionTime = conversionTime;
  feed.conversionValue = conversionValue;

  OfflineCallConversionFeedOperation offlineCallConversionOperation =
      new OfflineCallConversionFeedOperation();
  offlineCallConversionOperation.@operator = Operator.ADD;
  offlineCallConversionOperation.operand = feed;

  try {
    // This example uploads only one call conversion, but you can upload
    // multiple call conversions by passing additional operations.
    OfflineCallConversionFeedReturnValue offlineCallConversionReturnValue =
        offlineCallConversionFeedService.mutate(
            new OfflineCallConversionFeedOperation[] { offlineCallConversionOperation });

    // Display results.
    foreach (OfflineCallConversionFeed feedResult in offlineCallConversionReturnValue.value) {
      Console.WriteLine("Uploaded offline call conversion value of {0} for caller ID '{1}'.",
          feedResult.conversionValue, feedResult.callerId);
    }
  } catch (Exception e) {
    throw new System.ApplicationException("Failed to upload offline call conversions.", e);
  }
}

Visual Basic

' Get the OfflineConversionFeedService.
Dim offlineCallConversionFeedService As OfflineCallConversionFeedService = _
    CType(user.GetService(AdWordsService.v201702.OfflineCallConversionFeedService),  _
        OfflineCallConversionFeedService)

' Associate offline call conversions with the existing named conversion tracker. If this
' tracker was newly created, it may be a few hours before it can accept conversions.
Dim feed As New OfflineCallConversionFeed()
feed.callerId = callerId
feed.callStartTime = callStartTime
feed.conversionName = conversionName
feed.conversionTime = conversionTime
feed.conversionValue = conversionValue

Dim offlineCallConversionOperation As New OfflineCallConversionFeedOperation()
offlineCallConversionOperation.operator = [Operator].ADD
offlineCallConversionOperation.operand = feed

Try
  ' This example uploads only one call conversion, but you can upload
  ' multiple call conversions by passing additional operations.
  Dim offlineCallConversionReturnValue As OfflineCallConversionFeedReturnValue = _
      offlineCallConversionFeedService.mutate(
          New OfflineCallConversionFeedOperation() {offlineCallConversionOperation})

  ' Display results.
  For Each feedResult As OfflineCallConversionFeed In offlineCallConversionReturnValue.value
    Console.WriteLine("Uploaded offline call conversion value of {0} for caller ID '{1}'.",
        feedResult.conversionValue, feedResult.callerId)
  Next
Catch e As Exception
  Throw New System.ApplicationException("Failed to upload offline call conversions.", e)
End Try

Python

def main(client, caller_id, call_start_time, conversion_name, conversion_time,
         conversion_value):
  # Initialize appropriate services.
  occ_feed_service = client.GetService(
      'OfflineCallConversionFeedService', version='v201702')

  # Associate offline call conversions with the existing named conversion
  # tracker. If this tracker was newly created, it may be a few hours before it
  # can accept conversions.
  feed = {
      'callerId': caller_id,
      'callStartTime': call_start_time,
      'conversionName': conversion_name,
      'conversionTime': conversion_time,
      'conversionValue': conversion_value,
  }

  occ_operations = [{'operator': 'ADD', 'operand': feed}]

  occ_response = occ_feed_service.mutate(occ_operations)
  values = occ_response['value']

  if values:
    for occ_feed in values:
      print ('Uploaded offline call conversion value of "%s" for caller ID '
             '"%s".\n' % (occ_feed['conversionName'], occ_feed['callerId']))
  else:
    print 'No offline call conversions were added.'

PHP

public static function runExample(
    AdWordsServices $adWordsServices,
    AdWordsSession $session,
    $callerId,
    $callStartTime,
    $conversionName,
    $conversionTime,
    $conversionValue
) {
  $offlineCallConversionService = $adWordsServices->get(
      $session, OfflineCallConversionFeedService::class);

  // Associate offline call conversions with the existing named conversion
  // tracker. If this tracker was newly created, it may be a few hours before
  // it can accept conversions.
  $feed = new OfflineCallConversionFeed();
  $feed->setCallerId($callerId);
  $feed->setCallStartTime($callStartTime);
  $feed->setConversionName($conversionName);
  $feed->setConversionTime($conversionTime);
  $feed->setConversionValue($conversionValue);

  $offlineCallConversionOperations = [];
  $offlineCallConversionOperation = new OfflineCallConversionFeedOperation();
  $offlineCallConversionOperation->setOperator(Operator::ADD);
  $offlineCallConversionOperation->setOperand($feed);
  $offlineCallConversionOperations[] = $offlineCallConversionOperation;

  // This example uploads only one call conversion, but you can upload
  // multiple call conversions by passing additional operations.
  $result =
      $offlineCallConversionService->mutate($offlineCallConversionOperations);

  $feed = $result->getValue()[0];
  printf(
      "Uploaded offline call conversion value of '%s' for caller ID '%s'.\n",
      $feed->getConversionValue(),
      $feed->getCallerId()
  );
}

Perl

sub upload_offline_call_conversions {
  my $client                             = shift;
  my $caller_id                          = shift;
  my $call_start_time                    = shift;
  my $conversion_name                    = shift;
  my $conversion_time                    = shift;
  my $conversion_value                   = shift;
  my @offline_call_conversion_operations = ();

  # Associate offline call conversions with the existing named
  # conversion tracker. If this tracker was newly created, it may be a
  # few hours before it can accept conversions.
  my $feed = Google::Ads::AdWords::v201702::OfflineCallConversionFeed->new({
    callerId        => $caller_id,
    callStartTime   => $call_start_time,
    conversionName  => $conversion_name,
    conversionTime  => $conversion_time,
    conversionValue => $conversion_value
  });

  my $offline_call_conversion_operation =
    Google::Ads::AdWords::v201702::OfflineCallConversionFeedOperation->new({
      operator => "ADD",
      operand  => $feed
    });

  push @offline_call_conversion_operations, $offline_call_conversion_operation;

  # This example uploads only one call conversion, but you can upload multiple
  # call conversions by passing additional operations.
  my $result =
    $client->OfflineCallConversionFeedService()
    ->mutate({operations => \@offline_call_conversion_operations});

  # Display results.
  if ($result->get_value()) {
    foreach my $feed_result (@{$result->get_value()}) {
      printf "Uploaded offline call conversion value of \"%s\" for caller ID " .
        "\"%s\".\n",
        $feed_result->get_conversionValue(),
        $feed_result->get_callerId();
    }
  } else {
    print "No offline call conversions were added.\n";
    return;
  }

  return 1;
}

Ruby

occ_feed_srv =
    adwords.service(:OfflineCallConversionFeedService, API_VERSION)

# Associate offline conversions with the existing named conversion tracker. If
# this tracker was newly created, it may be a few hours before it can accept
# conversions.
feed = {
  :caller_id => caller_id,
  :call_start_time => call_start_time,
  :conversion_name => conversion_name,
  :conversion_time => conversion_time,
  :conversion_value => conversion_value
}

occ_operations = [{
  :operator => 'ADD',
  :operand => feed
}]

occ_response = occ_feed_srv.mutate(occ_operations)

if occ_response[:value]
  occ_response[:value].each do |occ_feed|
    puts 'Uploaded offline call conversion value "%s" for caller ID "%s"' %
        [occ_feed[:conversion_name], occ_feed[:caller_id]]
  end
end

Validierungsregeln

Es müssen verschiedene Voraussetzungen erfüllt sein, um einen OfflineCallConversionFeed hochladen zu können.

Um einen Fehler des Typs OfflineCallConversionError.INVALID_CONVERSION_TYPE zu vermeiden, muss sich der conversionName auf UploadCallConversion beziehen. Dabei gilt Folgendes:

  • UploadCallConversion muss den Status ENABLED gehabt haben, als der Anruf erfolgte.

  • UploadCallConversion muss zum Zeitpunkt des Anrufs im aktiven Conversion-Konto desjenigen AdWords-Kontos vorhanden gewesen sein, dem der Anruf zuzuordnen ist. Wenn zum Zeitpunkt des Anrufs kein kontoübergreifendes Conversion-Tracking in dem betreffenden Konto verwendet wurde, wird dort von AdWords nach dem UploadCallConversion-Objekt gesucht, das zum Hochladen von Conversions verwendet wurde. Sie finden Ihr aktives Conversion-Tracking-Konto in der AdWords-Benutzeroberfläche unter Tools > Conversions. Dort wird allerdings das aktuelle aktive Conversion-Tracking-Konto angezeigt. Dieses kann sich von dem Conversion-Tracking-Konto unterscheiden, das zum Zeitpunkt des Anrufs aktiv war.

Außerdem müssen folgende Bedingungen erfüllt sein:

  • Der conversionValue muss größer oder gleich null sein.

  • Der conversionTime muss eine Zeitzonen-ID zugeordnet sein. Diese kann sich auf jede gültige Zeitzone beziehen: Sie muss nicht mit der Zeitzone des Kontos übereinstimmen.

Tipps

Berücksichtigen Sie Folgendes beim Erstellen von OfflineCallConversionFeed:

  • Nach dem Erstellen der UploadCallConversion sollten Sie mit dem Hochladen sechs Stunden warten.

  • Es dauert bis zu drei Stunden, bis importierte Conversion-Statistiken in Ihrem AdWords-Konto angezeigt werden.

  • Doppelte Uploads einer Conversion (Anrufer-ID, Name und Zeit sind identisch) sind zwar zulässig, es wird jedoch nur die erste Conversion erfasst.

Codebeispiele

Im Ordner Remarketing jeder Clientbibliothek gibt es ein Codebeispiel für das Hochladen von Offline-Anruf-Conversions.

Feedback geben zu...