Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Conversions hochladen

In diesem Leitfaden finden Sie eine detaillierte Anleitung zum Hochladen von Offline-Conversions mit dem Campaign Manager 360 API-Dienst Conversions. Bevor Sie fortfahren, sollten Sie sich die Übersicht ansehen, um eine Einführung in Offline-Conversions zu erhalten und sich mit den in diesem Leitfaden beschriebenen Konzepten vertraut zu machen.

Conversion-Ressourcen konfigurieren

Der erste Schritt beim Hochladen von Conversions besteht darin, ein oder mehrere Conversion-Ressourcenobjekte zu erstellen. Jedes dieser Objekte stellt ein einzelnes Conversion-Ereignis dar und enthält einige Pflichtfelder:

Feld	Beschreibung
`floodlightActivityId`	Die Floodlight-Aktivität, mit der diese Conversion verknüpft wird.
`floodlightConfigurationId`	Die von der angegebenen Aktivität verwendete Floodlight-Konfiguration.
`ordinal`	Ein Wert, mit dem gesteuert wird, wie Conversions, die vom selben Gerät oder Nutzer und vom selben Tag stammen, dedupliziert werden. Weitere Informationen finden Sie in den FAQs.
`timestampMicros`	Der Zeitstempel der Conversion in Mikrosekunden seit der Unix-Epoche.

Außerdem muss jedes Objekt eines der folgenden Felder enthalten:

Feld	Beschreibung
`encryptedUserId`	Eine einzelne verschlüsselte Nutzer-ID, die über das %m-Übereinstimmungsmakro oder die Datenübertragung abgerufen wurde.
`encryptedUserIdCandidates[]`	Eine Liste verschlüsselter Nutzer-IDs, die über das Makro „%m“ oder die Datenübertragung abgerufen wurden. Die erste dieser IDs mit einer aufgezeichneten Floodlight-Auslieferung vor dem angegebenen `timestampMicros` wird verwendet. Wenn keine der IDs mit einer vorhandenen Exposition übereinstimmt, wird ein Fehler ausgegeben.
`dclid`	Eine von Campaign Manager 360 oder Display & Video 360 generierte Kennung für Klicks im Displaynetzwerk.
`gclid`	Ein von Google Ads oder Search Ads 360 generierter Google Click Identifier.
`matchId`	Eine eindeutige vom Werbetreibenden erstellte ID, die über ein Floodlight-Tag an Campaign Manager 360 gesendet wird.
`mobileDeviceId`	Eine nicht verschlüsselte mobile ID im IDFA- oder AdID-Format oder eine IFA (Identifier for Advertising) für internetfähige Fernseher von einer unterstützten CTV-Geräteplattform (Roku, Fire TV, Android TV, Apple TV, Xbox, Samsung, Vizio).

Für jede Conversion gibt es zwei Messwerte:

Feld	Beschreibung
`quantity`	Erforderlich. Die Anzahl der mit der Conversion verknüpften Artikel. Der Wert muss mindestens 1 sein, damit die Conversion für bestimmte Messwerte (z. B. „Conversions insgesamt“) berücksichtigt wird.
`value`	Der mit der Conversion verknüpfte Dollarbetrag. Wird entsprechend der Währung des Werbetreibenden interpretiert, der die Floodlight-Konfiguration besitzt.

Optionale Felder sind in der Referenzdokumentation dokumentiert.

Im folgenden Beispiel wird die Erstellung eines einfachen Konvertierungsressourcenobjekts veranschaulicht:

C#

// Generate a timestamp in milliseconds since Unix epoch.
TimeSpan timeSpan = DateTime.UtcNow - new DateTime(1970, 1, 1);
long currentTimeInMilliseconds = (long) timeSpan.TotalMilliseconds;

// Find the Floodlight configuration ID based on the provided activity ID.
FloodlightActivity floodlightActivity =
    service.FloodlightActivities.Get(profileId, floodlightActivityId).Execute();
long floodlightConfigurationId = (long) floodlightActivity.FloodlightConfigurationId;

