Görüntülü Reklam ve Video 360 API v2, 3 Eylül 2024'te kullanımdan kaldırılacak. Hizmet kesintisi yaşamamak için bu tarihten önce v3'e geçin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Hedefleme

Kaynak hedeflemenin yönetimi, Görüntülü Reklam Ağı ve Video 360 API. Hedefleme, birden fazla kaynak türüne atanabilir ve kimlik alanlarından birini seçin. Bu sayfada dikkat edilmesi gereken ve en iyi uygulamaları benimsemeniz için uygulamanız gereken Video 360 API Atanmış Hedefleme Opsiyon hizmetleri.

Hedefleme devralmayı kullanma

Bazı kaynaklara atanan hedefleme alt kaynakları tarafından devralınabilir kaynaklar. Bir alt kaynak tarafından devralınan hedefleme seçenekleri alınabilir ancak alt kaynak düzeyinde düzenlenemez. Bu, marka güvenliği ayarlarını etkinleştirir ve Bir iş ortağı veya reklamveren genelinde uygulanacak başka hedeflemeler.

Devralmanın yolu aşağıdaki şemada gösterilmiştir:

Hedefleme devralma diyagramı

Şemada belirtildiği gibi, bazı hedefleme düzeyleri yalnızca hedefleme türleridir. Bu, bazı hedefleme seçeneklerinin daha yüksek bir düzeyde ayarlanamayacağı anlamına gelir. devralınır ancak daha düşük bir düzeyde ayarlanması gerekir.

YouTube'da devralma İş ortağı kaynakları

Hedeflemeyi devralma, YouTube ve Şuradaki iş ortağı kaynakları: Görüntülü Reklam ve Video 360 API. Reklam grupları tarafından devralınan hedefleme AdGroup düzeyinde ve YouTube hedefleme düzeyinde alınabilir üst kaynaklara atanan alt kaynaklar tarafından devralınmaz.

Bir reklam grubunun tüm işlevsel hedefleme ayarlarını almak için Reklam Grubu için atanan hedefleme seçeneklerini almalı üst satır öğesi ve üst reklamveren.

Satır öğesi oluşturulurken atanan hedeflemeye dikkat edin

Devralınan hedefleme seçeneklerinin dışında çoğu hedefleme yalnızca atanabilir satır öğesi oluşturulduktan sonra gelir. Ancak, her bir pazardaki kitle için en uygun satır öğesi oluşturulurken satır öğelerine atanan değerlerin varsayılan bir alt kümesi. Bu Hedefleme türleri şunlardır:

Mevcut atanmayan hedefleme seçeneklerini oluşturmaya veya silmeye çalışılıyor bir hata döndürdüğünden, Google Analytics 4'teki tam hedefleme paketinin satır öğelerinize atanan "da" değerini seçin. hedefleme türlerinde bir satır öğesine atanan hedefleme, advertisers.lineItems.bulkListAssignedTargetingOptions.

Buna ek olarak, hedefleme seçeneği olmadığında bazı ayarlar varsayılan olarak belirlenir kaynak türü atanır. Örneğin, bir kaynakta TARGETING_TYPE_AUTHORIZED_SELLER_STATUS "Yetkili Doğrudan Satış" kullanıyor olduğu anlamına gelir. Satıcılar ve Bayiler" durumu.

Otomatik "varsayılan hedefleme" beklemeyin

Görüntülü ve Video 360, kampanya veya kampanya siparişi seviyesinde ayarlanan hedefleme: hemen alt satır öğelerine iletilmez. Bu hedefleme şöyle bilinir: "varsayılan hedefleme" ve hedefleme şablonu olarak kullanılır. satır öğelerine uygulanır.

Görüntülü Reklam Ağı'nda ve Video 360 API, varsayılan hedefleme yeni satır öğesi oluşturur. Temel satır öğesi oluşturma işlemi hiçbir kampanyanın üzerine kopyalanmıyor veya kampanya siparişi seviyesinde hedefleme yapabilirsiniz. Bu durumda, istenen hedefleme Atanan hedefleme seçeneği aracılığıyla satır öğelerine ayrı ayrı uygulanır oluşturma veya toplu düzenleme yöntemleri kullanabilirsiniz.

