배달 라인 관리

Microsoft Store 프로모션 API에서 이러한 메서드를 사용하여 하나 이상의 배달 라인을 만들어 인벤토리를 구매하고 홍보용 광고 캠페인에 대한 광고를 배달합니다. 각 배달 라인에 대해 타기팅을 설정하고, 입찰 가격을 설정할 수 있으며, 예산을 설정하고 사용할 크리에이티브와 연결하여 지출할 금액을 결정할 수 있습니다.

배달 라인과 광고 캠페인, 대상 프로필, 크리에이티브 간의 관계에 대한 자세한 내용은 Microsoft Store 서비스를 사용하여 광고 캠페인 실행을 참조하세요.

참고 이 API를 사용하여 광고 캠페인에 대한 배달 라인을 성공적으로 만들려면 먼저 파트너 센터에서 광고 캠페인 페이지를 사용하여 하나의 유료 광고 캠페인을 만들고 이 페이지에서 하나 이상의 결제 방법을 추가해야 합니다. 이렇게 하면 이 API를 사용하여 광고 캠페인에 대한 청구 가능한 배달 라인을 성공적으로 만들 수 있습니다. API를 사용하여 만든 광고 캠페인에 대한 요금은 파트너 센터의 광고 캠페인 페이지에서 선택한 기본 결제 방법에 자동으로 청구됩니다.

필수 조건

이 메서드를 사용하려면 먼저 다음을 수행해야 합니다.

• 아직 수행하지 않은 경우 Microsoft Store 프로모션 API에 대한 필수 구성 요소를 모두 완료합니다.

  참고 항목

  필수 구성 요소의 일부로 파트너 센터에서 하나 이상의 유료 광고 캠페인을 만들고 파트너 센터에서 광고 캠페인에 대한 하나 이상의 결제 방법을 추가해야 합니다. 이 API를 사용하여 만든 배달 라인에 대한 요금은 파트너 센터의 광고 캠페인 페이지에서 선택한 기본 결제 방법에 자동으로 청구됩니다.

• 이러한 메서드의 요청 헤더에 사용할 Azure AD 액세스 토큰을 가져옵니다. 액세스 토큰을 가져온 후 만료되기까지 60분이 걸립니다. 토큰이 만료된 후 새 토큰을 가져올 수 있습니다.

Request

이러한 메서드에 있는 URI는 다음과 같습니다.

헤더

요청 본문

POST 및 PUT 메서드는 배달 라인 개체의 필수 필드 및 설정하거나 변경하려는 추가 필드가 있는 JSON 요청 본문이 필요합니다.

요청 예제

다음 예제에서는 POST 메서드를 호출하여 배달 라인을 만드는 방법을 보여 줍니다.

POST https://manage.devcenter.microsoft.com/v1.0/my/promotion/line HTTP/1.1
Authorization: Bearer <your access token>

{
    "name": "Contoso App Campaign - Paid Line",
    "configuredStatus": "Active",
    "startDateTime": "2017-01-19T12:09:34Z",
    "endDateTime": "2017-01-31T23:59:59Z",
    "bidAmount": 0.4,
    "dailyBudget": 20,
    "targetProfileId": {
        "id": 310021746
    },
    "creatives": [
        {
            "id": 106851
        }
    ],
    "campaignId": 31043481,
    "minMinutesPerImp ": 1
}

다음 예제에서는 GET 메서드를 호출하여 배달 라인을 검색하는 방법을 보여 줍니다.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/line/31019990  HTTP/1.1
Authorization: Bearer <your access token>

Response

이러한 메서드는 만들거나 업데이트하거나 검색한 배달 라인에 대한 정보가 포함된 배달 라인 개체가 있는 JSON 응답 본문을 반환합니다. 다음 예제에서는 이러한 메서드에 대한 응답 본문을 보여 줍니다.

{
    "Data": {
        "id": 31043476,
        "name": "Contoso App Campaign - Paid Line",
        "configuredStatus": "Active",
        "effectiveStatus": "Active",
        "effectiveStatusReasons": [
            "{\"ValidationStatusReasons\":null}"
        ],
        "startDateTime": "2017-01-19T12:09:34Z",
        "endDateTime": "2017-01-31T23:59:59Z",
        "createdDateTime": "2017-01-17T10:28:34Z",
        "bidType": "CPM",
        "bidAmount": 0.4,
        "dailyBudget": 20,
        "targetProfileId": {
            "id": 310021746
        },
        "creatives": [
            {
                "id": 106126
            }
        ],
        "campaignId": 31043481,
        "minMinutesPerImp ": 1,
        "pacingType ": "SpendEvenly",
        "currencyId ": 732
    }
}

배달 라인 개체

이러한 메서드에 대한 요청 및 응답 본문에는 다음 필드가 포함됩니다. 다음 표에서는 읽기 전용(PUT 메서드에서 변경할 수 없음을 의미) 필드와 POST 또는 PUT 메서드에 대한 요청 본문에 필요한 필드를 보여 줍니다.

관련 항목

• Microsoft Store 서비스를 사용하여 광고 캠페인 실행
• 광고 캠페인 관리
• 광고 캠페인에 대한 대상 프로필 관리
• 광고 캠페인에 대한 크리에이티브 관리
• 광고 캠페인 성과 데이터 가져오기