Ausrichtung

Die Verwaltung des Ressourcen-Targeting ist eine zentrale Funktion der Display- und Video 360 API Das Targeting kann mehreren Ressourcentypen zugewiesen werden andere Ressourcen und ID-Bereiche. Auf dieser Seite werden Einschränkungen und die Sie bei der Einführung der Display- und Zugewiesenes Video 360 API-Targeting Optionen für Dienste.

Targeting-Übernahme übernehmen

Das Targeting einiger Ressourcen kann von der untergeordneten Ressource übernommen werden Ressourcen. Von einer untergeordneten Ressource übernommene Targeting-Optionen können abgerufen werden, kann auf der untergeordneten Ressourcenebene nicht bearbeitet werden. Dadurch werden Einstellungen für die Markensicherheit andere Targeting-Einstellungen, die für den gesamten Partner oder Werbetreibenden erzwungen werden.

Der Pfad der Vererbung ist im folgenden Diagramm dargestellt:

Diagramm zur Targeting-Vererbung

Wie im Diagramm dargestellt, unterstützen einige Targeting-Ebenen nur Ausrichtungstypen auswählen. Das bedeutet, dass für einige Targeting-Optionen keine höhere Ebenen und übernommen, müssen aber auf einer niedrigeren Ebene festgelegt werden.

Übernahme in YouTube und Partnerressourcen

Die Übernahme von Targeting wird für YouTube und Partnerressourcen in Display- und Video 360 API Von Anzeigengruppen übernommenes Targeting wird nicht abrufbar auf AdGroup-Ebene und YouTube-Ausrichtung übergeordneten Ressourcen zugewiesen sind, werden nicht von untergeordneten Ressourcen übernommen.

Um alle Einstellungen für die funktionale Ausrichtung für eine Anzeigengruppe abzurufen, gehen Sie wie folgt vor: die zugewiesenen Ausrichtungsoptionen für die Anzeigengruppe abrufen, die die übergeordnete Werbebuchung und den übergeordneten Werbetreibenden.

Beim Erstellen der Werbebuchung wird das Targeting festgelegt

Abgesehen von übernommenen Targeting-Optionen können die meisten Targeting-Optionen nur nachdem eine Werbebuchung erstellt wurde. Es gibt jedoch einige Ausrichtungstypen, eine standardmäßige Teilmenge von Werten, die den Werbebuchungen beim Erstellen der Werbebuchung zugewiesen wird. Diese sind die folgenden Targeting-Typen:

Es wird versucht, vorhandene Targeting-Optionen zu erstellen oder nicht vorhandene zu löschen gibt einen Fehler zurück. Sie sollten daher die gesamte Targeting-Suite kennen, der Ihren Werbebuchungen bei der Erstellung zugewiesen wird. Wenn Sie das Ereignis die einer Werbebuchung für verschiedene Targeting-Typen zugewiesen ist, advertisers.lineItems.bulkListAssignedTargetingOptions

Darüber hinaus werden einige Einstellungen standardmäßig festgelegt, wenn keine entsprechende Ausrichtungsoption verfügbar ist. -Typ der Ressource zugewiesen ist. Wenn eine Ressource z. B. kein TARGETING_TYPE_AUTHORIZED_SELLER_STATUS Targeting-Option definiert, bedeutet dies, dass die Option "Autorisierte direkte Verkäufer und Reseller“ Status.

Erwarten Sie keine automatische "Standardausrichtung"

Im Displaynetzwerk und In Video 360 ist das auf Kampagnen- oder Anzeigenauftragsebene festgelegte Targeting nicht sofort an ihre untergeordneten Werbebuchungen übergeben wird. Diese Ausrichtung wird als Standard-Targeting und wird als Targeting-Vorlage die auf die Werbebuchungen angewendet wird, die anschließend auf der Benutzeroberfläche erstellt werden.

Klicken Sie auf der Seite „Display- und Video 360 API wird das Standard-Targeting nicht automatisch auf neue Werbebuchungen erstellt wurden. Beim Erstellen einer einfachen Werbebuchung werden keine Kampagnen kopiert oder das Targeting auf Anzeigenauftragsebene. In diesem Fall muss das gewünschte Targeting werden einzeln über die zugewiesene Targeting-Option auf Werbebuchungen angewendet create oder Bulk-Bearbeitung verwenden.