Özel yöntemler istisna olabilir. Örneğin, advertisers.lineItems.generateDefault kopya atanan hedefleme dahil olmak üzere üst kampanya siparişindeki ayarları değiştirebilir. Benzer şekilde, kopyalama ile oluşturulan satır öğelerine orijinal satır öğesiyle aynı hedeflemeye sahip olur.

YouTube ve İş ortağı hedeflemesi değiştirilemez

Özellikle YouTube ve İş ortağı kampanyaları şunlar kullanılarak güncellenemez: Ekran ve Video 360 API.

YouTube ve İş ortağı hedeflemesi, doğrudan YouTube ve Partners Satır Öğeleri ve Reklam Grupları'nın yanı sıra Şu hedefleme türlerinin tüm hedeflemeleri:

TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO

Bu hedefleme, Görüntülü Reklam Ağı ve Video 360 kullanıcı arayüzü doğrudan veya yapılandırılmış veri dosyası yükleme.

Tek bir seçenekle kitle hedefleme atama

Çoğu hedefleme türü için hedefleme seçenekleri tek tek atanır. Kitle grup hedefleme bu modüler kurala uymaz, tek ve yapılandırılabilir biçimde kitle grubu hedefleme ayrıntıları nesnesi Reklam yayınlanırken dahil edilecek ve hariç tutulacak kitlelerin kimlikleri. İlgili içeriği oluşturmak için kullanılan Bu kitle grubu seçeneği için assignedTargetingOptionId, her zaman "audienceGroup" olur.

Bu tasarıma göre, kitle grubu hedeflemesinde yapılan tüm değişiklikler önce atanan mevcut kitle grubunu silme hedefleme seçeneğini ve ardından yeni bir kitle grubu oluşturma hedefleme seçeneğine sahip olursunuz. Bu işlem tek bir istekte yapılabilir. kullanarak advertisers.lineItems.bulkEditAssignedTargetingOptions.

Aşağıda, kitle hedeflemeyi olumlu bir şekilde güncellemek için nasıl ek Google kitlelerini hedefleyin:

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
    );

Hedefleme seçeneklerinin kullanımdan kaldırılmasına hazır olun

Hedefleme seçenekleri sabit değildir ve zaman içinde az sayıda hedefleme desteği sonlandırılabilir zaman alabilir. Kullanımdan kaldırılan hedefleme seçenekleri, satır öğesinin reklamını etkilemez yardımcı olur. Desteğin sonlandırılmasının ardından bu seçeneklerin mevcut satırdaki ataması kaldırılacak bu seçenekleri almaya veya atamaya çalışan öğelerin ve istekler hatalar.

Bu hataları önlemek için, düzenli olarak saklanmış olan hedefleme seçeneği kimlikleri. Kotayı korumak için kullanılan kimlikler hakkında daha fazla bilgi edinin. Ancak kimlikleri saklamak, bir hedefleme seçeneğinin kullanımdan kaldırıldığını fark edebilir. Bu nedenle, targetingOptions.targetingTypes.get'i şu amaçlarla düzenli olarak kullanabilirsiniz: hâlâ geçerli olduklarını onaylamak için depolanan tüm hedefleme seçeneği kimliklerini alın Görüntülü Reklam Ağı ve Video 360.

Ayrıntılı bilgi için Duyurulan Kullanımdan Kaldırma İşlemleri sayfamıza göz atın. desteğinin sonlandırılmasıyla ilgilidir.

Aynı satır öğesini güncellerken eşzamanlı istek yapma

Tek bir satır öğesi için ayarları veya atanan hedeflemeyi güncellemeye çalışma aynı anda birden fazla istek kullanılması hata döndürür. Geçerli istekler şunlardır:

Tek bir reklam için atanmış birden çok hedefleme seçeneği eklemeniz veya kaldırmanız gerekiyorsa her satır öğesini aynı anda kullanıyorsanız tek bir advertisers.lineItems.bulkEditAssignedTargetingOptions isteğinde bulunabilirsiniz. Bir satır öğesinin ayarlarını ve hedeflemesini güncellemek istiyorsanız patch veya bulkUpdate isteği ve ilgili ikinci isteğin ilk istek gönderilene kadar gönderilmemesini sağlamak üzere bir yanıt döndürür.