商品トラッキングを更新する方法

前提条件

まだ完了していない場合は、このチュートリアルの前提条件を完了する必要があります。

CSVファイルを使用して商品トラッキングを更新する

CSVファイルを使用して商品トラッキングを更新できます。CSVファイルの形式は次のようにする必要があります。

ASIN	Featured（おすすめ）	Domain（ドメイン）
ASIN		マッチングするドメイン

次のCSVテンプレートを使用して、独自のCSVファイルを作成できます。

ASIN,Featured,Domain,,*** Instructions ***
<ここにASINを入力>,,<ここにドメインを入力>,,Please note that the header row is required to ensure all ASINs are uploaded
,,,,"Enter ASIN list using the following guidelines for ""Featured"" and ""Domain"" columns:"
,,,,"1) Use ""X"" to mark as a featured ASIN, leave it empty otherwise (note: Out of Stock alerts will not be sent for orders with more than 100 featured ASINs)"
,,,,2) Match each ASIN to one of the following Amazon domains in NA:
,,,,amazon.com
,,,,amazon.ca
,,,,Prime Now US
,,,,Prime Now CA
,,,,Prime Video ROW-NA
,,,,Whole Foods Market US

CSVファイルを作成したら、まず/dsp/fileUploads/policy/リソースを使用して、AWS S3ポリシーを作成します。

例：

{
    "url": "https://amazon-dsp-api-368306839028-us-east-1.s3.amazonaws.com/",
    "fields": {
        "key": "product/2021/5/24/b27d75a9-b012-4c25-9122-5714537b7b0f.csv",
        "x-amz-algorithm": "AWS4-HMAC-SHA256",
        "x-amz-credential": "ASIAVLQGMLX2BUFP5NQX/20210524/us-east-1/s3/aws4_request",
        "x-amz-date": "20210524T050135Z",
        "x-amz-security-token": "YOUR-TOKEN-HERE",
        "policy": "YOUR-POLICY-HERE",
        "x-amz-signature": "YOUR-SIGNATURE-HERE"
    }
}

AWS S3ポリシーが正常に作成されたら、CSVをAmazon S3にアップロードします。

例えば、pythonリクエストまたはjavascriptリクエストを使用できます

HTTP POST操作をサポートする任意のプログラミング言語を使用できます。

ファイルがAmazon S3に正常にアップロードされたら、/dsp/orders/{orderId}/conversionTracking/productsリソースのPUT操作を使用し、productFileパラメーターにAmazonS3パスを指定して、商品トラッキングを更新できます。例：

{ 
  "productFile": "product/2021/5/24/b27d75a9-b012-4c25-9122-5714537b7b0f.csv" 
}

商品トラッキングの更新が成功すると、HTTP 204-No contentというレスポンスが返されることに注意してください。

JSONリストを使用して商品トラッキングを更新する

JSONリストを使用して商品トラッキングを更新するには、/dsp/orders/{orderId}/conversionTracking/productsリソースのPUT操作を使用します。以下のパラメーターを取ります。

• productId： ASINとも呼ばれます。商品のASINは、商品詳細ページの商品詳細セクションで確認できます。複数のASINを指定するには、スペース、カンマ、タブ、または改行で区切ってください。
• productAssociation： おすすめのASINとは、この注文に含まれている、クリエイティブで宣伝された特定の商品のことです。おすすめのASINと親ASINに加えて、おすすめ以外のASINやバリエーションを追跡することで、適切なコンバージョン指標を確保し、キャンペーンの開始後に回復できないデータ損失が発生するのを防ぎます。
• domain： Amazonドメインです。

例：

{
    "productList": [
        {
            "productId": "B004VB9OVK",
            "productAssociation": "FEATURED",
            "domain": "AMAZON_US"
        },
        {
            "productId": "B07HJW9HKL",
            "productAssociation": "FEATURED",
            "domain": "AMAZON_US"
        }
    ]
}

商品トラッキングの更新が成功すると、HTTP 204-No contentというレスポンスが返されることに注意してください。