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:
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:
advertisers.lineItems.bulkEditAssignedTargetingOptions
advertisers.lineItems.bulkUpdate
advertisers.lineItems.patch
advertisers.lineItems.targetingTypes.assignedTargetingOptions.create
advertisers.lineItems.targetingTypes.assignedTargetingOptions.delete
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.