// Create the conversion.
Conversion conversion = new Conversion();
conversion.EncryptedUserId = conversionUserId;
conversion.FloodlightActivityId = floodlightActivityId;
conversion.FloodlightConfigurationId = floodlightConfigurationId;
conversion.Ordinal = currentTimeInMilliseconds.ToString();
conversion.TimestampMicros = currentTimeInMilliseconds * 1000;

Java

long currentTimeInMilliseconds = System.currentTimeMillis();

// Find Floodlight configuration ID based on the provided activity ID.
FloodlightActivity floodlightActivity = reporting.floodlightActivities()
    .get(profileId, floodlightActivityId).execute();
long floodlightConfigurationId = floodlightActivity.getFloodlightConfigurationId();

Conversion conversion = new Conversion();
conversion.setEncryptedUserId(encryptedUserId);
conversion.setFloodlightActivityId(floodlightActivityId);
conversion.setFloodlightConfigurationId(floodlightConfigurationId);
conversion.setOrdinal(String.valueOf(currentTimeInMilliseconds));
conversion.setTimestampMicros(currentTimeInMilliseconds * 1000);

PHP

$currentTimeInMicros = time() * 1000 * 1000;

// Find Floodlight configuration ID based on provided activity ID.
$activity = $this->service->floodlightActivities->get(
    $values['user_profile_id'],
    $values['floodlight_activity_id']
);
$floodlightConfigId = $activity->getFloodlightConfigurationId();

$conversion = new Google_Service_Dfareporting_Conversion();
$conversion->setEncryptedUserId($values['encrypted_user_id']);
$conversion->setFloodlightActivityId($values['floodlight_activity_id']);
$conversion->setFloodlightConfigurationId($floodlightConfigId);
$conversion->setOrdinal($currentTimeInMicros);
$conversion->setTimestampMicros($currentTimeInMicros);

Python

# Look up the Floodlight configuration ID based on activity ID.
floodlight_activity = (
    service.floodlightActivities()
    .get(profileId=str(profile_id), id=str(floodlight_activity_id))
    .execute()
)
floodlight_config_id = floodlight_activity['floodlightConfigurationId']

current_time_in_micros = int(time.time() * 1000000)

# Construct the conversion.
conversion = {
    'encryptedUserId': encrypted_user_id,
    'floodlightActivityId': floodlight_activity_id,
    'floodlightConfigurationId': floodlight_config_id,
    'ordinal': current_time_in_micros,
    'timestampMicros': current_time_in_micros
}

Ruby

# Look up the Floodlight configuration ID based on activity ID.
floodlight_activity = service.get_floodlight_activity(profile_id,
  floodlight_activity_id)
floodlight_config_id = floodlight_activity.floodlight_configuration_id

current_time_in_micros = DateTime.now.strftime('%Q').to_i * 1000

# Construct the conversion.
conversion = DfareportingUtils::API_NAMESPACE::Conversion.new(
  encrypted_user_id: encrypted_user_id,
  floodlight_activity_id: floodlight_activity_id,
  floodlight_configuration_id: floodlight_config_id,
  ordinal: current_time_in_micros,
  timestamp_micros: current_time_in_micros
)

Verschlüsselungsinformationen angeben

Wenn Sie Offline-Conversions verschlüsselten Nutzer-IDs zuordnen möchten, wie im vorherigen Beispiel, müssen Sie im Rahmen Ihrer Einfügeanfrage einige Details zur Verschlüsselung angeben. Insbesondere müssen Sie Folgendes wissen:

Die Verschlüsselungsquelle, die beschreibt, woher ein Batch verschlüsselter IDs stammt. Zulässige Werte sind AD_SERVING für IDs, die aus dem %m-Übereinstimmungsmakro stammen, oder DATA_TRANSFER für IDs, die aus Datenübertragungsdateien stammen.
Die Verschlüsselungsentität, ein eindeutiger Satz von Werten, die zum Verschlüsseln von Nutzer-IDs verwendet werden. Diese Werte beziehen sich normalerweise auf ein Campaign Manager 360-Konto, wenn die Quelle die Datenübertragung ist, oder auf einen Campaign Manager 360-Werbetreibenden, wenn die Quelle das Makro „%m“ ist. Das ist jedoch nicht immer der Fall. Wenn Sie sich nicht sicher sind, wenden Sie sich an Ihren Campaign Manager 360-Kundenbetreuer oder den Campaign Manager 360-Support.

