디스플레이 및 Video 360 API v2는 2024년 9월 3일에 지원 종료됩니다. 서비스가 중단되지 않도록 그 전에 v3로 마이그레이션하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

타겟팅

리소스 타겟팅 관리는 디스플레이 및 디스플레이 네트워크의 Video 360 API 타겟팅은 여러 리소스 유형에 할당할 수 있으며 다른 리소스와 ID 공간을 사용할 수 있습니다 이 페이지에서는 참고 및 최상의 제한사항을 자세히 설명합니다. 디스플레이 및 캠페인 도입 시 구현해야 할 Video 360 API 할당 타겟팅 옵션 서비스.

타겟팅 상속 활용

일부 리소스에 할당된 타겟팅은 하위 요소에 상속될 수 있습니다. 리소스를 배포합니다 하위 리소스에 의해 상속된 타겟팅 옵션은 가져올 수 있지만 수정할 수 없습니다. 이렇게 하면 브랜드 안전성 설정과 기타 타겟팅이 파트너 또는 광고주 전체에 적용됩니다.

상속 경로는 아래 다이어그램에서 볼 수 있습니다.

타겟팅 상속 다이어그램

다이어그램에 지정된 대로 일부 타겟팅 수준은 타겟팅 유형 즉, 일부 타겟팅 옵션은 이보다 높게 설정할 수 없습니다. 대신 더 낮은 수준에서 설정해야 합니다.

YouTube의 상속 및 파트너 리소스

타겟팅 상속은 YouTube 및 Google의 파트너 리소스: 디스플레이 및 Video 360 API 광고그룹에 상속된 타겟팅은 AdGroup 수준 및 YouTube 타겟팅에서 검색 가능 상위 리소스에 할당된 항목은 하위 리소스에 상속되지 않습니다.

광고 그룹에 대한 모든 기능적 타겟팅 설정을 검색하려면 광고그룹에 할당된 타겟팅 옵션을 가져와야 하는 경우 상위 광고 항목, 상위 광고주입니다.

광고 항목 생성 시 할당되는 타겟팅 파악

상속된 타겟팅 옵션을 제외하고 대부분의 타겟팅은 광고 항목을 생성할 수 있습니다. 하지만 몇 가지 타겟팅 유형에는 광고 항목 생성 시 광고 항목에 할당되는 값의 기본 하위 집합 이러한 타겟팅 유형은 다음과 같습니다.

기존에 할당되어 있는 타겟팅 옵션을 만들거나 삭제하려고 시도함 오류를 반환하므로 전체 타겟팅 제품군에 대해 광고 항목 생성 시 광고 항목에 할당되는 인스턴스입니다. 이전 포드를 검색해야 하는 경우 광고 항목에 할당된 타겟팅을 사용하고 싶다면 advertisers.lineItems.bulkListAssignedTargetingOptions

또한 일부 설정은 타겟팅 옵션이 없는 경우 기본으로 설정됩니다. 유형이 리소스에 할당됩니다 예를 들어 리소스에 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 드림 해당 광고 항목은 '승인된 직접 계정'을 판매자 및 리셀러' 있습니다.

자동 '기본 타겟팅'을 기대하지 않음

디스플레이 및 캠페인 또는 게재 신청서 수준에서 설정된 타겟팅이 즉시 하위 광고 항목에 전달되지 않습니다. 이러한 타겟팅을 '기본 타겟팅' 타겟팅 템플릿으로 사용되므로 나중에 UI에서 생성되는 광고 항목에 적용됩니다.

디스플레이 및 Video 360 API에서 새 타겟팅 옵션이 자동으로 생성할 수 있습니다 기본 광고 항목 생성이 캠페인 위에 복사되지 않음 게재 신청서 수준 타겟팅입니다. 이 경우 원하는 타겟팅은 할당된 타겟팅 옵션을 통해 광고 항목에 별도로 적용됨 create 또는 Bulk edit 메소드 사용