Spezielle Methoden können eine Ausnahme sein. Beispielsweise können Werbebuchungen, die über Kopie von advertisers.lineItems.generateDefault Einstellungen des übergeordneten Anzeigenauftrags, einschließlich des zugewiesenen Targetings. Werbebuchungen, die durch Duplizierung erstellt wurden, wie die ursprüngliche Werbebuchung.

YouTube und Das Partner-Targeting kann nicht geändert werden

Ausrichtung speziell für YouTube und Partnerkampagnen können nicht aktualisiert werden mit das Display- und Video 360 API

YouTube und Das Partner-Targeting umfasst alle Targeting-Optionen, die direkt YouTube und Partner-Werbebuchungen und Anzeigengruppen sowie beliebiges Targeting der folgenden Targeting-Typen:

  • TARGETING_TYPE_SESSION_POSITION
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Diese Ausrichtung kann mithilfe der Funktion Video 360-UI direkt oder über eine strukturierte Datendatei hochladen.

Ausrichtung auf Zielgruppen mit einer einzigen Option zuweisen

Die Ausrichtungsoptionen werden für die meisten Targeting-Typen einzeln zugewiesen. Zielgruppe Das Gruppen-Targeting folgt nicht dieser modularen Konvention, sondern wird dem in einer einzelnen, konfigurierbaren Zielgruppen-Targeting-Details, in dem die IDs der Zielgruppen, die bei der Anzeigenbereitstellung ein- oder ausgeschlossen werden sollen. Die assignedTargetingOptionId für diese Zielgruppenoption, ist nach der Zuweisung immer "audienceGroup".

Jede Änderung an der Ausrichtung auf Zielgruppen muss Sie löschen zuerst die vorhandene Zielgruppe, der Ausrichtungsoption auswählen und anschließend eine neue Zielgruppe erstellen Targeting-Option mit den gewünschten Änderungen. Dies kann in einer einzigen Anfrage erfolgen. mit advertisers.lineItems.bulkEditAssignedTargetingOptions

Hier sehen Sie ein Beispiel für die Aktualisierung der Ausrichtung auf Zielgruppen, um zusätzliche Google-Zielgruppen ansprechen:

Java

long advertiserId = advertiser-id;
long lineItemId = line-item-id
List<Long> addedGoogleAudienceIds =
    Arrays.asList(google-audience-id-to-add,...);

// Build Google audience targeting settings objects to add to audience
// targeting.
ArrayList<GoogleAudienceTargetingSetting> newGoogleAudienceSettings =
    new ArrayList<GoogleAudienceTargetingSetting>();

// Convert list of Google Audience IDs into list of settings.
for (Long googleAudienceId : addedGoogleAudienceIds) {
  newGoogleAudienceSettings.add(new GoogleAudienceTargetingSetting()
      .setGoogleAudienceId(googleAudienceId));
}

// Create relevant bulk edit request objects.
BulkEditLineItemAssignedTargetingOptionsRequest requestContent =
    new BulkEditLineItemAssignedTargetingOptionsRequest();
AudienceGroupAssignedTargetingOptionDetails updatedAudienceGroupDetails;
ArrayList<DeleteAssignedTargetingOptionsRequest> audienceGroupDeleteRequests =
    new ArrayList<DeleteAssignedTargetingOptionsRequest>();