Falls erforderlich, ist das Erstellen eines EncryptionInfo-Objekts, das diese Werte angibt, der zweite Schritt beim Hochladen von Conversions:

C#

// Create the encryption info.
EncryptionInfo encryptionInfo = new EncryptionInfo();
encryptionInfo.EncryptionEntityId = encryptionEntityId;
encryptionInfo.EncryptionEntityType = encryptionEntityType;
encryptionInfo.EncryptionSource = encryptionSource;

Java

// Create the encryption info.
EncryptionInfo encryptionInfo = new EncryptionInfo();
encryptionInfo.setEncryptionEntityId(encryptionEntityId);
encryptionInfo.setEncryptionEntityType(encryptionEntityType);
encryptionInfo.setEncryptionSource(encryptionSource);

PHP

$encryptionInfo = new Google_Service_Dfareporting_EncryptionInfo();
$encryptionInfo->setEncryptionEntityId($values['encryption_entity_id']);
$encryptionInfo->setEncryptionEntityType($values['encryption_entity_type']);
$encryptionInfo->setEncryptionSource($values['encryption_source']);

Python

# Construct the encryption info.
encryption_info = {
    'encryptionEntityId': encryption_entity_id,
    'encryptionEntityType': encryption_entity_type,
    'encryptionSource': encryption_source
}

Ruby

# Construct the encryption info.
encryption_info = DfareportingUtils::API_NAMESPACE::EncryptionInfo.new(
  encryption_entity_id: encryption[:entity_id],
  encryption_entity_type: encryption[:entity_type],
  encryption_source: encryption[:source]
)

Beachten Sie, dass jede Einfügeanfrage nur ein EncryptionInfo-Objekt enthalten darf. Das bedeutet, dass alle in einer bestimmten Anfrage enthaltenen Conversions aus derselben Quelle stammen und dieselbe Verschlüsselungsentität verwenden müssen.

Einfügeanfrage generieren

Im letzten Schritt dieses Prozesses laden Sie Ihre Conversions mit einem Aufruf von batchinsert hoch. Diese Methode akzeptiert ein ConversionsBatchInsertRequest-Objekt, das die hochzuladenden Conversions mit den zugehörigen Verschlüsselungsinformationen (falls erforderlich) kombiniert:

C#

// Insert the conversion.
ConversionsBatchInsertRequest request = new ConversionsBatchInsertRequest();
request.Conversions = new List<Conversion>() { conversion };
request.EncryptionInfo = encryptionInfo;

ConversionsBatchInsertResponse response =
    service.Conversions.Batchinsert(request, profileId).Execute();

Java

ConversionsBatchInsertRequest request = new ConversionsBatchInsertRequest();
request.setConversions(ImmutableList.of(conversion));
request.setEncryptionInfo(encryptionInfo);

ConversionsBatchInsertResponse response = reporting.conversions()
    .batchinsert(profileId, request).execute();

PHP

$batch = new Google_Service_Dfareporting_ConversionsBatchInsertRequest();
$batch->setConversions([$conversion]);
$batch->setEncryptionInfo($encryptionInfo);

$result = $this->service->conversions->batchinsert(
    $values['user_profile_id'],
    $batch
);

Python

# Insert the conversion.
request_body = {
    'conversions': [conversion],
    'encryptionInfo': encryption_info
}
request = service.conversions().batchinsert(
    profileId=str(profile_id), body=request_body
)
response = request.execute()

Ruby

# Construct the batch insert request.
batch_insert_request =
  DfareportingUtils::API_NAMESPACE::ConversionsBatchInsertRequest.new(
    conversions: [conversion],
    encryption_info: encryption_info
  )

# Insert the conversion.
result = service.batchinsert_conversion(profile_id, batch_insert_request)

Beachten Sie, dass Campaign Manager 360 versucht, jede Conversion in Ihrer Anfrage nach dem Best-Effort-Prinzip einzufügen, anstatt den gesamten Batch als Alles-oder-Nichts-Transaktion einzufügen. Wenn einige Conversions in einem Batch nicht eingefügt werden können, werden andere möglicherweise trotzdem erfolgreich eingefügt. Daher sollten Sie die zurückgegebene ConversionsBatchInsertResponse prüfen, um den Status der einzelnen Conversions zu ermitteln:

C#

// Handle the batchinsert response.
if (!response.HasFailures.Value) {
  Console.WriteLine("Successfully inserted conversion for encrypted user ID {0}.",
      conversionUserId);
} else {
  Console.WriteLine("Error(s) inserting conversion for encrypted user ID {0}:",
      conversionUserId);

  ConversionStatus status = response.Status[0];
  foreach(ConversionError error in status.Errors) {
    Console.WriteLine("\t[{0}]: {1}", error.Code, error.Message);
  }
}

Java

if (!response.getHasFailures()) {
  System.out.printf("Successfully inserted conversion for encrypted user ID %s.%n",
      encryptedUserId);
} else {
  System.out.printf("Error(s) inserting conversion for encrypted user ID %s:%n",
      encryptedUserId);

  // Retrieve the conversion status and report any errors found. If multiple conversions
  // were included in the original request, the response would contain a status for each.
  ConversionStatus status = response.getStatus().get(0);
  for (ConversionError error : status.getErrors()) {
    System.out.printf("\t[%s]: %s.%n", error.getCode(), error.getMessage());
  }
}

PHP

if (!$result->getHasFailures()) {
    printf(
        'Successfully inserted conversion for encrypted user ID %s.',
        $values['encrypted_user_id']
    );
} else {
    printf(
        'Error(s) inserting conversion for encrypted user ID %s:<br><br>',
        $values['encrypted_user_id']
    );

    $status = $result->getStatus()[0];
    foreach ($status->getErrors() as $error) {
        printf('[%s] %s<br>', $error->getCode(), $error->getMessage());
    }
}

Python

if not response['hasFailures']:
  print(
      'Successfully inserted conversion for encrypted user ID %s.'
      % encrypted_user_id
  )
else:
  print(
      'Error(s) inserting conversion for encrypted user ID %s.'
      % encrypted_user_id
  )

  status = response['status'][0]
  for error in status['errors']:
    print('\t[%s]: %s' % (error['code'], error['message']))

Ruby

if result.has_failures
  puts format('Error(s) inserting conversion for encrypted user ID %s.',
    encrypted_user_id)

  status = result.status[0]
  status.errors.each do |error|
    puts format("\t[%s]: %s", error.code, error.message)
  end
else
  puts format('Successfully inserted conversion for encrypted user ID %s.',
    encrypted_user_id)
end

Das Feld status der Antwort enthält für jede Konvertierung, die in der ursprünglichen Anfrage enthalten war, ein ConversionStatus-Objekt. Wenn Sie nur an Conversions interessiert sind, die nicht eingefügt werden konnten, können Sie mit dem Feld hasFailures schnell feststellen, ob eine Conversion im angegebenen Batch fehlgeschlagen ist. Informationen zum Umgang mit den einzelnen Fehlercodes und dazu, welche fehlgeschlagenen Konvertierungen wiederholt werden sollten (INTERNAL und NOT_FOUND), finden Sie in den FAQs.

Prüfen, ob Conversions verarbeitet wurden

Hochgeladene Conversions werden in der Regel innerhalb von 24 Stunden verarbeitet und sind dann für Berichte verfügbar. Wenn Sie prüfen möchten, ob die von Ihnen hochgeladenen Conversions verarbeitet wurden, sollten Sie einen Bericht zu Floodlight-Impressionen erstellen. Im Gegensatz zu anderen Attributionsberichten werden hier standardmäßig sowohl zugeordnete (mit einer Anzeige verknüpfte) als auch nicht zugeordnete Conversions zurückgegeben. So können Sie schnell prüfen, ob die von Ihnen gesendeten Conversions in Campaign Manager 360 angekommen sind.

Conversions hochladen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Conversion-Ressourcen konfigurieren

C#

Java

PHP

Python

Ruby

Verschlüsselungsinformationen angeben

C#

Java

PHP

Python

Ruby

Einfügeanfrage generieren

C#

Java

PHP

Python

Ruby

C#

Java

PHP

Python

Ruby

Prüfen, ob Conversions verarbeitet wurden

Conversions hochladen