특수 메서드는 예외일 수 있습니다. 예를 들어 advertisers.lineItems.generateDefault 사본 상위 게재 신청서의 설정을 변경할 수 있습니다. 마찬가지로 복제를 통해 생성된 광고 항목에는 타겟팅해야 합니다.

YouTube 및 파트너 타겟팅은 수정할 수 없습니다.

YouTube 및 파트너 캠페인은 다음을 사용하여 업데이트할 수 없습니다. 디스플레이 및 Video 360 API

YouTube 및 파트너 타겟팅은 YouTube 및 파트너 광고 항목 및 광고 그룹뿐만 아니라 다음 타겟팅 유형의 모든 타겟팅:

TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO

이 타겟팅은 Display & Video 360 UI를 직접 또는 구조화된 데이터 파일 업로드에 대해 자세히 알아보세요.

단일 옵션으로 잠재고객 타겟팅 할당

대부분의 타겟팅 유형에 대한 타겟팅 옵션은 개별적으로 할당됩니다. 독자층 그룹 타겟팅은 이 모듈식 규칙을 따르지 않고 대신 하나의 구성 가능한 잠재고객 그룹 타겟팅 세부정보 객체를 광고를 게재할 때 포함하거나 제외할 잠재고객의 ID입니다. 이 이 잠재고객 그룹 옵션의 경우 assignedTargetingOptionId 한 번 할당되면 항상 'audienceGroup'입니다.

즉, 잠재고객 그룹 타겟팅을 변경하려면 먼저 먼저 할당된 기존 잠재고객 그룹을 삭제합니다. 타겟팅 옵션을 추가한 다음 새 잠재고객 그룹을 만듭니다. 타겟팅 옵션을 선택합니다. 이 작업은 단일 요청으로 사용 advertisers.lineItems.bulkEditAssignedTargetingOptions

다음은 긍정적 전환을 위해 잠재고객 타겟팅을 업데이트하는 방법의 예입니다. 추가 Google 잠재고객 타겟팅:

자바

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

타겟팅 옵션 지원 중단에 대비

타겟팅 옵션은 고정되어 있지 않으며 소수의 기능은 향후 지원이 중단될 수 있습니다. 확인할 수 있습니다 타겟팅 옵션이 지원 중단되어도 광고 항목의 광고에 영향을 미치지 않음 있습니다. 지원 중단 후에는 이 옵션이 기존 행에서 할당 해제됩니다. 이러한 옵션을 검색하거나 할당하려는 항목 및 요청은 오류 발생

이러한 오류를 방지하려면 저장된 웹사이트 URL을 정기적으로 확인할 수 있습니다 할당량을 절약하려면 애플리케이션을 캐시하고 자주 사용하는 ID를 참조하세요. 그러나 ID를 저장하면 타겟팅 옵션이 지원 중단되었음을 인지하고 있습니다. 따라서 정기적으로 targetingOptions.targetingTypes.get 사용 저장된 타겟팅 옵션 ID를 모두 검색하여 여전히 Display &Video 360 및 동영상 360

지원 중단 발표 페이지에서 중요한 기능에 관한 자세한 내용을 확인하세요. 이전 및 예정된 지원 중단에 대해 알아보겠습니다

동일한 광고 항목을 업데이트하는 동시 요청을 하지 마세요.

단일 광고 항목에 대해 설정 또는 할당된 타겟팅 업데이트 시도 여러 개의 동시 요청을 사용하면 오류가 반환됩니다. 적용 가능한 요청 포함:

단일 광고그룹에 할당된 여러 타겟팅 옵션을 추가 또는 삭제해야 하는 경우 동시에 여러 개의 광고를 설정하려면 단일 advertisers.lineItems.bulkEditAssignedTargetingOptions 드림 합니다. 광고 항목의 설정과 타겟팅을 업데이트하려면 patch 또는 bulkUpdate 요청 및 첫 번째 광고 요청이 있을 때까지 두 번째 요청이 전송되지 않도록 응답을 반환합니다.