try {
  // Retrieve existing audience group targeting.
  AssignedTargetingOption existingAudienceGroupTargetingOption =
      service
          .advertisers()
          .lineItems()
          .targetingTypes()
          .assignedTargetingOptions()
          .get(
              advertiserId,
              lineItemId,
              "TARGETING_TYPE_AUDIENCE_GROUP",
              "audienceGroup"
          ).execute();

  // Extract existing audience group targeting details.
  updatedAudienceGroupDetails =
      existingAudienceGroupTargetingOption.getAudienceGroupDetails();

  // Build and add delete request for existing audience group targeting.
  ArrayList<String> deleteAudienceGroupAssignedTargetingIds =
      new ArrayList<String>();
  deleteAudienceGroupAssignedTargetingIds.add("audienceGroup");

  audienceGroupDeleteRequests
      .add(new DeleteAssignedTargetingOptionsRequest()
          .setTargetingType("TARGETING_TYPE_AUDIENCE_GROUP")
          .setAssignedTargetingOptionIds(
              deleteAudienceGroupAssignedTargetingIds
          )
      );
}
catch (GoogleJsonResponseException e) {
  updatedAudienceGroupDetails =
      new AudienceGroupAssignedTargetingOptionDetails();
}

// Set delete requests in edit request.
requestContent.setDeleteRequests(audienceGroupDeleteRequests);

// Construct new group of Google Audiences to include in targeting.
GoogleAudienceGroup updatedIncludedGoogleAudienceGroup =
    updatedAudienceGroupDetails.getIncludedGoogleAudienceGroup();
if (updatedIncludedGoogleAudienceGroup != null) {
  List<GoogleAudienceTargetingSetting> updatedGoogleAudienceSettings =
      updatedIncludedGoogleAudienceGroup.getSettings();
  updatedGoogleAudienceSettings.addAll(newGoogleAudienceSettings);
  updatedIncludedGoogleAudienceGroup
      .setSettings(updatedGoogleAudienceSettings);
} else {
  updatedIncludedGoogleAudienceGroup = new GoogleAudienceGroup();
  updatedIncludedGoogleAudienceGroup.setSettings(newGoogleAudienceSettings);
}

// Add new Google Audience group to audience group targeting details.
updatedAudienceGroupDetails
    .setIncludedGoogleAudienceGroup(updatedIncludedGoogleAudienceGroup);

// Create new targeting option to assign.
AssignedTargetingOption newAudienceGroupTargeting =
    new AssignedTargetingOption();
newAudienceGroupTargeting
    .setAudienceGroupDetails(updatedAudienceGroupDetails);

// Build audience group targeting create request and add to list of create
// requests.
ArrayList<AssignedTargetingOption> createAudienceGroupAssignedTargetingOptions =
    new ArrayList<AssignedTargetingOption>();
createAudienceGroupAssignedTargetingOptions.add(newAudienceGroupTargeting);
ArrayList<CreateAssignedTargetingOptionsRequest> targetingCreateRequests =
    new ArrayList<CreateAssignedTargetingOptionsRequest>();
targetingCreateRequests.add(new CreateAssignedTargetingOptionsRequest()
    .setTargetingType("TARGETING_TYPE_AUDIENCE_GROUP")
    .setAssignedTargetingOptions(
        createAudienceGroupAssignedTargetingOptions
    )
);

// Set create requests in edit request.
requestContent.setCreateRequests(targetingCreateRequests);

// Configure and execute the bulk list request.
BulkEditLineItemAssignedTargetingOptionsResponse response =
    service.advertisers().lineItems()
        .bulkEditLineItemAssignedTargetingOptions(
            advertiserId,
            lineItemId,
            requestContent).execute();

Python

advertiser_id = advertiser-id
line_item_id = line-item-id
added_google_audiences = [google-audience-id-to-add,...]

# Build Google audience targeting settings objects to create.
new_google_audience_targeting_settings = []
for google_audience_id in added_google_audiences:
 new_google_audience_targeting_settings.append(
     {'googleAudienceId': google_audience_id}
 )

# Retrieve any existing line item audience targeting.
retrieved_audience_targeting = service.advertisers().lineItems(
).targetingTypes().assignedTargetingOptions().get(
   advertiserId=advertiser_id,
   lineItemId=line_item_id,
   targetingType="TARGETING_TYPE_AUDIENCE_GROUP",
   assignedTargetingOptionId="audienceGroup"
).execute()

updated_audience_group_details = {}

# Copy over any existing audience targeting.
if 'audienceGroupDetails' in retrieved_audience_targeting:
 updated_audience_group_details = retrieved_audience_targeting[
     'audienceGroupDetails']

# Append the new Google audience IDs to any existing positive Google
# audience targeting.
if 'includedGoogleAudienceGroup' in updated_audience_group_details:
 updated_audience_group_details[
     'includedGoogleAudienceGroup']['settings'].extend(
         new_google_audience_targeting_settings)
else:
 updated_audience_group_details['includedGoogleAudienceGroup'] = {
     'settings': new_google_audience_targeting_settings
 }

# Build bulk edit request.
bulk_edit_request = {
   'deleteRequests': [
       {
         'targetingType': "TARGETING_TYPE_AUDIENCE_GROUP",
         'assignedTargetingOptionIds': [
           "audienceGroup"
         ]
       }
   ],
   'createRequests': [
       {
           'targetingType': "TARGETING_TYPE_AUDIENCE_GROUP",
           'assignedTargetingOptions': [
               {'audienceGroupDetails': updated_audience_group_details}
           ]
       }
   ]
}

# Update the audience targeting
updated_audience_targeting = service.advertisers().lineItems(
).bulkEditLineItemAssignedTargetingOptions(
   advertiserId=advertiser_id,
   lineItemId=line_item_id,
   body=bulk_edit_request
).execute()

PHP

$advertiserId = advertiser-id;
$lineItemId = line-item-id;
$addedGoogleAudienceIds = array(google-audience-id-to-add,...);

// Convert list of Google Audience IDs into list of Google audience
// settings.
$newGoogleAudienceSettings = array();
foreach ($addedGoogleAudienceIds as $googleAudienceId) {
    $newSetting =
        new Google_Service_DisplayVideo_GoogleAudienceTargetingSetting();
    $newSetting->setGoogleAudienceId($googleAudienceId);
    $newGoogleAudienceSettings[] = $newSetting;
}

// Create a bulk edit request.
$requestBody =
    new Google_Service_DisplayVideo_BulkEditLineItemAssignedTargetingOptionsRequest();

$audienceGroupDeleteRequests = array();

try {
    // Retrieve existing audience group targeting.
    $existingAudienceGroupTargetingOption = $this
        ->service
        ->advertisers_lineItems_targetingTypes_assignedTargetingOptions
        ->get(
            $advertiserId,
            $lineItemId,
            'TARGETING_TYPE_AUDIENCE_GROUP',
            'audienceGroup'
        );

    // Extract existing audience group targeting details.
    $updatedAudienceGroupDetails =
        $existingAudienceGroupTargetingOption
            ->getAudienceGroupDetails();

    // Build and add delete request for existing audience group
    // targeting.
    $deleteAudienceGroupAssignedTargetingIds = array();
    $deleteAudienceGroupAssignedTargetingIds[] = "audienceGroup";

    $audienceGroupDeleteRequest =
        new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest();
    $audienceGroupDeleteRequest
        ->setTargetingType('TARGETING_TYPE_AUDIENCE_GROUP');
    $audienceGroupDeleteRequest
        ->setAssignedTargetingOptionIds(
            $deleteAudienceGroupAssignedTargetingIds
        );
    $audienceGroupDeleteRequests[] = $audienceGroupDeleteRequest;
} catch (\Exception $e) {
    $updatedAudienceGroupDetails =
        new Google_Service_DisplayVideo_AudienceGroupAssignedTargetingOptionDetails();
}

// Set delete requests in edit request.
$requestBody->setDeleteRequests($audienceGroupDeleteRequests);

// Construct new group of Google audiences to include in targeting.
$updatedIncludedGoogleAudienceGroup = $updatedAudienceGroupDetails
    ->getIncludedGoogleAudienceGroup();

if (!empty($updatedIncludedGoogleAudienceGroup)) {
    // Get existing settings.
    $updatedGoogleAudienceSettings =
    $updatedIncludedGoogleAudienceGroup->getSettings();

    // Add new Google audiences to existing list.
    $updatedGoogleAudienceSettings = array_merge(
        $updatedGoogleAudienceSettings,
        $newGoogleAudienceSettings
    );

    // Set updated Google audience list.
    $updatedIncludedGoogleAudienceGroup
        ->setSettings($updatedGoogleAudienceSettings);
} else {
    // Create new Google audience group.
    $updatedIncludedGoogleAudienceGroup =
        new Google_Service_DisplayVideo_GoogleAudienceGroup();

    // Set list of new Google audiences for targeting.
    $updatedIncludedGoogleAudienceGroup
        ->setSettings($newGoogleAudienceSettings);
}

// Add new Google Audience group to audience group targeting details.
$updatedAudienceGroupDetails
    ->setIncludedGoogleAudienceGroup(
        $updatedIncludedGoogleAudienceGroup
    );

// Create new targeting option to assign.
$newAudienceGroupTargeting =
    new Google_Service_DisplayVideo_AssignedTargetingOption();
$newAudienceGroupTargeting
    ->setAudienceGroupDetails($updatedAudienceGroupDetails);

// Build audience group targeting create request and add to list of
// create requests.
$createAudienceGroupAssignedTargetingOptions = array();
$createAudienceGroupAssignedTargetingOptions[] =
    $newAudienceGroupTargeting;
$createAudienceGroupTargetingRequest =
    new Google_Service_DisplayVideo_CreateAssignedTargetingOptionsRequest();
$createAudienceGroupTargetingRequest->setTargetingType(
    "TARGETING_TYPE_AUDIENCE_GROUP"
);
$createAudienceGroupTargetingRequest->setAssignedTargetingOptions(
    $createAudienceGroupAssignedTargetingOptions
);
$createRequests[] = $createAudienceGroupTargetingRequest;

// Set create requests in edit request.
$requestBody->setCreateRequests($createRequests);

// Call the API, editing the assigned targeting options for the
// identified line item.
$response = $this
    ->service
    ->advertisers_lineItems
    ->bulkEditLineItemAssignedTargetingOptions(
        $advertiserId,
        $lineItemId,
        $requestBody
    );

Auf die Einstellung der Targeting-Optionen vorbereitet sein

Die Ausrichtungsoptionen sind nicht statisch und eine geringe Anzahl wird möglicherweise in Zukunft nicht mehr unterstützt. Zeit zu ändern. Ausrichtungsoptionen, die eingestellt wurden, wirken sich nicht mehr auf die Anzeige einer Werbebuchung aus der Auslieferung. Nach der Einstellung wird die Zuweisung dieser Optionen zu einer vorhandenen Linie aufgehoben Elemente und Anfragen, mit denen versucht wird, diese Optionen abzurufen oder zuzuweisen, Fehler.

Um diese Fehler zu vermeiden, sollten Sie Ihre gespeicherten IDs der Ausrichtungsoptionen. Um das Kontingent zu schonen, empfehlen wir, häufig verwendete IDs. Das Speichern von IDs bedeutet jedoch, dass Sie dass eine Targeting-Option eingestellt wird. Aus diesem Grund sollten Sie targetingOptions.targetingTypes.get regelmäßig verwenden, um Rufen Sie alle gespeicherten Targeting-Options-IDs ab, um zu bestätigen, dass sie noch unterstützt durch Display- und Video 360

Weitere Informationen finden Sie auf der Seite Angekündigte Einstellungen. und bevorstehende Einstellungen eingestellt werden.

Anfragen zur Aktualisierung derselben Werbebuchung nicht gleichzeitig stellen

Sie versuchen, die Einstellungen oder das zugewiesene Targeting für eine einzelne Werbebuchung zu aktualisieren. bei Verwendung mehrerer gleichzeitiger Anfragen wird ein Fehler zurückgegeben. Relevante Anfragen umfassen:

Wenn Sie mehrere zugewiesene Ausrichtungsoptionen für eine gleichzeitig eine Werbebuchung erstellt haben, advertisers.lineItems.bulkEditAssignedTargetingOptions Wenn Sie die Einstellungen und das Targeting einer Werbebuchung aktualisieren möchten, die patch- oder bulkUpdate-Anfrage und die entsprechenden Targeting-Anfrage, um sicherzustellen, dass die zweite Anfrage erst nach der ersten gibt eine Antwort zurück.